Seite „Umgebungen" in der Jitterbit Management Console

Übersicht

Einführung

Umgebungen innerhalb einer Organisation definieren und verwalten den Lebenszyklus eines Integrationsprojekts. Sie müssen mindestens eine Umgebung einrichten, um Projekte in Harmony zu erstellen. Jedes Integrationsprojekt wird in einer bestimmten Harmony-Umgebung bereitgestellt. Umgebungen können verwendet werden, um verschiedene Zustände eines Integrationsprojekts zu trennen. Eine typische Projektlebenszyklus-Konfiguration könnte beispielsweise drei Umgebungen haben: Entwicklung, Test und Produktion.

Der Zugriff, den Benutzer in einer bestimmten Umgebung haben, hängt von der Kombination der Berechtigungen ihrer Rolle und ihres Umgebungszugriffs ab:

• Die Berechtigungen einer Rolle werden auf der Seite Benutzerverwaltung definiert.
• Eine Rolle erhält Zugriff auf eine Umgebung wie unter Rollenzugriff auf Umgebungen verwalten später auf dieser Seite beschrieben.

Um auf eine Umgebung zuzugreifen, müssen alle Rollen (auch Rollen mit der Berechtigung Admin) für die meisten Apps Zugriff auf eine Umgebung erhalten. Dies umfasst den Zugriff auf Bereiche von Harmony-Anwendungen, die erfordern, dass eine Umgebung ausgewählt wird, sowie die Möglichkeit, Agenten in einer Umgebung zu installieren. Die Ausnahmen sind die Anwendungen EDI und App Builder, die keine Umgebungszugriffsstufen für Rollen erfordern. Der Zugriff auf diese Apps wird allein durch Rollenberechtigungen gesteuert.

Wenn Sie bereit sind, ein Projekt zwischen Umgebungen zu verschieben, z. B. von Entwicklung zu Test, übertragen Sie das Projekt. Dies kann in Studio erfolgen (siehe Projektübertragung) oder in Design Studio (unter Datei > Projekt migrieren).

Zugriff auf die Seite „Umgebungen"

Benutzer können die Seite Umgebungen je nach Kombination der Berechtigungen ihrer Organisationsrolle und ihres Umgebungszugriffs anzeigen oder bearbeiten:

• Mitglieder einer Rolle mit nur der Berechtigung Lesen, deren Rolle Zugriff auf eine Umgebung erhalten hat, können Informationen zur Umgebung auf der Seite Umgebungen anzeigen, können sie aber nicht bearbeiten.
• Mitglieder einer Rolle mit der Berechtigung Admin können alle Aktionen für alle Umgebungen auf der Seite Umgebungen anzeigen und verwenden (auch wenn ihnen kein Rollenzugriff auf die Umgebung gewährt wurde).

Um auf die Seite Umgebungen zuzugreifen, verwenden Sie das Harmony-Portalmenü, um Management Console > Umgebungen auszuwählen.

Umgebungen verwalten

Harmony-Organisationsadministratoren (Mitglieder einer Rolle mit der Berechtigung Admin) verwalten jede Umgebung und die damit verbundenen Agent-Gruppen. Mitglieder einer Rolle mit nur der Berechtigung Lesen, deren Rolle Zugriff auf eine Umgebung erhalten hat, können Informationen zur Umgebung anzeigen, können aber keine Umgebungen hinzufügen, bearbeiten oder entfernen.

Umgebungen anzeigen

Der obere Bereich der Seite Umgebungen enthält eine Tabelle, die alle Umgebungen anzeigt, auf die Sie innerhalb der ausgewählten Organisation Zugriff haben:

Die Tabelle zeigt Informationen für jede Umgebung. Diese Felder sind wie in den folgenden Abschnitten erläutert konfigurierbar:

• Name: Der Name der Umgebung.

• ID: Die Umgebungs-ID.

• Klasse: Die Klasse der Umgebung für die Berichterstellung zur Lizenznutzung von Endpoints und Agent-Gruppierung für HA (Hochverfügbarkeit). Die Klasse hat keine Auswirkungen auf die Funktionsweise einer Umgebung.

• Agent-Gruppe: Die Agent-Gruppe und Agent-Klasse, die der Umgebung zugeordnet sind. Die Klasse ist entweder Standard oder HA (Hochverfügbarkeit). Weitere Informationen finden Sie unter Agents.

