Zum Inhalt springen

Microsoft SharePoint 365 Create-Aktivität in Jitterbit Studio

Einführung

Eine Microsoft SharePoint 365 Create-Aktivität verwendet ihre Microsoft SharePoint 365-Verbindung, um Objektdaten in Microsoft SharePoint 365 zu erstellen. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Erstellen einer Microsoft SharePoint 365 Create-Aktivität

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

Konfigurieren einer Microsoft SharePoint 365 Create-Aktivität

Führen Sie diese Schritte aus, um eine Microsoft SharePoint 365 Create-Aktivitä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 Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, 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 Create-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Objekt auswählen: In diesem Bereich werden Objekte angezeigt, 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 nachfolgend beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Objekte vom Microsoft SharePoint 365-Endpunkt neu zu laden. Dies kann hilfreich 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.

    • 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 für jedes Objekt verfügbaren Informationen werden vom Microsoft SharePoint 365-Endpunkt abgerufen:

  • Name: Der Objektname aus Microsoft SharePoint 365.

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

-   **Description:** 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.

  • Save & Exit: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

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

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

Step 2: Select child objects

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

  • Object Classes: Dieser Abschnitt zeigt die verfügbaren und ausgewählten untergeordneten Objektklassen an, mit denen im Microsoft SharePoint 365-Endpunkt interagiert werden soll.

    • Available Child Objects: Dieser Abschnitt zeigt eine Liste der in Microsoft SharePoint 365 verfügbaren untergeordneten Objektklassen an.

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

      • Refresh: Klicken Sie auf das Aktualisierungssymbol oder das Wort Refresh, um Objekte vom Microsoft SharePoint 365-Endpunkt neu zu laden. Dies kann hilfreich 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.

      • Adding a Child Object: Klicken Sie in der Spalte Available Child Objects auf eine beliebige Stelle in einer Zeile, um eine oder mehrere untergeordnete Objektklassen auszuwählen. Klicken Sie dann auf das Hinzufügungssymbol , um die ausgewählten Klassen zur Spalte Selected Child Objects hinzuzufügen.

    • Selected Child Objects: Nach dem Hinzufügen einer untergeordneten Objektklasse wird sie hier aufgelistet.

      • Removing a Child Object: Klicken Sie in der Spalte Selected Child Object auf eine beliebige Stelle in einer Zeile, um eine oder mehrere untergeordnete Objektklassen auszuwählen. Klicken Sie dann auf das Entfernungssymbol , um die ausgewählten Klassen zur Spalte Available Child Objects zurückzugeben.

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

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

Step 3: Review the data schemas

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Data Schemas: 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 Create-Aktivität verwendet JSON sowohl in ihren Anfrage- als auch in ihren Antwortschemas.

  • Refresh: Klicken Sie auf das Aktualisierungssymbol oder das Wort Refresh, 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 das gleiche Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über jedem Datenschema, um den Editor zu öffnen. Im Editor können Sie Knoten und Felder hinzufügen, löschen und neu anordnen sowie deren Datentypen ändern. Alle neu hinzugefügten Knoten und Felder erhalten die Kardinalität [0, 1]. Änderungen an den Datenschemas müssen vom Endpunkt akzeptiert werden und sollten nur nach Rücksprache mit der verfügbaren Dokumentation des Endpunkts vorgenommen werden. Nach der Bearbeitung des Schemas wird oben im betreffenden Schema ein Datum der letzten Bearbeitung angezeigt, um anzuzeigen, dass das Schema manuell bearbeitet wurde. Das Aktualisieren der Schemas setzt diese auf ihre Standardstrukturen zurück.

  • 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 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 Create-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 Designoberfläche zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

Microsoft SharePoint 365 Create-Aktivitäten können als Ziel 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 Sie ihn aus und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle prüfen.