Zum Inhalt springen

Smartsheet Import Sheet-Aktivität in Jitterbit Studio

Einführung

Eine Smartsheet Import Sheet-Aktivität importiert mithilfe ihrer Smartsheet-Verbindung ein Sheet in Smartsheet und dient als Ziel zum Verarbeiten von Daten in einem Vorgang.

Erstellen einer Smartsheet Import Sheet-Aktivität

Eine Instanz einer Smartsheet Import Sheet-Aktivität wird aus einer Smartsheet-Verbindung mit dem Aktivitätstyp Import Sheet 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 Smartsheet Import Sheet-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Smartsheet Import Sheet-Aktivität

Führen Sie diese Schritte aus, um eine Smartsheet Import Sheet-Aktivität 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 einen Arbeitsbereich, einen Sheet-Namen und einen Dateityp 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 Import Sheet-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Option wählen: Geben Sie an, wie der Arbeitsbereich identifiziert werden soll, in den das Sheet importiert werden soll, entweder Arbeitsbereich-ID eingeben oder Arbeitsbereich auswählen.

    Ein Arbeitsbereich kann auch in der Request-Transformation angegeben werden. Wenn ein Arbeitsbereich an mehreren Stellen angegeben ist, wird diese Rangfolge befolgt:

    1. Ein in der Request-Transformation bereitgestellter Arbeitsbereich überschreibt beide nachfolgenden Optionen.
    2. Ein in das Feld Arbeitsbereich-ID eingegebener Arbeitsbereich überschreibt einen aus der Liste Arbeitsbereich auswählen ausgewählten Arbeitsbereich, auch wenn Arbeitsbereich auswählen die ausgewählte Option ist.
    3. Ein aus der Liste Arbeitsbereich auswählen ausgewählter Arbeitsbereich hat die niedrigste Priorität.

  • Workspace-ID eingeben: (Standard.) Wählen Sie diese Option, um die ID des Arbeitsbereichs manuell einzugeben, in den das Blatt importiert werden soll:

    • Workspace-ID: Geben Sie die ID des Arbeitsbereichs ein. Lassen Sie dieses Feld leer, um das Blatt in Ihren Smartsheet-Startbereich Sheets zu importieren.

  • Arbeitsbereich auswählen: Wählen Sie diese Option, um aus einer Liste von Arbeitsbereichen auszuwählen, die vom Smartsheet-Endpunkt abgerufen werden:

    • Arbeitsbereich auswählen: Dieser Bereich zeigt die im Smartsheet-Endpunkt verfügbaren Arbeitsbereiche an.

      • Ausgewählter Arbeitsbereich: Nach der Auswahl eines Arbeitsbereichs wird dieser hier aufgelistet.

      • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Arbeitsbereiche zu filtern. Die Suche berücksichtigt keine Groß- und Kleinschreibung. Wenn Arbeitsbereiche bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Arbeitsbereiche vom Endpunkt neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

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

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

        • Arbeitsbereichsname: Der Name des Arbeitsbereichs.

        • Workspace-ID: Die ID des Arbeitsbereichs.

    Wichtig

    Diese Aktivität unterstützt die Auflistung von bis zu 100 Arbeitsbereichen in der Tabelle. Wenn Ihre Anmeldedaten Zugriff auf über 100 Arbeitsbereiche ermöglichen, geben Sie die Workspace-ID manuell ein oder stellen Sie sie in der Anforderungstransformation bereit.

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

  • Blattnamen eingeben: Geben Sie einen Namen für das Blatt ein.

  • Zu importierender Dateityp: Wählen Sie einen Dateityp für das Blatt aus, entweder CSV oder XLSX.

  • Speichern und beenden: Klicken Sie, falls aktiviert, 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: Datenschemas überprüfen

Alle Anforderungs- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

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

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

    Hinweis

    Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration. Die Workspace-ID kann in der Anforderungstransformation bereitgestellt oder überschrieben werden.

    Das Feld Data muss ein base64binary sein, das den Inhalt des Blatts enthält. Sie können eine Kombination aus Jitterbits Base64Encode, HexToBinary und StringToHex Funktionen verwenden, um Daten in base64binary zu konvertieren:
    $smartsheetData = Base64Encode(HexToBinary(StringToHex($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 die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Smartsheet-Aktivität Import 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 Import Sheet 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 validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.