Alfabet-Objekte zuordnen

Sie können einem Objekt ein ARIS-Objekt zuordnen. Eine Mehrfachzuordnung ist nicht möglich. Standardmäßig können Sie Objekte des Objekttyps Anwendungssystemtyp Objekten der Alfabet-Klasse Anwendung zuordnen. Wenn Sie andere Objekttypen oder Alfabet-Klassen verwenden möchten, müssen Sie die Konfigurationsdateien anpassen, und zwar entsprechend der verwendeten Alfabet REST API-Version.

Voraussetzung

Die Datenbank ist mit Alfabet verbunden.

Sie können jede ARIS-Datenbank mit einem Alfabet-System verbinden. Wenn Sie den Alfabet-Import konfiguriert haben, können die Benutzer Objekte aus den verbundenen ARIS- und Alfabet-Datenbanken verwenden und zum anderen System wechseln. Um eine Datenbank mit einem Alfabet-System zu verbinden, gehen Sie wie folgt vor:

  1. Klicken Sie auf Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Datenbanken.

  2. Gewählte Elemente Markieren Sie die Datenbank und klicken Sie auf Eigenschaften Eigenschaften > Alfabet-Konfiguration. Die Leiste Alfabet-Integrationseinstellungen der Datenbank '...' wird geöffnet.

  3. Geben Sie im Feld Web-Service-URL die URL zur Alfabet-Web-Anwendung ein. Die URL wird für den Zugriff auf den Alfabet Web-Service (Alfabet RESTful API) verwendet. Die Web-Service-URL wird für den Datenaustausch benötigt.

  4. Geben Sie im Feld Benutzeroberflächen-URL die URL ein, die für den Zugriff auf die Alfabet-Benutzeroberfläche verwendet werden soll. Diese URL wird benötigt, damit Benutzer aus ARIS heraus zu Alfabet-Objekten navigieren können.

  5. Geben Sie in den Feldern Benutzername und API-Kennwort/-Token: die erforderlichen Benutzerzugangsdaten ein.

    Weitere Informationen zu Kennwort, Token und Autorisierung finden Sie im Handbuch Alfabet Interface for RESTful Web Services. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

    Warnung

    Aus Sicherheitsgründen empfehlen wir die Verwendung der Alfabet RESTful API-Version 2. Aktivieren Sie Alfabet REST API v1 (not recommended) nicht. Software AG empfiehlt dringend, so bald wie möglich auf Alfabet RESTful API-Version 2 umzusteigen.

  6. Wählen Sie die erforderlichen Synchronisierungsoptionen für Objekte und Kanten aus, deren zugeordnete Objekte oder Kanten nicht mehr in Alfabet vorhanden sind. Die ausgewählten Aktionen werden während der Datensynchronisation automatisch ausgeführt.

    Objekte

    Nichts ändern

    Zugeordnete Objekte, die nicht mehr in Alfabet vorhanden sind, bleiben unverändert in der ARIS-Datenbank bestehen.

    Mapping löschen

    Löscht Verknüpfungen aus ARIS-Objekten, deren verbundene Objekte in Alfabet nicht mehr existieren.

    Diese Aktion kann nicht rückgängig gemacht werden.

    Objekte als gelöscht kennzeichnen

    Ermittelt alle ARIS-Objekte, deren zugeordnete Alfabet-Objekte nicht mehr verfügbar sind.

    Für diese Objekte ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

    Objekte löschen

    Löscht ARIS-Objekte, deren verbundene Objekte in Alfabet nicht mehr existieren.

    Dieser Vorgang kann nicht rückgängig gemacht werden.

    Kanten

    Nichts ändern

    Wurden Kanten zwischen den Alfabet-Objekten in Alfabet geändert oder gelöscht, bleiben diese Kanten in der ARIS-Datenbank unverändert.

    Mapping löschen

    Löscht Zuordnungen aus ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

    Dieser Vorgang kann nicht rückgängig gemacht werden.

    Kanten als gelöscht kennzeichnen

    Ermittelt alle ARIS-Kanten, deren zugeordnete Alfabet-Kanten nicht mehr in Alfabet verfügbar sind.

    Für diese Kanten ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

    Kanten löschen

    Löscht ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

    Dieser Vorgang kann nicht rückgängig gemacht werden.

  7. Klicken Sie auf Verbindung testen, um die eingegebenen Werte überprüfen zu lassen.

  8. War der Test erfolgreich, klicken Sie auf Speichern, um den Dialog zu schließen.

Die Datenbank ist mit dem Alfabet-System verbunden.

