Erstellen und Konfigurieren eines Projekts in Jitterbit Studio

Einführung

Ein Projekt ist eine Sammlung von einem oder mehreren Workflows, die einen Integrations-Use-Case umfassen und ausführen. Projekte sind der „Container" für Operationen, die in Workflows organisiert sind, sowie für andere Projektkomponenten, die Teil einer Operation sein oder sich an anderer Stelle im Projekt befinden können.

Diese Seite beschreibt, wie man ein neues Projekt in Studio erstellt und konfiguriert, wie man ein vorhandenes Projekt öffnet, wie man die Konfigurationseinstellungen vorhandener Projekte bearbeitet und wie man vorhandene Projekte löscht.

Neue Studio-Projekte können auch mithilfe von Studio-Integrations-Rezepten oder Studio-Prozessvorlagen erstellt werden, die über den Jitterbit Marketplace bereitgestellt werden. Informationen zum Erstellen eines neuen Studio-Projekts aus dem Marketplace finden Sie unter Ein Rezept- oder Vorlagenprojekt starten.

Neues Projekt erstellen

Neue Projekte werden auf der Seite Projekte erstellt. Diese Seite enthält ein Repository mit zugänglichen Studio-Projekten. Wenn in der ausgewählten Organisation keine Projekte zugänglich sind, werden keine aufgelistet.

Um ein neues Studio-Projekt zu erstellen, klicken Sie auf Neues Projekt:

Nach dem Klick auf Neues Projekt wird der Projektkonfigurationsbildschirm geöffnet. Es sind fünf Registerkarten verfügbar: Registerkarte „Allgemein", Registerkarte „Benutzerrollen", Registerkarte „Designer", Registerkarte „Bereitstellung" und Registerkarte „Erweitert".

Beachten Sie, dass ein Projekt nach der Erstellung nicht automatisch bereitgestellt wird (siehe Projektbereitstellung).

Informationen zum Vornehmen von Änderungen an der Projektkonfiguration nach der Erstellung finden Sie später auf dieser Seite unter Projekteinstellungen bearbeiten.

Registerkarte „Allgemein"

Diese Registerkarte hat die folgenden Einstellungen:

• Projektname: Geben Sie einen Namen ein, um das Projekt zu identifizieren. Der Projektname muss für jede Umgebung eindeutig sein und darf nicht bereits als Design Studio-Projektname in derselben Umgebung verwendet werden. Wenn ein Projekt mit demselben Namen bereits in der Harmony-Cloud vorhanden ist, wechseln Sie zur Seite Management Console > Projekte, um das bereitgestellte Projekt zu verwalten.

  Tipp

  Wenn Sie ein Projekt umbenennen, das zuvor bereitgestellt wurde, wird der neue Projektname automatisch in der Harmony-Cloud übernommen, ohne dass eine erneute Bereitstellung erforderlich ist.

• Umgebung: Verwenden Sie das Dropdown-Menü, um eine vorhandene Umgebung auszuwählen, in der Sie das Projekt erstellen möchten. Organisationsadministratoren können neue Umgebungen über die Management Console > Umgebungen einrichten.

  Tipp

  Wenn eine neu erstellte Umgebung nicht zur Auswahl verfügbar ist, aktualisieren Sie die Seite Projekte, um ein erneutes Laden der Umgebungen zu erzwingen.

  Beachten Sie beim Bearbeiten der Projekteinstellungen, dass die Umgebung nicht geändert werden kann. Das Projekt kann jedoch in eine andere Umgebung übertragen werden.

• Beschreibung: Geben Sie eine optionale Beschreibung für das Projekt ein. Diese Beschreibung wird auf der Seite Projekte angezeigt und kann Projektmitarbeitern helfen, das Projekt zu verstehen.

Beim Bearbeiten der Projekteinstellungen sind diese Informationen auf der Registerkarte Allgemein verfügbar:

• Umgebung: Die Umgebung, in der sich das Projekt befindet (angegeben während der Projekterstellung oder Übertragung).

• Agent-Gruppe: Die Agent-Gruppe, die der Umgebung zugeordnet ist, in der sich das Projekt befindet (angegeben in der Management Console).

• Erstellt am: Das Datum und die Uhrzeit der Projekterstellung.

Registerkarte „Benutzerrollen"

