XML-Element user

user

Steuert die Anmeldung bei der Alfabet RESTful API für den Datenaustausch. Es müssen Benutzername, Token und Zugriffsmodus angegeben werden. Im Eigenschaftsdialog Alfabet-Integration der entsprechenden Datenbank können Sie außerdem die Benutzeranmeldedaten, die Web-Service-URL und die Benutzeroberflächen-URL festlegen.

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.

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.

    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.

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.

Standardmäßig ist ein Beispieltoken gesetzt. Der Benutzername ist nicht eingetragen. Bei diesem anonymen Zugriff haben standardmäßig alle Benutzer Lese- und Schreibzugriff auf alle Alfabet-Objekte.

Tragen Sie den Schlüssel des Alfabet-Servers als Wert für den Tag token ein. Dieser Wert ist abhängig vom Benutzernamen. Tragen Sie einen Benutzernamen als Wert für den Tag name ein. Damit hat nur dieser Benutzer Zugriff aus die Alfabet-Objekte, für die er berechtigt ist.

Weitere Informationen zum Token und der 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.

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.