Erstellen und Konfigurieren eines Projekts in Jitterbit Studio

Einführung

Ein Projekt ist eine Sammlung von einem oder mehreren Workflows, die einen Integrationsanwendungsfall 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 an anderer Stelle im Projekt existieren können.

Diese Seite beschreibt, wie man ein neues Projekt innerhalb von Studio erstellt und konfiguriert, wie man ein bestehendes Projekt öffnet, wie man die Konfigurationseinstellungen bestehender Projekte bearbeitet und wie man bestehende Projekte löscht.

Neue Studio-Projekte können auch durch die Verwendung von Studio-Integrationsrezepten oder Studio-Prozessvorlagen, die über den Jitterbit Marketplace bereitgestellt werden, erstellt werden. Informationen zum Erstellen eines neuen Studio-Projekts aus dem Marketplace finden Sie unter Starten eines Rezept- oder Vorlagenprojekts.

Erstellen eines neuen Projekts

Neue Projekte werden von der Seite Projekte erstellt. Diese Seite enthält ein Repository zugänglicher Studio-Projekte. 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:

Beim Klicken auf Neues Projekt öffnet sich der Bildschirm zur Projektkonfiguration. Fünf Registerkarten stehen zur Verfügung: Allgemeine Registerkarte, Benutzerrollen-Registerkarte, Designer-Registerkarte, Bereitstellungs-Registerkarte und Erweiterte Registerkarte.

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

Für Informationen zur Änderung der Konfiguration des Projekts nach dessen Erstellung siehe Projekteinstellungen bearbeiten weiter unten auf dieser Seite.

Allgemeiner Tab

Dieser Tab hat die folgenden Einstellungen:

• Projektname: Geben Sie einen Namen ein, um das Projekt zu identifizieren. Der Projektname muss für jede Umgebung einzigartig 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 existiert, gehen Sie zur Management Console > Projekte Seite, 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 ohne erneute Bereitstellung übernommen.

• 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 Seite einrichten.

  Tipp

  Wenn Sie eine neu erstellte Umgebung nicht zur Auswahl sehen, aktualisieren Sie die Projekte Seite, um eine Neuladen der Umgebungen zu erzwingen.

  Beim Bearbeiten der Projekteinstellungen beachten Sie, dass die Umgebung nicht geändert werden kann. Das Projekt kann jedoch übertragen werden.

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

Beim Bearbeiten der Projekteinstellungen sind diese Informationen im Allgemein Tab verfügbar:

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

• Agentengruppe: Die Agentengruppe, die mit der Umgebung verbunden ist, in der sich das Projekt befindet (angegeben in der Management-Konsole).

• Erstellt am: Das Datum und die Uhrzeit, zu der das Projekt erstellt wurde.

Benutzerrollen-Tab

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

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

• Rollen-Zugriff: Das höchste Zugriffslevel, das 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 Projekte-Seite im Studio und auf der Management-Konsole Projekte Seite für Mitglieder dieser Rolle sichtbar ist.

Wenn ein neues Projekt erstellt wird, sind standardmäßig alle Rollen, deren Mitglied der erstellende Benutzer ist, aktiviert, zusammen mit der Rolle Administrator, die immer aktiviert ist.

Die Rollen, die in der Tabelle angezeigt werden, und ob deren Aktiviert-Einstellung umgeschaltet werden kann, hängen von Ihrer Rollenmitgliedschaft ab. Um Aktiviert-Schalter zu ändern, müssen Benutzer Umgebungszugriff mit Schreiben haben. Benutzer mit Protokolle anzeigen, Lesen oder Ausführen Umgebungszugriff können den Tab anzeigen, aber nicht bearbeiten.

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

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

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

Änderungen an den Sichtbarkeitseinstellungen der Rolle treten sofort in Kraft und erfordern keine Projektbereitstellung.

Designer-Tab

Dieser Tab hat die folgenden Einstellungen:

• Automatische Nummerierung von Operationen auf der Entwurfsoberfläche: Wählen Sie diese Option, um eine fortlaufende Nummer vor jedem Operationsnamen auf der Entwurfsoberfläche anzuzeigen. Die Operationsnummern entsprechen dem Workflow, in dem sich jede Operation befindet. Zum Beispiel werden in Workflow 2.0 die Operationen automatisch nummeriert als 2.0, 2.1, 2.2 und so weiter. Die automatische Nummerierung wird nur während der Entwurfszeit angezeigt; die Zahlen erscheinen nicht als Teil des Operationsnamens in den Operationsprotokollen.

Bereitstellungs-Tab

Dieser Tab hat die folgenden Einstellungen:

• Kommentare bei der Bereitstellung erforderlich: Wählen Sie diese Option, um zu verlangen, dass jedes Mal, wenn dieses Projekt bereitgestellt wird, ein Dialogfeld angezeigt wird, das erfordert, dass ein Kommentar hinzugefügt wird.
• Tags bei der Bereitstellung erforderlich: Wählen Sie diese Option, um zu verlangen, dass jedes Mal, wenn dieses Projekt bereitgestellt wird, ein Dialogfeld angezeigt wird, das erfordert, dass ein Tag hinzugefügt wird.
• HTTP-Validierungsregel: Standardmäßig aktiviert. Das Deaktivieren dieser Einstellung ist normalerweise nicht erforderlich. Weitere Informationen finden Sie unter HTTP-Validierungsregel-Fehler in Fehlerbehebung bei der Operationserstellung.