Die Registerkarte Benutzerrollen steuert, welche Rollen das Projekt auf der Seite Projekte in Studio und auf der Seite Projekte in der Management Console sehen können. Die Registerkarte enthält ein Suchfeld und eine Tabelle mit den folgenden Spalten:

• Benutzerrolle: Listet Rollen in der Organisation auf. Die angezeigten Rollen hängen von Ihrer Rollenmitgliedschaft ab, wie nachfolgend beschrieben.

• Rollenzugriff: Die höchste Zugriffsstufe, die die Rolle in der Umgebung hat. Mögliche Werte sind Protokolle anzeigen, Lesen, Ausführen und Schreiben.

• Aktiviert: Ein Schalter, der steuert, ob das Projekt auf der Seite Projekte in Studio und auf der Seite Projekte in der Management Console für Mitglieder dieser Rolle sichtbar ist.

Wenn ein neues Projekt erstellt wird, sind standardmäßig alle Rollen, denen der erstellende Benutzer angehört, sowie die Rolle Administrator aktiviert, die immer aktiviert ist.

Die Rollen, die in der Tabelle angezeigt werden, und ob ihre Einstellung Aktiviert umgeschaltet werden kann, hängen von Ihrer Rollenmitgliedschaft ab. Um die Schalter Aktiviert zu ändern, müssen Benutzer über einen Umgebungszugriff von Schreiben verfügen. Benutzer mit Umgebungszugriff Protokolle anzeigen, Lesen oder Ausführen können die Registerkarte anzeigen, können sie aber nicht bearbeiten.

• Wenn Sie Mitglied einer Rolle mit der Berechtigung Admin sind, listet die Tabelle alle Rollen in der Organisation auf, die mindestens Zugriff Protokolle anzeigen auf die Umgebung haben, wobei die Rolle Administrator immer zuerst aufgelistet wird. Alle Schalter können umgeschaltet werden, außer für die Rolle Administrator und die letzte Rolle, der Sie angehören.

• Wenn Sie nicht Mitglied einer Rolle mit der Berechtigung Admin sind, werden in der Tabelle nur die Rollen angezeigt, denen Sie angehören. Wenn Sie genau einer Rolle angehören, ist ihr Schalter aktiviert und kann nicht geändert werden. Wenn Sie mehr als einer Rolle angehören, können ihre Schalter einzeln umgeschaltet werden, aber mindestens einer muss immer aktiviert bleiben.

Die Rolle Administrator wird immer mit ihrem Schalter dauerhaft aktiviert angezeigt.

Änderungen an den Sichtbarkeitseinstellungen für Rollen werden sofort wirksam und erfordern keine Projektbereitstellung.

Registerkarte „Designer"

Diese Registerkarte hat die folgenden Einstellungen:

• Operationen auf der Designoberfläche automatisch nummerieren: Wählen Sie diese Option, um eine fortlaufende Nummer vor jedem Operationsnamen auf der Designoberfläche anzuzeigen. Operationsnummern entsprechen dem Workflow, in dem sich jede Operation befindet. Beispielsweise werden Operationen in Workflow 2.0 automatisch als 2.0, 2.1, 2.2 usw. nummeriert. Die automatische Nummerierung wird nur zur Entwurfszeit angezeigt; die Nummern werden nicht als Teil des Operationsnamens in Operationsprotokollen angezeigt. Sie können den Standard für neue Projekte im Abschnitt Sequenznummerierung der Designoberfläche Ihrer Studio-Kontoeinstellungen festlegen.

Registerkarte „Bereitstellung"

Dieser Tab hat die folgenden Einstellungen:

• Kommentare beim Bereitstellen erforderlich: Wählen Sie diese Option, um festzulegen, dass bei jeder Bereitstellung dieses Projekts ein Dialog angezeigt wird, in dem ein Kommentar hinzugefügt werden muss.
• Tags beim Bereitstellen erforderlich: Wählen Sie diese Option, um festzulegen, dass bei jeder Bereitstellung dieses Projekts ein Dialog angezeigt wird, in dem ein Tag hinzugefügt werden muss.
• HTTP-Validierungsregel: Standardmäßig aktiviert. Das Deaktivieren dieser Einstellung ist normalerweise nicht erforderlich. Weitere Informationen finden Sie unter HTTP-Validierungsregelfehler in Fehlerbehebung bei Operationen.

