Zum Inhalt springen

Smartsheet-Aktivität „Sheet abrufen" in Jitterbit Studio

Einführung

Eine Smartsheet-Aktivität Sheet abrufen ruft mithilfe ihrer Smartsheet-Verbindung ein Sheet aus Smartsheet ab und dient als Quelle zur Bereitstellung von Daten in einem Vorgang.

Erstellen einer Smartsheet-Aktivität „Sheet abrufen"

Eine Instanz einer Smartsheet-Aktivität Sheet abrufen wird aus einer Smartsheet-Verbindung mithilfe ihres Aktivitätstyps Sheet abrufen erstellt.

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

Eine vorhandene Smartsheet-Aktivität Sheet abrufen kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Smartsheet-Aktivität „Sheet abrufen"

Führen Sie diese Schritte aus, um eine Smartsheet-Aktivität Sheet abrufen zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und legen Sie den Sheet-Namen und die Anzahl der zurückzugebenden Zeilen fest. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

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.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. 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 Smartsheet-Aktivität Sheet abrufen eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Sheet-Namen eingeben: Geben Sie den Namen des Sheets ein.

  • Seitengröße: Geben Sie die Anzahl der Zeilen (zwischen 1 und 100000) ein, die aus dem Sheet abgerufen werden sollen. Der Standardwert ist 1000.

  • Speichern und beenden: Wenn aktiviert, 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 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 2: Datenschemas überprüfen

Alle Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

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

    Der Smartsheet-Connector verwendet die Smartsheet API 2.0. Weitere Informationen zu den Schema-Knoten und Feldern finden Sie in der API-Dokumentation.

    Tipp

    Das Feld Data gibt eine base64-codierte Datei des angegebenen Blatts zurück. Sie können eine Kombination aus Jitterbit-Funktionen Base64Decode, BinaryToHex und HexToString verwenden, um base64binary in Text zu konvertieren:
    $smartsheetData = Base64Decode(BinaryToHex(HexToString($myData)));

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom Smartsheet-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 Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Smartsheet-Aktivität Get Sheet 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 Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Smartsheet-Aktivitäten Get Sheet können als Quelle mit diesen Vorgangsmustern verwendet werden:

Um die Aktivität mit Scripting-Funktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Scripting-Funktion.

Wenn Sie bereit sind, stellen Sie den Vorgang bereit und führen ihn aus und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.