Microsoft SharePoint Server Query-Aktivität in Jitterbit Studio

Einführung

Eine Microsoft SharePoint Server Query-Aktivität ruft mit ihrer Verbindung ein Objekt aus Microsoft SharePoint Server ab und soll als Quelle verwendet werden, um Daten in einem Vorgang bereitzustellen.

Erstellen einer Microsoft SharePoint Server Query-Aktivität

Eine Instanz einer Microsoft SharePoint Server Query-Aktivität wird aus einer Microsoft SharePoint Server-Verbindung mit ihrem Aktivitätstyp Query erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene Microsoft SharePoint Server Query-Aktivität kann von diesen Orten aus bearbeitet werden:

• Die Design-Canvas (siehe Komponentenaktionsmenü in Design-Canvas).
• Die Registerkarte Komponenten des Projektbereichs (siehe Komponentenaktionsmenü in Projektbereich-Registerkarte „Komponenten").

Konfigurieren einer Microsoft SharePoint Server Query-Aktivität

Führen Sie diese Schritte aus, um eine Microsoft SharePoint Server Query-Aktivität zu konfigurieren:

• Schritt 1: Namen eingeben und Objekt auswählen
  Geben Sie einen Namen für die Aktivität ein und wählen Sie ein Objekt aus.

• Schritt 2: Abfrage erstellen
  Legen Sie Bedingungen für eine Abfrage mithilfe der Objektfelder fest und wenden Sie Paginierung auf eine Abfrage an.

• Schritt 3: Datenschemas überprüfen
  Alle generierten Request- oder Response-Schemas werden angezeigt.

Schritt 1: Namen eingeben und Objekt auswählen

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie ein Objekt aus. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

• Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

  • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

• Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Microsoft SharePoint Server Query-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

• Objekt auswählen: Dieser Bereich zeigt im Endpunkt verfügbare Objekte an.

  • Ausgewähltes SharePoint-Objekt: Nach der Auswahl eines Objekts wird es hier aufgelistet.

  • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Objektliste zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Objekte vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Objekte vom Endpunkt neu zu laden. Dies kann hilfreich sein, wenn Objekte zu Microsoft SharePoint Server hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der angezeigten Objekte in der Konfiguration verwendet werden.

• Objekt auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Objekt auszuwählen. Es kann nur ein Objekt ausgewählt werden. Die verfügbaren Informationen für jedes Objekt werden vom Microsoft SharePoint Server-Endpunkt abgerufen:

  • Name: Der Objektname vom Endpunkt.

  • Typ: Der Objekttyp vom Endpunkt.

  • Beschreibung: Die Objektbeschreibung vom Endpunkt.

• Speichern & Beenden: Klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

• Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Abfrage erstellen

In diesem Schritt legen Sie Bedingungen für eine Abfrage mit den Objektfeldern fest und wenden Paging auf eine Abfrage an. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

• Suche: Geben Sie einen beliebigen Teil eines Feldnamens in das Suchfeld ein, um die Feldliste für das ausgewählte Objekt zu filtern. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden. Die aufgelisteten Ergebnisse werden in Echtzeit mit jedem Tastendruck gefiltert.

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Felder des Objekts vom Microsoft SharePoint Server-Endpunkt neu zu laden.

• Alle auswählen: Wenn Sie das Suchfeld zum Filtern verwenden, können Sie dieses Kontrollkästchen verwenden, um alle sichtbaren Felder auf einmal auszuwählen.

• Felder auswählen: Aktivieren Sie die Kontrollkästchen der Felder, die Sie in die Abfrage einbeziehen möchten, damit diese automatisch zur SELECT-Anweisung in der Abfragezeichenfolge hinzugefügt werden. Sie können auch alle Felder auf einmal mit dem Kontrollkästchen Alle auswählen.

• Paging: Um eine Paging-Klausel (eine Begrenzung der Anzahl der Datensätze mit optionalem Datensatzoffset) hinzuzufügen, können Sie das Dropdown-Menü verwenden, um das Paging-Limit festzulegen und das Feld zum Eingeben eines Offsets zu verwenden. Wenn kein Offset angegeben wird, wird standardmäßig 0 verwendet. Eine einzelne Paging-Klausel wird unterstützt. Wenn keine Paging-Klausel enthalten ist, werden alle Datensätze zurückgegeben.

  • Anwenden: Klicken Sie, um die Klausel automatisch basierend auf den Dropdown-Auswahlen und dem eingegebenen Wert zu erstellen. Die automatisch erstellte Paging-Klausel wird im Textfeld Abfragezeichenfolge angezeigt.

  • Entfernen: Klicken Sie, um eine angewendete Paging-Klausel zu entfernen.

• Bedingungen: Um bedingte Klauseln hinzuzufügen, verwenden Sie die folgenden Felder als Eingabe, um die Klauseln zu erstellen, die dann im Textfeld Abfragezeichenfolge angezeigt werden.

  • Objekt: Feld: Verwenden Sie das Dropdown-Menü, um ein Feld aus dem ausgewählten Objekt auszuwählen.

  • Operator: Verwenden Sie das Dropdown-Menü, um einen Operator auszuwählen, der für den Felddatentyp geeignet ist:

    Operator	Bezeichnung	Beschreibung
    =	Gleich
    !=	Nicht gleich
    LIKE 'string'	Ähnlich	Ähnlich string
    LIKE 'string%'	Beginnt mit	Beginnt mit string
    LIKE '%string'	Endet mit	Endet mit string
    LIKE '%string%'	Enthält	Enthält string
    <	Kleiner als
    <=	Kleiner oder gleich
    >	Größer als
    >=	Größer oder gleich

• Wert: Geben Sie den gewünschten Wert ein, der mit den Dropdown-Auswahlen verwendet werden soll.

• Hinzufügen: Klicken Sie, um die Klausel automatisch basierend auf den Dropdown-Auswahlen und dem eingegebenen Wert zu erstellen. Die bedingte Klausel wird zum Textfeld Query String hinzugefügt.

• Alle entfernen: Klicken Sie, um alle eingegebenen bedingten Klauseln zu entfernen.

• Query String: Während Sie Felder auswählen, Bedingungen festlegen und Paging konfigurieren, wird die Abfrageanweisung in diesem Textfeld automatisch mit den ausgewählten Feldern, Bedingungen und Paging-Limits gefüllt.

  Hinweis

  Die Werte aller globalen Variablen, die in Query String verwendet werden, werden beim Verwenden der Schaltfläche Test Query nicht gefüllt, auch wenn ein Standardwert angegeben ist. Globale Variablenwerte werden zur Laufzeit abgerufen, wenn die Abfrage ausgeführt wird. Um die Abfrage mit einem Standardvariablenwert zu testen, verwenden Sie stattdessen eine Projektvariable.

• Test Query: Klicken Sie, um die Abfrage zu validieren. Wenn die Abfrage gültig ist, wird ein Beispiel von bis zu 10 Datensätzen aus der Abfrage in einer Tabelle angezeigt. Wenn die Abfrage nicht gültig ist, werden relevante Fehlermeldungen angezeigt.

• Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

• Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Datenschemas überprüfen

Das Antwortschema wird angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

• Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden während der Transformationszuordnung erneut angezeigt.

  Informationen zu den Schemaknoten und Feldern finden Sie in der Microsoft SharePoint-Dokumentation. Dokumentation für die REST-API, SOAP-API und SharePoint-Schemas ist verfügbar.

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom Microsoft SharePoint Server-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

• Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

• Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Microsoft SharePoint Server-Aktivität Query schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Query-Aktivitäten können mit diesen Vorgangsmustern als Quelle verwendet werden:

• Transformationsmuster
• Zwei-Ziel-Archivmuster (nur als erste Quelle)
• Zwei-Ziel-HTTP-Archivmuster (nur als erste Quelle)
• Zwei-Transformationsmuster (nur als erste Quelle)

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.

Wenn alles bereit ist, stellen Sie die Operation bereit und führen Sie sie aus und überprüfen Sie das Verhalten durch Kontrolle der Operationsprotokolle.