Registerkarte „Erweitert"

Dieser Tab hat die folgenden Einstellungen:

• Neuen Jitterbit-Skript-Parser aktivieren: Seit dem Release 10.68 / 11.6 standardmäßig aktiviert. Das Deaktivieren dieser Einstellung ist normalerweise nicht erforderlich und wird nur empfohlen, wenn Sie unerwartete Skriptausgaben feststellen.

• Vollständige Zeilencode-Vervollständigungsvorschlag im Jitterbit-Skript-Editor aktivieren: Aktivieren Sie KI-generierte Zeilenvorschläge beim Bearbeiten von Jitterbit-Skripten. Wenn die entsprechende Organisationsrichtlinie deaktiviert ist, wird diese Einstellung deaktiviert und kann nicht aktiviert werden. Andernfalls können Sie den Standard für neue Projekte im Abschnitt KI-Codevervollständigung Ihrer Studio-Kontoeinstellungen festlegen.

• JSON-Namen beibehalten: Bestimmt, welche Schemeverarbeitungsmethode während des Projektdesigns und der Laufzeit verwendet wird, entweder Verarbeitung mit Beibehaltung von JSON-Namen (aktiviert) oder Legacy-JSON-Verarbeitung (deaktiviert). Die standardmäßig verwendete Version hängt davon ab, wann das Projekt erstellt wurde und welche Agent-Version verwendet wird:

  • Verarbeitung mit Beibehaltung von JSON-Namen: Der Standard für Projekte, die nach dem [Release 11.48 Harmony] erstellt wurden und auf Agent-Version 11.48 oder später ausgeführt werden.

  • Legacy-JSON-Verarbeitung: Der Standard für Projekte, die vor dem [Release 11.48 Harmony] erstellt wurden oder auf Agent-Version 11.47 oder früher ausgeführt werden. Die Einstellung JSON-Namen beibehalten kann in solchen Projekten aktiviert werden, sobald die Agent-Version auf 11.48 oder später aktualisiert wird.

Vorhandenes Projekt öffnen

