Zum Hauptinhalt springen
Version: 11.0

Modelle teilen oder einbetten

Dieses Kapitel bietet einen Überblick über die wichtigsten Funktionen zum Teilen von Modellen mit Benutzern, die nicht mit ADONIS NP arbeiten, oder zum Einbetten von Modellen in anderen Anwendungen.

URL generieren​

Sie haben die Möglichkeit, eine URL für ein Modell, Objekt oder eine Sicht zu generieren. Auf diese Weise können Sie z.B. via E-Mail eine Sicht mit Kollegen teilen oder ein bestimmtes Modell zur Liste der Lesezeichen bzw. Favoriten in Ihrem Browser hinzufügen.

So generieren Sie eine URL:

  1. Öffnen Sie das Modell oder die Sicht, oder öffnen Sie das Notebook des Objekts.

  2. Klicken Sie auf die Teilen Schaltfläche , und klicken Sie dann auf Link teilen.

  3. Führen Sie dann einen der folgenden Schritte aus:

    • Fügen Sie die URL dort ein, wo Sie sie gerade brauchen. Je nach Browser wird die URL entweder direkt in die Zwischenablage kopiert oder Sie müssen sie manuell kopieren.

    • Teilen Sie die URL per E-Mail. Klicken Sie auf die Teilen Schaltfläche, um den Standard-Mailclient mit einem vordefinierten Betreff und Nachrichtentext zu öffnen.

Hinweis

Wenn ein Anwender das Organisationsportal anonym (= ohne Angabe von Benutzerdaten) verwendet und eine URL generiert, kann jeder auf den Inhalt zugreifen. Ansonsten setzt der Aufruf der URL eine Anmeldung in ADONIS NP voraus.

Die generierte URL enthält die aktuelle Sprache als Parameter. Beim Aufruf der URL wird der Inhalt in der gleichen Sprache geöffnet, in der die URL erstellt wurde.

Beispiel

Sie arbeiten auf Deutsch und haben eine URL für ein Modell generiert. Die generierte URL zeigt automatisch auf das Modell in deutscher Sprache.

Wenn ein Freigabeworkflow aktiviert ist, zeigen generierte URLs immer auf die neueste freigegebene Version eines Modells oder Objekts.

Beispiel

Sie haben eine URL für eine Prozesslandkarte (Versionsnummer "1.00") generiert. Eine neue Version dieser Prozesslandkarte wird freigegeben. Die generierte URL zeigt automatisch auf das neue Modell (Versionsnummer "2.00") statt auf die archivierte Vorgängerversion.

Sonderfall: URL auf ein Anwendungsszenario erzeugen

Wenn Sie eine URL auf ein Anwendungsszenario öffnen, überspringen Sie die Startseite und greifen direkt auf das ausgewählte Szenario zu. Um so eine URL zu erzeugen:

  • "Gestalten & Dokumentieren"

    Fügen Sie "?scenarioID=anp_scenario_1_design_and_document" zur URL hinzu, unter der ADONIS NP erreichbar ist.

  • "Steuern & Freigeben"

    Fügen Sie "?scenarioID=anp_scenario_3_control_and_release" zur URL hinzu, unter der ADONIS NP erreichbar ist.

  • "Lesen & Entdecken"

    Fügen Sie "?scenarioID=anp_scenario_2_read_and_explore" zur URL hinzu, unter der ADONIS NP erreichbar ist.

Beispiel

ADONIS NP ist unter folgender URL erreichbar: http://server:8000/ADONISNP11_0. Sie möchten eine URL erzeugen, mit der Sie direkt auf das "Gestalten & Dokumentieren" Szenario zugreifen können.

Die URL sollte folgendermaßen aussehen:

http://server:8000/ADONISNP11_0?scenarioID=anp_scenario_1_design_and_document

Sonderfall: Barrierefreien Modus für das Organisationsportal einschalten

Der barrierefreie Modus ermöglicht Benutzern mit Einschränkungen, das Organisationsportal effektiver zu nutzen. Wenn dieser Modus aktiviert ist, wird die Textansicht als Standardeditor für Modelle festgelegt. Alle Modelltypen ohne Konfiguration für die Textansicht werden im tabellarischen Editor geöffnet.

