Generieren Sie Rezepte und bearbeiten Sie Rezeptseiten im Jitterbit Citizen Integrator

Einführung

Citizen Integrator, zugänglich über das Harmony-Portal, ist die Click-and-Run-Webanwendung von Jitterbit für nicht-technische Benutzer, um Design Studio Integrationen mithilfe vorgefertigter Citizen Integrator-Rezepte schnell anzupassen und einsetzen.

Innerhalb von Citizen Integrator können Sie ein Design Studio hochladen-Projekt, um ein Citizen Integrator-Rezept zu generieren und dann die Rezeptschritte auf der Seite Rezept generieren zu konfigurieren. Für vorhandene Rezepte stellt die Seite Rezept bearbeiten diese Schritte auch zur Bearbeitung zur Verfügung.

Greifen Sie auf die Seite „Rezept generieren“ zu

Die Option zum Generieren eines Citizen Integrator-Rezepts ist unter Citizen Integrator - Meine Rezepte verfügbar-Seite. Nach der Rezepterstellung werden Sie zur Seite Rezept erstellen weitergeleitet, um Ihre Rezeptschritte weiter zu konfigurieren.

Auf der Seite Meine Rezepte ist die Option zum Erstellen eines Rezepts im Abschnitt Meine Rezepte nur für Benutzer mit Administratorberechtigungen innerhalb der ausgewählten Organisation verfügbar.

Klicken Sie auf das JPK-Symbol , um ein Fenster zu öffnen, in dem Sie ein Design Studio Jitterpak hochladen können, das ein Rezept generiert.

Verwenden Sie im Fenster Rezept generieren die Schaltfläche Datei auswählen, um zu dem Jitterpak (.JPK) zu navigieren, das Sie hochladen möchten.

Klicken Sie dann auf Senden, um Ihr neues Rezept zu generieren und die Seite Rezept generieren zu öffnen, auf der Sie Ihre Rezeptschritte weiter konfigurieren können (siehe Rezeptschritte generieren oder bearbeiten unten).

Greifen Sie auf die Seite „Rezept bearbeiten“ zu

Die Option zum Bearbeiten eines Citizen Integrator-Rezepts steht unter Citizen Integrator - Meine Rezepte zur Verfügung-Seite.

Auf der Seite Meine Rezepte wird im Abschnitt Meine Rezepte die Option zum Bearbeiten eines Rezepts verfügbar, sobald Sie nur ein Rezept in der Tabelle ausgewählt haben. Sie ist nur für Benutzer mit Administratorberechtigungen innerhalb der ausgewählten Organisation verfügbar.

Um ein Rezept auszuwählen, klicken Sie irgendwo in die Zeile oder aktivieren Sie das Kontrollkästchen links neben dem Rezept.

Klicken Sie dann auf das Bearbeitungssymbol , um die Seite Rezept bearbeiten zu öffnen, auf der Sie Ihre Rezeptschritte aktualisieren können (siehe Rezeptschritte generieren oder bearbeiten unten).

Rezeptschritte generieren oder bearbeiten

Nachdem Sie wie oben beschrieben auf die Seiten „Rezept generieren“ oder Rezept bearbeiten zugegriffen haben, können Sie die Rezeptschritte über die Citizen Integrator-Benutzeroberfläche wie folgt konfigurieren.

Rezeptname und Beschreibung

Geben Sie im ersten Abschnitt den grundlegenden Namen und die Beschreibung für Ihr Rezept ein.

• Rezeptname: Geben Sie den Namen Ihres Rezepts an oder ändern Sie ihn.
• Rezeptbeschreibung: Geben Sie die Beschreibung Ihres Rezepts an oder ändern Sie sie.

Rezeptprojektvariablen

Im nächsten Abschnitt können Sie dem Rezept Projektvariablen hinzufügen, für die Benutzer bei Verwendung des Rezepts Werte festlegen können sollen. Weitere Informationen finden Sie unter Variablen.

Entfernen oder Wiederherstellen von Projektvariablen

Auf der linken Seite werden alle vorhandenen Projektvariablen aufgelistet.

• Rezept generieren: Beim Generieren eines Rezepts werden alle Projektvariablen aus der Jitterpak-Datei angezeigt. Wenn keine Projektvariablen im Jitterpak enthalten sind, werden keine angezeigt.
• Rezept bearbeiten: Beim Bearbeiten eines Rezepts werden vorhandene Projektvariablen aus den JSON-Metadaten des Rezepts oder dem zuvor generierten Rezept angezeigt.

Um eine Projektvariable aus dem Rezept zu entfernen, klicken Sie auf das Papierkorbsymbol neben dem Projektvariablennamen auf der linken Seite.

Um eine Projektvariable wiederherzustellen, die Sie zuvor entfernt haben, wählen Sie über das Dropdown-Menü oben rechts eine zuvor entfernte Variable aus und klicken Sie auf die Schaltfläche Variable wiederherstellen.