• URL-Präfix: Das URL-Präfix der Umgebung zur Verwendung mit benutzerdefinierten, OData- und Proxy-APIs, die mit API Manager erstellt wurden.

• Hit-Limit: Die maximale Anzahl von API-Hits pro Minute innerhalb der Umgebung zur Verwendung mit API Manager.

Andere Felder in der Tabelle enthalten automatisch ausgefüllte Statistiken zu Ihrer Umgebung, einschließlich Zählungen dieser Elemente:

• Projekte: Die Gesamtzahl der in Harmony für die Umgebung bereitgestellten Studio-Projekte und Design Studio-Projekte.

• Operationen: Die Gesamtzahl der in Harmony für die Umgebung bereitgestellten Studio-Operationen und Design Studio-Operationen.

• Verbindungen: Die Gesamtzahl der Studio-Verbindungen und Design Studio-Quellen, Ziele, Jitterbit Connect-Assistenten und Connector-Assistenten-Endpoints.

• Gehostete Endpoints: Die Gesamtzahl der Design Studio-gehosteten HTTP-Endpoints und gehosteten Web-Service-Endpoints.

• Dateiformate: Die Gesamtzahl der Studio-Schemadateien und Design Studio-Dateiformate.

• Skripte: Die Gesamtzahl der eigenständigen Studio-Skripte (als Projektkomponente) und Design Studio-Skripte (als Projektelement).

• Aktionen: Bewegen Sie den Mauszeiger über eine Zeile, um die folgenden Aktionssteuerelemente anzuzeigen:

  • Bearbeiten: Umgebung bearbeiten.

  • Löschen: Umgebung löschen.

Um die Tabelle zu sortieren, klicken Sie auf einen der Spaltenheader.

Um die Tabelle zu filtern, verwenden Sie das Suchfeld, um Filterkriterien einzugeben. Bewegen Sie den Mauszeiger über das Symbol , um ein Beispiel der Suchsyntax anzuzeigen.

Viele Spalten sind beim ersten Öffnen der Seite ausgeblendet. Um die Sichtbarkeit und Reihenfolge der Spalten zu ändern, klicken Sie auf Spalteneinstellungen. Das Seitenfenster Spalten wird geöffnet:

• Spalten filtern: Geben Sie einen Teil oder den gesamten Namen einer Spalte ein, um die Liste auf die entsprechenden Einträge zu reduzieren.

• Alle anzeigen: Alle Spalten sichtbar machen.

• Verschieben: Ziehen Sie per Drag-and-Drop, um die Position der Spalte relativ zu anderen zu ändern.

• Ausblenden: Die Spalte ist sichtbar. Klicken Sie, um sie auszublenden.

• Anzeigen: Die Spalte ist ausgeblendet. Klicken Sie, um sie anzuzeigen.

• Speichern: Speichern Sie alle Änderungen an den Spalten.

• Abbrechen und Schließen: Schließen Sie den Spalten-Editor, ohne Änderungen zu speichern.

Umgebungen hinzufügen

Für jede Organisation muss mindestens eine Umgebung definiert werden. Die Anzahl der Umgebungen, die Sie erstellen können, kann je nach Ihrem Harmony-Abonnementplan begrenzt sein. Wenn Sie zusätzliche Umgebungen benötigen, wenden Sie sich an Ihren Customer Success Manager.

Um eine Umgebung hinzuzufügen, klicken Sie auf Umgebung hinzufügen. Eine neue Zeile wird in der Tabelle angezeigt:

• Name: Der Name der neuen Umgebung (z. B. Entwicklung, Test oder Produktion).

  Hinweis

  Diese Sonderzeichen sind nicht zulässig:

  < > # % { } | \ / ^ ~ [ ] ` ; , : ? @ = &

• Klasse: Die Klasse der neuen Umgebung. Verwenden Sie das Dropdown-Menü, um eine Klasse auszuwählen, die die Umgebung am besten beschreibt. Dieses Feld dient der Berichterstellung über die Lizenznutzung von Endpoints und Agent-Gruppierung für HA (Hochverfügbarkeit). Die Klasse hat keine Auswirkungen auf die Funktionsweise einer Umgebung.