Um eine URL zu erzeugen, die das Organisationsportal im barrierefreien Modus öffnet:

  • Fügen Sie "&accessibility=true" zu der benutzerspezifischen URL hinzu, unter der das Organisationsportal erreichbar ist.
Beispiel

Mit der benutzerspezifischen URL http://server:8000/ADONISNP11_0?reader=Reader kann ein Anwender die Anmeldung überspringen und direkt das Organisationsportal betreten. Sie möchten diese URL so modifizieren, dass der barrierefreie Modus eingeschaltet ist.

Die URL sollte folgendermaßen aussehen:

http://server:8000/ADONISNP11_0?reader=Reader&accessibility=true

ADONIS NP als iFrame einbetten​

Mit dem HTML-Element iFrame können Sie ADONIS NP in eine Website einbetten. Das kann z.B. ein Blog sein oder die Website Ihrer Organisation. Auch die Einbettung in eine andere Webapplikation ist so möglich.

ADONIS NP in eine Webseite einbetten

  • Fügen Sie die URL, unter der ADONIS NP erreichbar ist, in folgendem HTML-Code ein:

    <iframe src="URL" width="800" height="800"/>

  • Fügen Sie den Code auf der Webseite ein, auf der Sie ADONIS NP anzeigen möchten. Passen Sie die Breite (width) und Höhe (height) an Ihre Webseite an.

Bestimmtes Modell in eine Webseite einbetten

  • Generieren Sie eine URL auf das Modell, das Sie in Ihre Webseite einbetten möchten.

  • Fügen Sie die Modell-URL in folgendem HTML-Code ein:

    <iframe src="MODELL-URL" width="800" height="800"/>

  • Fügen Sie den Code auf der Webseite ein, auf der Sie das Modell anzeigen möchten. Passen Sie die Breite (width) und Höhe (height) an Ihre Webseite an.

Zusätzliche Optionen

Wenn Sie ADONIS NP in eine Website einbetten, können Sie das Aussehen und Verhalten des iFrames anpassen, indem Sie verschiedene URL-Parameter hinzufügen:

  • Sprache festlegen

    Um die Sprache festzulegen, in der ADONIS NP angezeigt wird, fügen Sie "&lang=<Sprachcode>" zur URL hinzu. Je nach Produktkonfiguration sind mögliche Sprachcodes z.B. "de" für Deutsch und "en" für Englisch. Dieser Parameter ist standardmäßig bereits in einer Modell-URL enthalten.

Übergeben mehrerer Parameter

Nur der erste Parameter wird von der URL durch ein Fragezeichen (?) getrennt. Um mehrere Parameter an dieselbe URL zu übergeben, übergeben Sie alle Parameter nach dem ersten Parameter mit einem kaufmännischen Und (&).

Einbetten von ADONIS NP als iFrame aktivieren

In ADONIS NP ist die Anzeige des Web-Clients innerhalb eines Frames aus Sicherheitsgründen standardmäßig nicht zulässig. Der iFrame bleibt dann leer. Um das Einbetten von ADONIS NP als iFrame zu aktivieren:

  1. Öffnen Sie die Datei ADONISNP11_0.war im Ordner “<Tomcat Installation>/webapps“ mit einer Komprimierungs-Software. Bearbeiten Sie die Datei adoxx_web.properties im Archiv.

  2. Setzen Sie den Wert des Parameters security.allowframedisplay auf "true". Speichern Sie danach die Änderungen.

Der Apache Tomcat Web-Server muss neu gestartet werden, damit die Änderungen wirksam werden.

Über eine REST API auf ADONIS NP zugreifen​

ADONIS NP bietet eine REST-Schnittstelle an. Über diese Schnittstelle wird der Zugriff auf Daten in ADONIS NP aus anderen Anwendungen ermöglicht.

Sie haben die Möglichkeit, über die in ADONIS NP beinhaltete REST API aus einer anderen Anwendung heraus z.B. eine Modellgrafik oder andere Modelldaten anzuzeigen.

Hinweis

Im Kapitel REST API im Administrationshandbuch erfahren Sie, wie Sie den Zugriff auf die REST API aktivieren.

Informationen zur Verwendung der REST API finden Sie im ADOxx Developer Portal.

Wenn Sie Fragen haben, wenden Sie sich bitte an Ihren ADONIS NP-Kundenbetreuer.