Vorgehen

  1. Melden Sie sich über die Registerkarte Explorer bei der Datenbank an.

  2. Navigieren Sie zu einem verbundenen Objekt des Objekttyps Anwendungssystemtyp oder wählen Sie das Objekt in einem Modell aus.

  3. Aktivieren Sie die Funktionsleiste Inhalt.

  4. Klicken Sie auf Alfabet Alfabet > Alfabet-Objekt verbinden Alfabet-Objekt verbinden. Der Dialog Alfabet-Objekt wählen wird geöffnet. Alle Alfabet-Objekte, die den Einstellungen für individuelles Mapping entsprechen, sind aufgelistet.

    ARIS – Alfabet Interoperability Interface verfügt über eine Standardkonfiguration. Administratoren können die Konfiguration ändern, beispielsweise die ARIS-Objekttypen oder die Alfabet-Tabellen, die verwendet werden sollen.

    Die Schnittstelle muss sowohl in ARIS als auch in Alfabet konfiguriert werden. Die Konfiguration von ARIS wird in dieser Hilfe beschrieben. Die Konfiguration von Alfabet wird im Alfabet-Referenzhandbuch beschrieben. Weitere Informationen finden Sie im Alfabet-Referenzhandbuch der ARIS - Alfabet Interoperability Interface. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

    Alfabet Interoperability ist für Objekte des Typs Anwendungssystemtyp standardmäßig verfügbar. Objekte können Alfabet-Objekten der Alfabet-Objektklasse Anwendung zugeordnet werden. Wenn Sie andere ARIS-Objekttypen oder Alfabet-Objektklassen verwenden möchten, müssen Sie die Konfiguration entsprechend der verwendeten Alfabet RESTful API anpassen.

    Aus Sicherheitsgründen empfehlen wir die Verwendung der Alfabet RESTful API-Version 2.

    Alfabet REST API v2 konfigurieren

    Alfabet REST API v1 konfigurieren

  5. Wählen Sie die Alfabet-Objektklasse aus, z. B. Anwendung. Sie sehen nur die Alfabet-Objekte, für deren Verwendung Sie berechtigt sind. Wenn Sie beginnen, den Namen des Objekts in das Feld Filter einzugeben, verringert sich die Anzahl der Einträge.

    ARIS-Benutzer greifen direkt oder indirekt auf Alfabet zu. Je nach Aktion werden unterschiedliche Authentifikationsarten verwendet:

    • Das Mapping einzelner Alfabet-Objekte, der Massenimport von Objekten oder das Synchronisieren von Daten erfordern Lesezugriff über die Alfabet REST API-Version 2.

      Schnittstelle zu Alfabet über die Daten ausgetauscht werden.

      Deshalb muss RESTful API sowohl in ARIS als auch in Alfabet aktiviert und konfiguriert werden. Weitere Informationen finden Sie im Alfabet-Referenzhandbuch der ARIS - Alfabet Interoperability Interface. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

      Die URL zur Schnittstelle geben Sie beim Verbinden der ARIS-Datenbank mit Alfabet ein. Benutzer benötigen dazu Lesezugriff in Alfabet.

      Falls Sie derzeit noch die Alfabet REST API-Version 1 verwenden, wird die in der Alfabet-Import-Konfiguration angegebene Anmeldung zur Authentifizierung verwendet. Im Eigenschaftsdialog Alfabet-Integration der entsprechenden Datenbank können Sie außerdem die Benutzeranmeldedaten, die Web-Service-URL und die Benutzeroberflächen-URL festlegen. Die Zugriffsrechte der konfigurierten Anmeldung definieren somit, welche Alfabet-Objekte für ARIS-Benutzer mit Zugriff auf die Aktionen sichtbar sind.

      Sie können jede ARIS-Datenbank mit einem Alfabet-System verbinden. Wenn Sie den Alfabet-Import konfiguriert haben, können die Benutzer Objekte aus den verbundenen ARIS- und Alfabet-Datenbanken verwenden und zum anderen System wechseln. Um eine Datenbank mit einem Alfabet-System zu verbinden, gehen Sie wie folgt vor:

      1. Klicken Sie auf Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Datenbanken.

      2. Gewählte Elemente Markieren Sie die Datenbank und klicken Sie auf Eigenschaften Eigenschaften > Alfabet-Konfiguration. Die Leiste Alfabet-Integrationseinstellungen der Datenbank '...' wird geöffnet.

      3. Geben Sie im Feld Web-Service-URL die URL zur Alfabet-Web-Anwendung ein. Die URL wird für den Zugriff auf den Alfabet Web-Service (Alfabet RESTful API) verwendet. Die Web-Service-URL wird für den Datenaustausch benötigt.

      4. Geben Sie im Feld Benutzeroberflächen-URL die URL ein, die für den Zugriff auf die Alfabet-Benutzeroberfläche verwendet werden soll. Diese URL wird benötigt, damit Benutzer aus ARIS heraus zu Alfabet-Objekten navigieren können.

      5. Geben Sie in den Feldern Benutzername und API-Kennwort/-Token: die erforderlichen Benutzerzugangsdaten ein.

        Weitere Informationen zu Kennwort, Token und Autorisierung finden Sie im Handbuch Alfabet Interface for RESTful Web Services. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

        Warnung

        Aus Sicherheitsgründen empfehlen wir die Verwendung der Alfabet RESTful API-Version 2. Aktivieren Sie Alfabet REST API v1 (not recommended) nicht. Software AG empfiehlt dringend, so bald wie möglich auf Alfabet RESTful API-Version 2 umzusteigen.

      6. Wählen Sie die erforderlichen Synchronisierungsoptionen für Objekte und Kanten aus, deren zugeordnete Objekte oder Kanten nicht mehr in Alfabet vorhanden sind. Die ausgewählten Aktionen werden während der Datensynchronisation automatisch ausgeführt.

        Objekte

        Nichts ändern

        Zugeordnete Objekte, die nicht mehr in Alfabet vorhanden sind, bleiben unverändert in der ARIS-Datenbank bestehen.

        Mapping löschen

        Löscht Verknüpfungen aus ARIS-Objekten, deren verbundene Objekte in Alfabet nicht mehr existieren.

        Diese Aktion kann nicht rückgängig gemacht werden.

        Objekte als gelöscht kennzeichnen

        Ermittelt alle ARIS-Objekte, deren zugeordnete Alfabet-Objekte nicht mehr verfügbar sind.

        Für diese Objekte ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

        Objekte löschen

        Löscht ARIS-Objekte, deren verbundene Objekte in Alfabet nicht mehr existieren.

        Dieser Vorgang kann nicht rückgängig gemacht werden.

        Kanten

        Nichts ändern

        Wurden Kanten zwischen den Alfabet-Objekten in Alfabet geändert oder gelöscht, bleiben diese Kanten in der ARIS-Datenbank unverändert.

        Mapping löschen

        Löscht Zuordnungen aus ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

        Dieser Vorgang kann nicht rückgängig gemacht werden.

        Kanten als gelöscht kennzeichnen

        Ermittelt alle ARIS-Kanten, deren zugeordnete Alfabet-Kanten nicht mehr in Alfabet verfügbar sind.

        Für diese Kanten ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

        Kanten löschen

        Löscht ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

        Dieser Vorgang kann nicht rückgängig gemacht werden.

      7. Klicken Sie auf Verbindung testen, um die eingegebenen Werte überprüfen zu lassen.

      8. War der Test erfolgreich, klicken Sie auf Speichern, um den Dialog zu schließen.

      Die Datenbank ist mit dem Alfabet-System verbunden.

      Warnung

      Beim Zugriff auf das Alfabet RESTful API werden die Anmeldedaten mit dem HTTP-Header übermittelt. Stellen Sie deshalb sicher, dass die Übertragung verschlüsselt erfolgt.

    • Zum Öffnen des Alfabet-Objekts benötigen Benutzer Lesezugriff im Alfabet Web User Interface. Benutzer müssen sich bei Alfabet selbst anmelden.

    • Zum Anlegen von Alfabet-Objekten benötigen Benutzer Schreibzugriff im Alfabet Web User Interface. Benutzer müssen sich bei Alfabet selbst anmelden.

  6. Klicken Sie auf Aktualisieren Aktualisieren, wenn Objekte in der Liste fehlen. Wenn ein Objekt nicht verfügbar ist, können Sie es in Alfabet anlegen.

  7. Klicken Sie doppelt auf das Alfabet-Objekt, das Sie dem ARIS-Objekt zuordnen möchten.

    Die in der Konfigurationsdatei definierten Attribute werden vom Alfabet-Objekt übernommen. Für den Typ Anwendungssystemtyp sind das standardmäßig die Attribute:

    Name

    Das Attribut Name wird beim Austausch von Daten standardmäßig überschrieben.

    Wenn Sie ein ARIS-Objekt mit einem Alfabet-Objekt verbinden, wird zukünftig der Name des Alfabet-Objekts verwendet. Der Objektname wird in ARIS überschrieben.

    Beschreibung/Definition

    Das Attribut Beschreibung/Definition wird beim Austausch von Daten standardmäßig überschrieben.

    Wenn Sie ein ARIS-Objekt mit einem Alfabet-Objekt verbinden, wird zukünftig die Beschreibung des Alfabet-Objekts verwendet. Das Attribut Beschreibung/Definition wird in ARIS überschrieben.

    Release-Stand

    Das Attribut Release wird beim Austausch von Daten standardmäßig überschrieben.

    Wenn Sie ein ARIS-Objekt mit einem Alfabet-Objekt verbinden, wird die Alfabet-Eigenschaft Version aktualisiert.

Das Alfabet-Objekt ist mit dem ARIS-Objekt verbunden. Für das ARIS-Objekt wird jetzt der Name des Alfabet-Objekts verwendet. In der Attributtypgruppe Alfabet wurden für dieses Objekt weitere Attribute eingetragen.

Die Zuordnung wird beibehalten, bis die Objektzuordnung aufgehoben wird. Administratoren können alle Zuordnungen gleichzeitig löschen.