• Zugeordnete Agent-Gruppe: Die Agent-Gruppe, die Sie für die neue Umgebung verwenden möchten. Verwenden Sie das Dropdown-Menü, um eine Agent-Gruppe für die Umgebung auszuwählen. Sie können zwischen einer privaten Agent-Gruppe, die über die Seite „Agent-Gruppen" konfiguriert wird (siehe Agents), oder einer der Jitterbit Cloud Agent-Gruppen (standardmäßig verfügbar) wählen.

• URL-Präfix: Das URL-Präfix der Umgebung, das mit benutzerdefinierten, OData- und Proxy-APIs verwendet wird, die mit dem API Manager erstellt wurden. Standardmäßig wird der Name der Umgebung verwendet. Weitere Informationen finden Sie unter API-Service-URL.

  Unabhängig davon, ob Sie den Umgebungsstandard verwenden oder einen benutzerdefinierten Namen eingeben, wird das URL-Präfix zu einem integralen Bestandteil einer API-Service-URL des API Manager. Das URL-Präfix ist auf maximal 48 Zeichen begrenzt.

  Hinweis

  Diese Sonderzeichen sind nicht zulässig:

  < > # % { } | \ / ^ ~ [ ] ` ; , : ? @ = &

  Darüber hinaus sind Leerzeichen nicht zulässig.

• Hit-Limit: Die maximale Anzahl von benutzerdefinierten API-Hits pro Minute innerhalb der neuen Umgebung zur Verwendung mit dem API Manager. Wenn das Feld leer gelassen wird, gibt es keine Begrenzung für die Anzahl der API-Hits auf Umgebungsebene, und das Limit der Hits pro Minute wird standardmäßig auf das Organisationslimit für alle APIs in allen Umgebungen festgelegt (wie in Ihrer Jitterbit-Lizenzvereinbarung angegeben). Weitere Informationen finden Sie unter Ratenbegrenzung auf Profilebene in API Manager-Sicherheit.

• Beschreibung: Eine Beschreibung der neuen Umgebung.

Klicken Sie auf Speichern, um die Einstellungen zu speichern, oder auf Abbrechen, um abzubrechen.

Umgebungen bearbeiten

Um eine Umgebung nach ihrer Erstellung zu bearbeiten, zeigen Sie auf eine Zeile und klicken Sie auf die Schaltfläche Bearbeiten in der Spalte Aktion:

Die bearbeitbaren Felder sind die gleichen wie beim Hinzufügen einer Umgebung.

Umgebungen löschen

Um eine Umgebung zu entfernen, zeigen Sie auf eine Zeile und klicken Sie auf die Schaltfläche Löschen in der Spalte Aktion. Das Dialogfeld Umgebung löschen wird geöffnet:

Um das Verfahren fortzusetzen, geben Sie das Wort DELETE in das Textfeld ein und klicken Sie auf die Schaltfläche Delete.

Um das Verfahren abzubrechen, klicken Sie auf die Schaltfläche Cancel.

Rollenzugriff auf Umgebungen verwalten

Bevor Sie einer Rolle Zugriff auf eine Umgebung gewähren, müssen Sie die Rollen definieren, die Zugriff haben können. Die einzelne Mitgliedschaft für diese Rollen wird auf Benutzerebene definiert. Nach der Definition der Rollen können Sie Rollen verschiedene Zugriffsstufen auf eine Umgebung gewähren.

Zugriffsstufen auf Umgebungsebene werden in Kombination mit Rollenberechtigung verwendet, um Administratoren die Möglichkeit zu geben, zu kontrollieren, was Mitglieder einer bestimmten Rolle in einer bestimmten Umgebung tun können. Beispielsweise können Benutzer in einer Einstiegsrolle für Entwickler Read-, Execute- und Write-Zugriff in einer Entwicklungsumgebung haben, aber nur Read-Zugriff in einer Testumgebung und keinen Zugriff in einer Produktionsumgebung.

Zugriffsstufen

Beim Gewähren von Rollenzugriff auf eine Umgebung können Sie aus einer von vier kaskadierenden Zugriffsstufen auf Umgebungsebene wählen. View Logs ist die niedrigste Zugriffsstufe, gefolgt von Read, Execute und dann Write als höchste Zugriffsstufe. Wenn Sie eine höhere Zugriffsstufe wählen, werden alle niedrigeren Zugriffsstufen automatisch ausgewählt und können nicht deaktiviert werden.

Die Zugriffsstufen sind unabhängig und unterscheiden sich von den Berechtigungen, die einer Rolle zugewiesen sind. Beispiele:

• Ein Mitglied einer Rolle mit Read-Berechtigung kann möglicherweise trotzdem Änderungen in einer Umgebung vornehmen, wenn der Rolle auf Umgebungsebene Write-Zugriff gewährt wird.
• Ein Mitglied einer Rolle mit Admin-Berechtigung, das aber nur Read-Zugriff auf Umgebungsebene hat, kann Projekte in dieser Umgebung nicht bereitstellen, ausführen oder bearbeiten.
• Ein Mitglied einer Rolle mit Admin-Berechtigung, dem aber kein Umgebungszugriff gewährt wurde, kann überhaupt nicht auf die Umgebung zugreifen.

Die vier Zugriffsstufen auf Umgebungsebene werden in der folgenden Tabelle beschrieben.

API Manager Portal

Folgende zusätzliche Kriterien müssen erfüllt sein, bevor die Seite API Portal des API Manager zugänglich ist:

• Für jede API, deren Dokumentation über die Seite API Portal zugänglich wird, muss eine Organisationsrolle ausgewählt werden, der in einer Umgebung mindestens Lesezugriff gewährt wurde. Siehe die Registerkarte Benutzerrollen in der benutzerdefinierten API-Konfiguration oder der OData-API-Konfiguration.

• Die API-Dokumentation muss zuvor über die Seite Portal Manager generiert und veröffentlicht worden sein.

Zusätzlich zum Zugriff über die API Manager-Anwendung kann auf die Seite API Portal zugegriffen werden durch:

• Einen direkten Link für API-Nutzer, die sowohl die Berechtigung ApiConsumer in einer Organisation als auch mindestens Lesezugriff in einer Umgebung haben. Um den direkten Link zu erhalten, kopieren Sie entweder die URL der Seite API Portal des API Manager oder den Link zu API-Dokumentation anzeigen auf der Seite Portal Manager.

• Eine Einladung von einem Harmony-Organisationsadministrator über die Seite Benutzerverwaltung der Management Console.

Rollenzugriff auf eine Umgebung anzeigen und bearbeiten

Um den Rollenzugriff einer Umgebung anzuzeigen oder zu bearbeiten, wählen Sie eine Zeile in der Tabelle aus. Im unteren Bereich der Seite Umgebungen zeigt der Bereich Rollenzugriff alle Rollen an, denen Zugriff auf die ausgewählte Umgebung gewährt werden kann:

Um eine Zugriffsstufe auszuwählen oder zu löschen, aktivieren oder deaktivieren Sie den Umschalter für die Zugriffsstufe. Ein Bestätigungsdialog wird angezeigt.

Um eine Rolle aller Zugriffsstufen zu entziehen, klicken Sie auf die Zugriffsstufe Protokolle anzeigen einer Rolle, um die Auswahl zu deaktivieren.

Die in einer Umgebung verfügbaren Zugriffsstufen werden oben unter Zugriffsstufen ausführlich beschrieben.

Einer Rolle Zugriff auf eine Umgebung gewähren

Wählen Sie eine Umgebung aus, um den Bereich Rollenzugriff am unteren Bildschirmrand anzuzeigen:

• Suchen: Suchen Sie nach Rollen, die dem Text entsprechen. Suchvorgänge unterscheiden nicht zwischen Groß- und Kleinschreibung. Um alle Rollen anzuzeigen, löschen Sie den Text.

• Aktualisieren: Aktualisieren Sie die Rollen.

• Zurück: Wählen Sie die vorherige Umgebung in der Tabelle aus.

• Weiter: Wählen Sie die nächste Umgebung in der Tabelle aus.

• Vollbild: Vergrößern Sie den Bereich Rollenzugriff, um das Browserfenster auszufüllen.

• Vollbild beenden: Stellt die Größe des Bereichs Rollenzugriff auf normal zurück.

• Schließen: Schließt den Bereich Rollenzugriff.

Fehlerbehebung

Weitere Informationen zur Fehlerbehebung finden Sie in den folgenden Abschnitten im Harmony-Fehlerbehebungsleitfaden:

• Benutzer kann nicht auf eine Umgebung oder deren Funktionen zugreifen

• Projektvariablen werden während der Umgebungsförderung nicht übernommen

• Umgebungsänderungen werden nicht in Harmony-Anwendungen angezeigt

• Das Wechseln der Agent-Gruppe einer Umgebung schlägt mit einem Fehler zur Mindest-Agent-Version fehl