Konfigurieren von Projektvariablen

Auf der rechten Seite stehen die Felder für die ausgewählte Variable zur Konfiguration zur Verfügung.

• Name: Der Name Ihrer vorhandenen Projektvariable kann nicht bearbeitet werden.

• Anzeigename: Dieses Feld kann verwendet werden, wenn in der Citizen Integrator-Schnittstelle ein anderer Name angezeigt werden soll.

• Beschreibung: Dieses Feld kann verwendet werden, um Text unterhalb des Feldes einzufügen, beispielsweise um Anweisungen zu geben, was Benutzer eingeben sollen.

• Wert: Dieses Feld kann verwendet werden, wenn Sie Ihrer Projektvariable einen Standardwert zuweisen möchten. Dies kann verwendet werden, um einen Standardwert mit anderen optionalen Werten für die Projektvariable bereitzustellen. Beispielsweise ein Standardwert von „Produktion“ mit anderen Optionen für „Entwicklung“ oder „QA“. Diese Optionen werden unter dem Feld Typ bereitgestellt.

• Regulärer Ausdruck: Dieses Feld kann verwendet werden, um einen regulären Ausdruck (String) anzugeben, mit dem der Wert der Projektvariable übereinstimmen muss, wenn das Rezept konfiguriert wird, bevor die Aktionen „Verbindung testen“ oder „Vorgang ausführen“ verwendet werden können. Beispiel: ".+@.+[.].+".

• Typ: Dieses Feld kann verwendet werden, um den Werttyp zu definieren, den der Benutzer angeben kann. Verwenden Sie das Dropdown-Menü, um zwischen Text, Passwort, Kontrollkästchen, Dropdown-Menü oder Textbereich auszuwählen. Für Kontrollkästchen und Dropdown-Menüs stehen zusätzliche Optionen zur Konfiguration zur Verfügung. Geben Sie für jede Auswahl eine Beschriftung und einen Wert ein oder verwenden Sie das Papierkorbsymbol, um eine Zeile zu entfernen.

  

• Erforderliches Feld: Wenn dieses Kontrollkästchen aktiviert ist, muss das Feld „Projektvariable“ ausgefüllt werden, wenn das Rezept konfiguriert wird, bevor die Aktionen „Verbindung testen“ oder „Vorgang ausführen“ verwendet werden können.

Rezeptschritte

Der nächste Abschnitt dient zum Einrichten der Schritte, die Benutzer ausführen müssen, um das Citizen Integrator-Rezept zu konfigurieren.

Schritte hinzufügen oder entfernen

Auf der linken Seite werden alle vorhandenen Rezeptschritte aufgelistet.

• Rezept generieren: Beim Generieren eines Rezepts werden standardmäßig Einführungs- und Überprüfungsschritte hinzugefügt.
• Rezept bearbeiten: Beim Bearbeiten eines Rezepts werden vorhandene Schritte aus den JSON-Metadaten des Rezepts oder dem zuvor generierten Rezept angezeigt.

Um einen Schritt aus dem Rezept zu entfernen, klicken Sie auf das Papierkorbsymbol neben dem Schrittnamen auf der linken Seite. Die Schritte „Einführung“ und „Überprüfung“ sowie alle automatisch generierten Schritte können nicht entfernt werden.

Um einen neuen Schritt hinzuzufügen, klicken Sie oben rechts auf die Schaltfläche Neuen Schritt hinzufügen. Vor dem Schritt „Überprüfung“ wird ein neuer Schritt erstellt.

Schritte konfigurieren

Auf der rechten Seite stehen die Felder für den ausgewählten Schritt zur Konfiguration zur Verfügung. Die folgenden Felder sind für alle Schritttypen gleich:

• Schrittname: Geben Sie einen Namen für den Schritt ein, der im Rezept angezeigt werden soll (z. B. „Einführung“ oder „Salesforce Authentifizierung“).
• Typ: Wählen Sie einen der folgenden Schritttypen:
  • Beschreibung: Wird verwendet, um Informationen über das Rezept und/oder seine Bestandteile bereitzustellen.
  • Schrittkonfiguration: Wird verwendet, um eine oder mehrere Projektvariablen zu definieren, um die Konnektivität für einen bestimmten Endpoint zu überprüfen.
  • Vorgang ausführen: Wird verwendet, um eine Operation Durchführen, bevor das Rezept bereitgestellt wird.
  • API Bindung: Wird verwendet, wenn Vorgänge als APIs externalisiert werden müssen.
• Beschreibung: Geben Sie eine Beschreibung des Schritts ein, die im Rezept angezeigt werden soll.

Jeder Schritttyp und alle Felder, die verfügbar werden, wenn der Schritt ausgewählt wird, werden unten ausführlich behandelt.