Erweiterter Tab

Dieser Tab hat die folgende Einstellung:

• Neuen Jitterbit-Skriptparser aktivieren: Standardmäßig aktiviert seit der Version 10.68 / 11.6. Das Deaktivieren dieser Einstellung ist normalerweise nicht erforderlich und wird nur empfohlen, wenn unerwartete Skriptausgaben auftreten.

• JSON-Namen beibehalten: Bestimmt, welche Schema-Verarbeitungsmethode während des Projektdesigns und zur Laufzeit verwendet wird, entweder JSON-Namen beibehalten-Verarbeitung (aktiviert) oder veraltete JSON-Verarbeitung (deaktiviert). Die standardmäßig verwendete Version hängt davon ab, wann das Projekt erstellt wurde und welche Agenten-Version verwendet wird:

  • JSON-Namen beibehalten-Verarbeitung: Der Standard für Projekte, die nach dem [11.48 Harmony-Release] erstellt wurden und auf Agenten-Version 11.48 oder höher laufen.

  • Veraltete JSON-Verarbeitung: Der Standard für Projekte, die vor dem [11.48 Harmony-Release] erstellt wurden oder die auf Agenten-Version 11.47 oder früher laufen. Die Einstellung JSON-Namen beibehalten kann in solchen Projekten aktiviert werden, sobald die Agenten-Version auf 11.48 oder höher aktualisiert wird.

Ein bestehendes Projekt öffnen

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

Bestehende Projekte können entweder aus der Projektkachelansicht oder der Projektlistenansicht geöffnet werden. Für Details zu allen verfügbaren Optionen in jeder dieser Ansichten siehe Projekte.

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

  

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

  

Projekteinstellungen bearbeiten

Ein Projekt wird zunächst während der Projekt Erstellung konfiguriert, die weiter oben auf dieser Seite behandelt wird. Nachdem ein Projekt erstellt wurde, können die Projekteinstellungen bearbeitet werden, um Änderungen am Projektnamen, der Beschreibung oder der Rollenansicht vorzunehmen oder um das Projekt zu exportieren oder zu löschen.

Die Option Projekteinstellungen ist von der Projekte Seite und der Projekt-Toolbar zugänglich.

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

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

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

• Exportieren: Generiert und initiiert den Download einer JSON-Datei des Studio-Projekts. Ein Projekteexport kann beispielsweise als Projekt-Backup verwendet werden oder um eine Kopie des Projekts zu teilen. Für Details siehe Projektexporte und -importe.

• In den 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 Ein Projekt löschen und wiederherstellen weiter unten auf dieser Seite).

Ein Projekt löschen und wiederherstellen

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

Die Option In den Papierkorb verschieben ist von diesen Orten aus zugänglich:

• Die Projekteinstellungen (siehe Projekteinstellungen bearbeiten weiter oben auf dieser Seite).
• Die Projekte-Seite (siehe Kachelansicht oder Listenansicht in Projekte).

Beim Klicken auf In den Papierkorb verschieben erscheint eine Bestätigungsnachricht, die Sie fragt, ob Sie das Projekt wirklich in den Papierkorb verschieben möchten:

Die Optionen Wiederherstellen und Dauerhaft löschen sind von der Projekte-Seite aus zugänglich (siehe Kachelansicht oder Listenansicht in Projekte).

Beim Klicken auf Dauerhaft löschen erscheint eine Bestätigungsnachricht, die Sie fragt, ob Sie das Projekt dauerhaft löschen möchten:

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

Fehlersuche

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 einem unvollständigen Status hat.

Übertragene Projekte

Wenn das Projekt, das Sie löschen möchten, übertragen wurde, kann es nicht gelöscht werden, bis Sie zuerst alle Projekte weiter unten in der Übertragungskette löschen (siehe Übertragungsketten in Ein Projekt übertragen). Nach dem Klicken auf Löschen im Dialogfeld Für immer löschen zeigt ein zweites Dialogfeld an, dass das Projekt nicht gelöscht werden kann und enthält die Namen und Umgebungen der übertragenen Projekte, die die Löschung verhindern:

Um das Problem zu lösen, löschen Sie zuerst alle Projekte weiter unten in dieser Übertragungskette (im Dialog aufgeführt) und versuchen Sie dann erneut, das ursprüngliche Projekt zu löschen.

Vorgänge mit unvollständigem Status

Projekte mit eingereichten Vorgängen, die sich in einem unvollständigen Status befinden, können nicht in den Papierkorb verschoben werden. Wenn das Projekt, das Sie in den Papierkorb verschieben möchten, Vorgänge im unvollständigen Status hat, einschließlich Eingereicht, Erhalten, Ausstehend, Läuft, Stornierungsanfrage oder Verzögerter Status, wird eine Fehlermeldung zurückgegeben.

Um das Problem zu lösen, können Sie unvollständige Vorgänge von diesen Orten aus stornieren:

• Der Vorgang (siehe Vorgangsstatus in Design-Canvas).
• Die Vorgangsprotokolltabelle.
• Die Laufzeit Seite der Management-Konsole.