Deep Link
Ein Deep Link ist eine URL, mit deren Hilfe der Dialogablauf mit dem Deep Link direkt in einem Webbrowser geöffnet werden kann, ohne die im Portal angebotenen Navigationsfunktionen (wie das Dialogstartmenü) verwenden zu müssen. Über Deep Links können Sie prinzipiell alle Dialogabläufe direkt starten. Im Portal werden Deep Links vom System für Aufgaben generiert und systemintern von der Aufgabenverwaltung genutzt, um einen direkten Einstieg zu bestehenden Aufgaben per E-Mail zu gewährleisten (siehe nachfolgendes Muster).
http:///Schleupen/Portal/–/DialogFlow/Open/{DialogFlowID}
bzw.
https:///Schleupen/Portal/–/DialogFlow/Open/{DialogFlowID}
In den Aufgaben müssen die Deep Links zum Öffnen des jeweiligen Dialogs im Webbrowser lediglich angeklickt werden.
Wenn das Portal mit dem https-Übertragungsprotokoll ausgeführt wird, wird der Deep Link auch so aufgebaut und beginnt demnach mit https. Bei der Generierung der E-Mail für eine Aufgabe wird automatisch das korrekte Protokoll gewählt.
http://gpsschleupencs33/Schleupen/Portal/Test-Mandant-9999/DialogFlow/Open/Schleupen.CS.PI.BPE.Tasks.TaskIdent_3.1
bzw.
https://gpsschleupencs33/Schleupen/Portal/Test-Mandant-9999/DialogFlow/Open/Schleupen.CS.PI.BPE.Tasks.TaskIdent_3.1
PI >= 3.3 (Systemstruktur)
Für das Öffnen einer Systemstruktur im Portal (CS. 3.0 – Dialogschritt bzw. Dialogablauf) wird der Teil für die Sitzungsinformationen (Sessioninfo = <ViewName>–) im Deep Link aus folgenden Teilen aufgebaut:
ViewName – Name der Systemstruktursicht
TypeName – Typ des für die Anmeldung ausgewählten Systemstrukturelements
Name – Name des für die Anmeldung ausgewählten Systemstrukturelements
Informationen zum Verwendungszweck und zum möglichen Anmeldebereich sind in der URL enthalten.
http://gpsschleupencs33/Schleupen/Portal/Standard-Mandant-9999-Produktiv-Gesamtes%20System
bzw.
https://gpsschleupencs33/Schleupen/Portal/Standard-Mandant-9999-Produktiv-Gesamtes%20System
Parameter
Über die URL können auch Parameter an den DialogFlow übergeben werden. Dies wird in der Regel von einem Mitarbeiter der Schleupen SE ausgeführt, der dazu eine Schnittstelle (Interface) definiert. Die URL-Parameter werden 1:1 gemäß der Eigenschaften (Properties) des Input-Modells abgebildet. Folgende Parameter werden auf der oberen Ebene des Input-Modells unterstützt:
Guid
string
int
DateTime
Enums
decimal
bool
Null kann jeweils erreicht werden, indem der Parameter nicht in der URL angegeben wird.
Nicht übergebene Werte werden ignoriert und mit ihrem .NET-Standardwert initialisiert. Die Parameter werden über GET-Array an den Dialogablauf übergeben: ?v[key]=value&v[key2]=value2 (siehe folgendes Muster):
/Schleupen/Portal/–/DialogFlow/Open/{DialogFlowID}?v[key]=value&v[key2]=value2