• Beschreibung: Dieser Schritttyp wird verwendet, um Informationen über das Rezept und/oder seine Komponenten bereitzustellen.
  • Details: Geben Sie hier das HTML ein, das in diesem Schritt gerendert werden soll.

• Schrittkonfiguration: Dieser Schritttyp wird normalerweise zum Testen einer Endpoint verwendet.

  • Erforderlich: Aktivieren Sie dieses Kontrollkästchen, wenn dieser Schritt vor der Bereitstellung des Rezepts abgeschlossen sein muss (z. B. um zu testen oder zu bestätigen, dass eine Endpoint erfolgreich ist).
  • Projektvariable(n): Verwenden Sie das Dropdown-Menü, um dem Schritt Projektvariablen hinzuzufügen, oder verwenden Sie das Papierkorbsymbol, um sie zu entfernen. Projektvariablen werden im vorherigen Abschnitt konfiguriert.

  • Aktion: Aktivieren Sie dieses Kontrollkästchen, wenn Sie in den Schritt eine Aktion einschließen möchten (z. B. die Verbindung mit den bereitgestellten Anmeldeinformationen testen). Wenn dieses Kontrollkästchen aktiviert ist, werden die folgenden zusätzlichen Felder verfügbar:

    • Schaltflächenname: Geben Sie einen Namen ein, der auf der Aktionsschaltfläche angezeigt werden soll (z. B. „Verbindung testen“).
    • Schrittaktion: Verwenden Sie das Dropdown-Menü, um eine Aktion auszuwählen. Alle vorhandenen Endpoints aus der Jitterpak-Datei werden im Dropdown-Menü aufgelistet.

    Nach Auswahl einer Aktion wird automatisch ein Aktionsschritt unter dem aktuellen Schritt hinzugefügt. Sie müssen dann in der Liste der Schritte links auf den automatisch generierten Schritt klicken, um die Schrittdetails zu konfigurieren. Weitere Informationen finden Sie weiter unten unter dem automatisch generierten Schritttyp.

• Vorgang ausführen: Dieser Schritttyp wird verwendet, um eine Operation Durchführen.

  • Erforderlich: Aktivieren Sie dieses Kontrollkästchen, wenn dieser Schritt vor der Bereitstellung des Rezepts abgeschlossen sein muss.
  • Operationspfad: Alle vorhandenen Operationen aus der Jitterpak-Datei werden hier aufgelistet. Wählen Sie die Operation aus, die Sie an diesem Stopp ausführen möchten.
  • Beschreibung des Vorgangs: Geben Sie eine Beschreibung des ausgewählten Operation ein, um im Rezept Informationen darüber bereitzustellen, was der Operation bewirkt.
• API -Bindung: Dieser Schritttyp wird verwendet, wenn Operationen als APIs externalisiert werden müssen. Die Felder sollten die erforderlichen Informationen für die API enthalten. Siehe API-Manager für weitere Informationen.

• Automatisch generierter Schritt: Dieser Schritttyp wird automatisch erstellt, wenn Sie den Typ Schrittkonfiguration wählen und das Kontrollkästchen Aktion mit einer ausgewählten Schrittaktion aktivieren.

  • Vorgang ausführen: Informationen zu konfigurierbaren Feldern finden Sie im obigen Schritt „Vorgang ausführen“.

  • Verbindungen testen: Alle benötigten Variablen werden basierend auf der ausgewählten Aktion angezeigt. Sie können entweder einen Standardwert fest codieren oder Projektvariablen verwenden, die im vorherigen Abschnitt eingerichtet wurden.

    

    • Standardwert: Geben Sie einen Standardwert in das Textfeld ein, um den Wert der Variablen fest zu codieren. Benutzer können diesen Wert beim Bereitstellen eines Rezepts nicht ändern.

    • Projektvariable: Aktivieren Sie das Kontrollkästchen und verwenden Sie das Dropdown-Menü, um eine zu verwendende Projektvariable auszuwählen, die Sie im vorherigen Abschnitt eingerichtet haben.

Nachkonfiguration

Nachdem Sie Ihr generiertes oder bearbeitetes Citizen Integrator-Rezept wie oben beschrieben konfiguriert haben, verwenden Sie, wenn Sie bereit sind, die Schaltflächen unten auf der Seite.

• Vorschau: Verwenden Sie diese Schaltfläche, um eine Vorschau der generierten JSON-Datei anzuzeigen, die für Ihr Rezept verwendet werden soll.

  

• In Datei speichern: Verwenden Sie diese Schaltfläche, um die generierte JSON-Datei herunterzuladen.

• Abbrechen: Verwenden Sie diese Schaltfläche, um die Seite zu schließen, ohne Änderungen zu speichern.

• Hochladen / Aktualisieren: Diese Schaltflächen validieren das Rezept und laden es entweder in die ausgewählte Organisation hoch (auf der Seite Rezept generieren) oder aktualisieren das Rezept (auf der Seite Rezept bearbeiten).