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 anschließend die Rezeptschritte auf der Seite Rezept generieren zu konfigurieren. Für vorhandene Rezepte stehen diese Schritte auch auf der Seite Rezept bearbeiten 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 gelangen Sie zur Seite Rezept erstellen, um Ihre Rezeptschritte weiter zu konfigurieren.

Auf der Seite Meine Rezepte im Bereich Meine Rezepte ist die Option zum Erstellen eines Rezepts 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.

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

Klicken Sie anschließend auf Senden, um Ihr neues Rezept zu erstellen. Öffnen Sie die Seite Rezept erstellen, auf der Sie Ihre Rezeptschritte weiter konfigurieren können (siehe Rezeptschritte erstellen oder bearbeiten unten).

Greifen Sie auf die Seite „Rezept bearbeiten“ zu

Die Option zum Bearbeiten eines Citizen Integrator-Rezepts ist unter Citizen Integrator - Meine Rezepte verfügbar. Seite.

Auf der Seite Meine Rezepte im Bereich Meine Rezepte können Sie Rezepte bearbeiten, sobald Sie ein Rezept in der Tabelle ausgewählt haben. Diese Option ist nur für Nutzer mit Administratorrechten in der ausgewählten Organisation verfügbar.

Um ein Rezept auszuwählen, klicken Sie auf eine beliebige Stelle in der Zeile oder aktivieren Sie das Kontrollkästchen links neben dem Rezept.

Klicken Sie anschließend 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 wie folgt über die Benutzeroberfläche von Citizen Integrator konfigurieren.

Rezeptname und Beschreibung

Geben Sie im ersten Abschnitt den Namen und die Beschreibung Ihres Rezepts ein.

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

Rezeptprojektvariablen

Im nächsten Abschnitt fügen Sie dem Rezept Projektvariablen hinzu, für die Benutzer bei der Verwendung des Rezepts Werte festlegen können. 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. Sind keine Projektvariablen im Jitterpak enthalten, werden keine angezeigt.
• Rezept bearbeiten: Beim Bearbeiten eines Rezepts werden vorhandene Projektvariablen aus den JSON-Metadaten des Rezepts oder einem zuvor generierten Rezept angezeigt.

Um eine Projektvariable aus dem Rezept zu entfernen, klicken Sie auf das Papierkorbsymbol neben dem Namen der Projektvariable links.

Um eine zuvor entfernte Projektvariable wiederherzustellen, wählen Sie im Dropdown-Menü oben rechts die 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 bereit.

• 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 weiteren optionalen Werten für die Projektvariable bereitzustellen. Beispielsweise ein Standardwert von „Produktion“ mit weiteren Optionen für „Entwicklung“ oder „Qualitätssicherung“. Diese Optionen finden Sie unter dem Feld Typ.

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

• Typ: In diesem Feld können Sie den Werttyp festlegen, den der Benutzer eingeben kann. Wählen Sie über die Dropdown-Liste zwischen Text, Passwort, Kontrollkästchen, Dropdown-Liste oder Textbereich. Für Kontrollkästchen und Dropdown-Listen 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.

  

• Pflichtfeld: Wenn dieses Kontrollkästchen aktiviert ist, muss das Feld „Projektvariable“ bei der Konfiguration des Rezepts ausgefüllt werden, bevor die Aktionen „Verbindung testen“ oder „Vorgang ausführen“ verwendet werden können.

Rezeptschritte

Im nächsten Abschnitt werden die Schritte eingerichtet, 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 erstellen: Beim Erstellen eines Rezepts werden standardmäßig die Schritte „Einführung“ und „Überprüfung“ hinzugefügt.
• Rezept bearbeiten: Beim Bearbeiten eines Rezepts werden vorhandene Schritte aus den JSON-Metadaten des Rezepts oder zuvor generierten Rezepts angezeigt.

Um einen Schritt aus dem Rezept zu entfernen, klicken Sie auf das Papierkorbsymbol neben dem Schrittnamen links. Die Schritte „Einführung“ und „Überprüfung“ sowie automatisch generierte 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 aus:
  • Beschreibung: Wird verwendet, um Informationen über das Rezept und/oder seine Komponenten 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, der 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 die Dropdown-Liste, um dem Schritt Projektvariablen hinzuzufügen, oder verwenden Sie das Papierkorbsymbol, um sie zu entfernen. Projektvariablen wurden im vorherigen Abschnitt konfiguriert.

  • Aktion: Aktivieren Sie dieses Kontrollkästchen, wenn Sie eine Aktion in den Schritt einbinden möchten (z. B. die Verbindung mit den angegebenen 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 die Dropdown-Liste, um eine Aktion auszuwählen. Alle vorhandenen Endpoints aus der Jitterpak-Datei werden in der Dropdown-Liste aufgelistet.

    Nach Auswahl einer Aktion wird automatisch ein Aktionsschritt unter dem aktuellen Schritt hinzugefügt. Klicken Sie anschließend in der Schrittliste links auf den automatisch generierten Schritt, um die Schrittdetails zu konfigurieren. Weitere Informationen finden Sie 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 ausgelagert werden müssen. Die Felder sollten die benötigten 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 die im vorherigen Abschnitt eingerichteten Projektvariablen verwenden.

    

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

    • Projektvariable: Aktivieren Sie das Kontrollkästchen und wählen Sie über die Dropdown-Liste die zu verwendende Projektvariable aus, die Sie im vorherigen Abschnitt eingerichtet haben.

Nachkonfiguration

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

• Vorschau: Klicken Sie auf diese Schaltfläche, um eine Vorschau der generierten JSON-Datei anzuzeigen, die Sie für Ihr Rezept verwenden können.

  

• In Datei speichern: Mit dieser Schaltfläche laden Sie die generierte JSON-Datei herunter.

• Abbrechen: Mit dieser Schaltfläche schließen Sie die Seite, ohne die Änderungen zu speichern.

• Hochladen / Aktualisieren: Mit diesen Schaltflächen wird das Rezept validiert und entweder in die ausgewählte Organisation hochgeladen (auf der Seite Rezept generieren) oder aktualisiert (auf der Seite Rezept bearbeiten).