Zum Inhalt springen

Microsoft SharePoint 365-Abfrageaktivität in Jitterbit Studio

Einführung

Eine Microsoft SharePoint 365-Abfrageaktivität verwendet ihre Microsoft SharePoint 365-Verbindung, um Objektdaten in Microsoft SharePoint 365 abzufragen und dient als Quelle zur Bereitstellung von Daten in einem Vorgang.

Erstellen einer Microsoft SharePoint 365-Abfrageaktivität

Eine Instanz einer Microsoft SharePoint 365-Abfrageaktivität wird aus einer Microsoft SharePoint 365-Verbindung mit ihrem Aktivitätstyp Abfrage 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 365-Abfrageaktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Microsoft SharePoint 365-Abfrageaktivität

Führen Sie diese Schritte aus, um eine Microsoft SharePoint 365-Abfrageaktivität zu konfigurieren:

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 365-Abfrageaktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Objekt auswählen: Dieser Abschnitt zeigt Objekte an, die im Microsoft SharePoint 365-Endpunkt verfügbar sind.

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

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte 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 Microsoft SharePoint 365-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Objekte zu Microsoft SharePoint 365 hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der angezeigten Objekte in der Konfiguration verwendet werden.

  • Ein Objekt auswählen: Klicken Sie in der Tabelle auf eine beliebige 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 365-Endpunkt abgerufen:

    -   **Name:** Der Objektname aus Microsoft SharePoint 365.

-   **Typ:** Der Objekttyp aus Microsoft SharePoint 365.

-   **Beschreibung:** Die Objektbeschreibung aus Microsoft SharePoint 365.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren Objekten gefüllt wird, ist die Microsoft SharePoint 365-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

  • 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 Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Untergeordnete Objekte auswählen

Wählen Sie in diesem Schritt beliebige untergeordnete Objekte aus. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Objektklassen: Dieser Bereich zeigt die verfügbaren und ausgewählten untergeordneten Objektklassen an, mit denen Sie im Microsoft SharePoint 365-Endpunkt interagieren können.

    • Verfügbare untergeordnete Objekte: Dieser Bereich zeigt eine Liste der im Microsoft SharePoint 365 verfügbaren untergeordneten Objektklassen an.

      • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte 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 nachfolgend beschrieben.

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

      • Hinzufügen eines untergeordneten Objekts: Klicken Sie in der Spalte Verfügbare untergeordnete Objekte auf eine beliebige Zeile, um eine oder mehrere untergeordnete Objektklassen auszuwählen. Klicken Sie dann auf das Hinzufügungssymbol , um die ausgewählten Klassen zur Spalte Ausgewählte untergeordnete Objekte hinzuzufügen.

    • Ausgewählte untergeordnete Objekte: Nach dem Hinzufügen einer untergeordneten Objektklasse wird sie hier aufgelistet.

      • Entfernen eines untergeordneten Objekts: Klicken Sie in der Spalte Ausgewähltes untergeordnetes Objekt auf eine beliebige Zeile, um eine oder mehrere untergeordnete Objektklassen auszuwählen. Klicken Sie dann auf das Entfernungssymbol , um die ausgewählten Klassen zur Spalte Verfügbare untergeordnete Objekte zurückzugeben.

  • 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 die Schaltfläche Fertig im letzten Schritt 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: Eine Filterzeichenfolge definieren

In diesem Schritt wird die Filterzeichenfolge einer Abfrage für eine Abfrage mit verfügbaren Objektfeldern und Abfrageeinstellungen definiert. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

Die in diesem Schritt der Konfiguration einer Microsoft SharePoint 365-Aktivität vom Typ Abfrage verwendete Benutzeroberfläche hängt von der ausgewählten Registerkarte ab:

  • Basis: Mit dieser Option können Sie die Filterzeichenfolge mit geführten Feldern erstellen.

  • Erweitert: Mit dieser Option werden die geführten Felder ausgeblendet und Sie können die Filterzeichenfolge direkt ändern.

Basis

