Zum Inhalt springen

Coupa Create-Aktivität in Jitterbit Studio

Einführung

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

Eine Coupa Create-Aktivität erstellen

Eine Instanz einer Coupa Create-Aktivität wird aus einer Coupa-Verbindung mit ihrem Aktivitätstyp Create 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. Nähere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene Coupa Create-Aktivität kann an diesen Stellen bearbeitet werden:

Eine Coupa Create-Aktivität konfigurieren

Befolgen Sie diese Schritte, um eine Coupa Create-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und wählen Sie ein Objekt aus

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

  • Endpunktmenü: Falls mehrere Endpunkte desselben Connector-Typs konfiguriert sind, wird in einem Menü oben auf dem Bildschirm der aktuelle Endpunktname angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den Namen des aktuellen Endpunkts bewegen. Klicken Sie hier, 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 Coupa Create-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Objekt auswählen: Dieser Bereich zeigt die im Coupa-Endpunkt verfügbaren Objekte an.

    • Ausgewähltes Objekt: Nachdem ein Objekt ausgewählt wurde, 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 zwischen Groß- und Kleinschreibung nicht unterschieden. Falls Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse bei jedem Tastendruck in Echtzeit gefiltert. Um Objekte vom Endpunkt neu zu laden, wenn Sie suchen, geben Sie Suchkriterien ein und aktualisieren Sie dann wie nachfolgend beschrieben.

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

      • Name: Der Name des Objekts aus Coupa.

      • Beschreibung: Die Beschreibung des Objekts aus Coupa.

    Tipp

    Falls die Tabelle nicht mit verfügbaren Objekten gefüllt wird, ist die Coupa-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass die Verbindung besteht, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

  • Bei Fehler fortfahren: Wählen Sie diese Option, um die Aktivitätsausführung fortzusetzen, wenn bei einer Anforderung mit mehreren Datensätzen ein Fehler auftritt. Falls Fehler auftreten, werden diese ins Operationsprotokoll geschrieben.

  • 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 fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, 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: Ein Subobjekt auswählen

Wählen Sie in diesem Schritt ein Subobjekt aus. Nachfolgend werden die einzelnen Elemente der Benutzeroberfläche für diesen Schritt beschrieben.

  • Objekt auswählen: In diesem Bereich werden die im Coupa-Endpunkt verfügbaren Subobjekte angezeigt.

    • Ausgewähltes Objekt: Das im vorherigen Schritt ausgewählte Objekt wird hier aufgelistet.

    • Ausgewähltes Subobjekt: Nach Auswahl eines Subobjekts wird dieses hier aufgelistet.

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

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

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

      • Name: Der Name des Subobjekts aus Coupa.

      • Typ: Der Typ des Subobjekts aus Coupa.

      • Beschreibung: Die Beschreibung des Subobjekts aus Coupa.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Schreibgeschützte Felder aktivieren: Wählen Sie diese Option, um schreibgeschützte Felder aus Coupa verfügbar zu machen. Das Aktivieren dieser Option führt zu sehr großen Datenschemas.

    • Alle Felder anzeigen: Wählen Sie diese Option, um die Felder der Knoten created-by und updated-by in das Antwortschemal einzubeziehen. Standardmäßig werden diese Knoten ohne ihre Felder generiert. Das Aktivieren dieser Option führt zu sehr großen Datenschemas.

  • 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 fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, 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: Die Datenschemas überprüfen

Alle vom Endpunkt generierten Request- oder Response-Schemas werden angezeigt. Nachfolgend werden die einzelnen Elemente der Benutzeroberfläche für diesen Schritt beschrieben.

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

    Der Coupa-Connector verwendet die Coupa R46 Core Platform API. Weitere Informationen zu den Schemataknoten und Feldern finden Sie in der API-Dokumentation.

  • Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über jedem Datenschema, um den Bearbeitungsmodus für dieses Datenschema aufzurufen. Der Editor ermöglicht Ihnen, Knoten und Felder hinzuzufügen, zu löschen und zu reorganisieren sowie ihre Datentypen zu ändern. Alle Vorkommen von Knoten und Feldern sind auf [0, 1] Kardinalität eingestellt. Änderungen an den Datenschemas müssen vom Endpunkt akzeptiert werden und sollten nur nach Überprüfung der verfügbaren Dokumentation für den Endpunkt vorgenommen werden. Nach der Bearbeitung von Schemas wird ein Datum der letzten Änderung oben im entsprechenden Schema angezeigt, um anzugeben, dass das Schema manuelle Änderungen aufweist. Das Aktualisieren der Schemas setzt die Schemas auf ihre Standardstrukturen zurück.

  • Aktualisieren: Klicke auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Coupa-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, etwa in einer angrenzenden Transformation.

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

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

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

Nächste Schritte

Nachdem du eine Coupa-Aktivität vom Typ Erstellen konfiguriert hast, vervollständige die Konfiguration des Vorgangs, indem du weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügst und konfigurierst. Du kannst auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas verfügbar. Weitere Informationen findest du unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Coupa-Aktivitäten vom Typ Erstellen können als Ziel mit diesen Vorgangsmustern verwendet werden:

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

Wenn bereit, stelle den Vorgang bereit und führe ihn aus, und überprüfe das Verhalten durch Kontrolle der Vorgangsprotokolle.