Vorhandene Projekte werden auf der Seite Projekte gefiltert nach Umgebung angezeigt. Es werden nur Projekte angezeigt, für die Ihre Rolle die Sichtbarkeit aktiviert hat (siehe Registerkarte „Benutzerrollen"). Verwenden Sie das Dropdown-Menü für die Umgebung, um eine andere Umgebung für Ihre ausgewählte Organisation auszuwählen.

Vorhandene Projekte können aus der Projektkartenansicht oder der Projektlistenansicht geöffnet werden. Weitere Informationen zu allen verfügbaren Optionen in jeder dieser Ansichten finden Sie unter Projekte.

• Projektkartensicht: Klicken Sie auf das Kartensicht-Symbol , um die Kartensicht zu öffnen. Fahren Sie dann mit der Maus über eine Projektkarte und wählen Sie Anzeigen/Bearbeiten, um das Projekt im Projekt-Designer zu öffnen:

  

• Projektlistenansicht: Klicken Sie auf das Listenansicht-Symbol , um die Listenansicht zu öffnen. Fahren Sie dann mit der Maus über die leere Zelle in der Spalte Aktionen und klicken Sie auf das Bearbeitungssymbol , um das Projekt im Projekt-Designer zu öffnen:

  

Projekteinstellungen bearbeiten

Ein Projekt wird zunächst während der Projekterstellung konfiguriert, die weiter oben auf dieser Seite behandelt wird. Nach der Erstellung eines Projekts können Sie die Projekteinstellungen bearbeiten, um Änderungen am Projektnamen, der Beschreibung oder der Rollensichtbarkeit vorzunehmen oder das Projekt zu exportieren oder zu löschen.

Die Option Projekteinstellungen ist auf der Seite Projekte und in der Projekt-Symbolleiste verfügbar.

Dies öffnet den Bildschirm zur Projektkonfiguration. Es sind fünf Registerkarten verfügbar, wie oben beschrieben, sowie diese zusätzlichen Optionen:

• Meine persönlichen Einstellungen verwenden: Wird nur angezeigt, wenn sich eine oder mehrere Einstellungen dieses Projekts von Ihren aktuellen Studio-Kontoeinstellungen unterscheiden. Klicken Sie, um Ihre Studio-Kontoeinstellungen auf dieses Projekt anzuwenden, wo zutreffend, und überschreiben Sie alle bereits auf Projektebene festgelegten Werte.

• Zu Kontoeinstellungen wechseln: Öffnet die Registerkarte Studio der Seite Kontoeinstellungen in einem neuen Browser-Tab.

• Speichern: Speichert und schließt die Projektkonfiguration. Diese Schaltfläche wird nur aktiviert, nachdem Sie Änderungen an vorhandenen Einstellungen vorgenommen haben.

• Abbrechen: Schließt die Projektkonfiguration ohne zu speichern.

• Exportieren: Generiert und startet den Download einer JSON-Datei des Studio-Projekts. Ein Projektexport kann beispielsweise als Projektbackup oder zum Freigeben einer Kopie des Projekts verwendet werden. Weitere Informationen finden Sie unter Projektexporte und -importe.

• In Papierkorb verschieben: Entfernt das Projekt aus der Umgebung in Studio und der Harmony-Cloud. Projekte können bis zu 90 Tage nach dem Verschieben in den Papierkorb wiederhergestellt werden. Nach 90 Tagen wird das Projekt dauerhaft gelöscht und kann nicht wiederhergestellt werden (siehe Projekt löschen und wiederherstellen weiter unten auf dieser Seite).

Projekt löschen und wiederherstellen

Sie können ein Projekt auf der Seite Projekte löschen, wiederherstellen oder dauerhaft löschen.

Die Option In Papierkorb verschieben ist an diesen Orten verfügbar:

• Die Projekteinstellungen (siehe Projekteinstellungen bearbeiten weiter oben auf dieser Seite).
• Die Seite Projekte (siehe Kartensicht oder Listenansicht unter Projekte).

Beim Klicken auf In Papierkorb verschieben werden Sie in einer Bestätigungsmeldung aufgefordert zu bestätigen, dass Sie das Projekt in den Papierkorb verschieben möchten:

Die Optionen Wiederherstellen und Dauerhaft löschen sind auf der Seite Projekte verfügbar (siehe Kartensicht oder Listenansicht unter Projekte).

Beim Klicken auf Dauerhaft löschen werden Sie in einer Bestätigungsmeldung aufgefordert zu bestätigen, dass Sie das Projekt dauerhaft löschen möchten:

Sie müssen das Wort DELETE eingeben, um die Schaltfläche Löschen zu aktivieren.

Fehlerbehebung

Häufige Gründe, warum Sie ein Projekt möglicherweise nicht löschen können, sind, dass das Projekt abhängige Projekte hat oder dass das Projekt Operationen mit unvollständigem Status hat.

Übertragene Projekte

Wenn das Projekt, das Sie löschen möchten, übertragen wurde, kann es erst gelöscht werden, nachdem Sie alle Projekte weiter unten in der Übertragungskette gelöscht haben (siehe Übertragungsketten in Ein Projekt übertragen). Nach dem Klicken auf Löschen im Dialog Für immer löschen wird ein zweiter Dialog angezeigt, der darauf hinweist, dass das Projekt nicht gelöscht werden kann, und enthält die Namen und Umgebungen der übertragenen Projekte, die das Löschen verhindern:

Löschen Sie zur Behebung zunächst alle Projekte weiter unten in dieser Übertragungskette (aufgelistet im Dialog) und versuchen Sie dann erneut, das ursprüngliche Projekt zu löschen.

Operationen mit unvollständigem Status

Projekte mit eingereichten Operationen, die einen unvollständigen Status haben, können nicht in den Papierkorb verschoben werden. Wenn das Projekt, das Sie in den Papierkorb verschieben möchten, Operationen mit unvollständigem Status hat, einschließlich Eingereicht, Empfangen, Ausstehend, Wird ausgeführt, Abbruch angefordert oder Verzögerter Status, wird eine Fehlermeldung zurückgegeben.

Zur Behebung können Sie unvollständige Operationen von diesen Orten aus abbrechen:

• Die Operation (siehe Operationsstatus in Design-Canvas).
• Die Operationsprotokoll-Tabelle.
• Die Seite Runtime der Management Console.