Wenn die Registerkarte Basic ausgewählt ist, wird die nachfolgend beschriebene Benutzeroberfläche angezeigt.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen.

  • Object Fields: Wählen Sie die Felder aus, die in der Abfrage basierend auf der ausgewählten Objektklasse verwendet werden sollen.

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

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

    • Select All in Object Class: Wenn Sie das Suchfeld zum Filtern verwenden, können Sie dieses Kontrollkästchen verwenden, um alle sichtbaren Felder auf einmal auszuwählen.

    • Select Fields: Aktivieren Sie die Kontrollkästchen der Felder, die Sie in die Abfrage einbeziehen möchten, um sie automatisch zum Filter String hinzuzufügen. Sie können auch alle Felder auf einmal mit dem übergeordneten Kontrollkästchen auswählen.

    • Page Size: Geben Sie eine Seitengröße ein, um die Paginierung von Ergebnissen zu aktivieren. Die Anzahl der Ergebnisse auf einer Seite entspricht der angegebenen Größe. Ein Link zur nächsten Ergebnisseite wird auch in der Antwort enthalten sein.

    • Include Count: Wählen Sie diese Option, um die Anzahl der Ergebnisse aus einer Abfrage als Teil der Antwort einzubeziehen.

    • Full Text Search: Geben Sie Suchbegriffe ein, um Objekte in der ausgewählten Objektklasse abzufragen. Der Microsoft SharePoint 365-Endpunkt bestimmt, wie die Suche für eine Objektklasse interpretiert wird.

    • Skip: Geben Sie eine Anzahl von Ergebnissen ein, die in der Abfrageantwort übersprungen werden sollen.

    • Top: Geben Sie eine maximale Anzahl von Ergebnissen ein, die Sie in der Abfrageantwort erhalten möchten.

    • Conditional Clauses: Um Bedingungen hinzuzufügen, verwenden Sie diese Felder als Eingabe, um die Klauseln zu konstruieren, die dann im Filter String angezeigt werden.

      • Object: Verwenden Sie das Dropdown-Menü, um die Objektklasse auszuwählen, die für die Bedingung verwendet werden soll.

      • Field: Verwenden Sie das Dropdown-Menü, um das Feld aus der Objektklasse auszuwählen, das für die Bedingung verwendet werden soll.

      • Operator: Verwenden Sie das Dropdown-Menü, um einen geeigneten Operator auszuwählen:

        Vergleich
        Equals
        Greater Than
        Greater Than or Equals
        Less Than
        Less Than or Equals

      • Value: Geben Sie den gewünschten Wert ein, um ihn mit den vorherigen Dropdown-Auswahlen zu vergleichen.

      • Remove: Klicken Sie auf das Löschsymbol , um die Bedingung aus der Tabelle zu entfernen.

      • Add: Klicken Sie, um eine neue Bedingung zur Tabelle und zum Filter String hinzuzufügen.

      • Remove All: Klicken Sie, um alle Bedingungen aus der Tabelle und dem Filter String zu entfernen.

    • Filter String: Während Sie die anderen Felder auf der Registerkarte Basic ausfüllen, wird die Filterzeichenfolge in diesem Textfeld automatisch mit den ausgewählten Feldern, Bedingungen und Abfrageoptionen gefüllt.

  • 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.

    Hinweis

    Aufgrund einer Einschränkung im OData v4 Protocol hat eine gültige Abfrage, die keine Ergebnisse zurückgibt, eine leere Tabelle und zeigt keine Fehlermeldung an.

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

  • Next: 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 Finished im letzten Schritt klicken.

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

Erweitert

Wenn die Registerkarte Erweitert ausgewählt ist, wird die nachfolgend beschriebene Benutzeroberfläche angezeigt.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Seitengröße: Geben Sie eine Seitengröße ein, um die Paginierung von Ergebnissen zu aktivieren. Die Anzahl der Ergebnisse auf einer Seite entspricht der angegebenen Größe. Ein Link zur nächsten Ergebnisseite wird auch in die Antwort aufgenommen.

  • Filterzeichenfolge: Bearbeiten Sie die Filterzeichenfolgenanweisung direkt.

  • Abfrage testen: Klicken Sie hier, 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. Wenn Sie die Filterzeichenfolge im Modus Erweitert bearbeiten, muss die Abfrage gültig sein und durch diese Schaltfläche validiert werden, um die Schaltfläche Weiter zu aktivieren.

    Hinweis

    Aufgrund einer Einschränkung im OData v4-Protokoll hat eine gültige Abfrage, die keine Ergebnisse zurückgibt, eine leere Tabelle und zeigt keine Fehlermeldung an.

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

  • Weiter: Klicken Sie hier, 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: Nach dem Vornehmen von Änderungen klicken Sie hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 4: Datenschemas überprüfen

Alle Anfrage- oder Antwortschemas werden 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.

    Der Microsoft SharePoint 365-Connector verwendet das OData v4-Protokoll. Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

    Die Aktivität Abfrage verwendet JSON in ihrem Antwortschema.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Microsoft SharePoint 365-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.

  • Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über jedem Datenschema, um den Editor zu öffnen. Der Editor ermöglicht es Ihnen, Knoten und Felder hinzuzufügen, zu löschen und neu zu organisieren sowie deren Datentypen zu ändern. Alle neu hinzugefügten Knoten und Felder werden auf [0, 1] Kardinalität gesetzt. Änderungen an den Datenschemas müssen für den Endpunkt akzeptabel sein und sollten nur nach Rücksprache mit der verfügbaren Dokumentation für den Endpunkt vorgenommen werden. Nach dem Bearbeiten von Schemas wird oben im entsprechenden Schema ein Datum der letzten Bearbeitung angezeigt, um anzuzeigen, dass das Schema manuell bearbeitet wurde. Das Aktualisieren der Schemas setzt die Schemas auf ihre Standardstrukturen zurück.

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

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

  • Änderungen verwerfen: Nach dem Vornehmen von Änderungen klicken Sie hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen 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 365 Query-Aktivität 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 Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

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

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 Sie bereit sind, stellen Sie den Vorgang bereit und führen ihn aus und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.