search

Hyperlinks aus WOWIPORT zu externen Anwendungen integrieren

WOWIPORT bietet Ihnen die Möglichkeit, Links zu Ihren Anwendungen direkt in WOWIPORT zu hinterlegen.

Die externen Sprungpunkte können sowohl statisch, unter Verwendung von "Id" und "IdNum", als auch variabel unter Verwendung einer API angelegt werden.

hashtag
Anlage einer statischen URL

hashtag
Erforderliche Benutzerrechte

Für die Anlage und Verwaltung von externen Sprungpunkten benötigt der Benutzer die Berechtigungen "Externe Sprungpunkte" und "Gruppe - Externe Anwendungen" aus dem Bereich "Administration". Zudem kann es notwendig sein, die Rechte für die Erstellung von Webhooks zu vergeben, da diese in derselben Maske bearbeitet werden.

hashtag
Anlage eines Sprungpunktes

Statische Sprungpunkte können auf Gruppenebene angelegt werden. Die Einstellung erfolgt in der "Benutzerverwaltung" unter "Gruppen".

In der gewünschten Gruppe kann der Sprungpunkt im Tab "Externe Anwendungen" erfasst werden.

Der Name des Sprungpunktes wird später in der Kopfzeile der gewählten Entität angezeigt. Als Platzhalter können "#Id#" und "#IdNum#" verwendet werden. Bitte beachten Sie, dass die Platzhalter case sensitive sind und dass die "IdNum" mit den vom Kunden definierten Sonderzeichen übermittelt wird. Dies kann in Einzelfällen zu Komplikationen führen.

Derzeit stellen wir die Funktion für folgende Entitäten bereit:

  • Auftrag

  • Darlehen

  • Fremdverwaltungsvertrag

  • Gebäude

  • Grundstück

  • Mitgliedschaft

  • Nutzungsvertrag

  • Nutzungseinheit

  • Person

  • Wirtschaftseinheit

  • Kreditoren

Wurde der Sprungpunkt gespeichert, kann dieser von allen Nutzern unter der Gruppe im Infobereich jener Objekte aufgerufen werden, für deren Entität der Sprungpunkt angelegt wurde.

hashtag
Anlage von externen Sprungpunkten per API

chevron-rightHinweise zur Funktionhashtag

Durch die API können keine Konfigurationen für neue externe Links angelegt werden. Dieses Feature wurde, aus Sicherheitsgründen, in der Benutzeroberfläche von WOWIPORT belassen. Wurde eine Konfiguration angelegt, kann diese durch den im API-Key hinterlegten Benutzer abgefragt werden. Für eine Konfiguration können dann in der hinterlegten Entität Links für bestimmte Objekte der Entität angelegt werden. Bitte beachten Sie, dass diese Links nur über die API änderbar sind. Der Partneranwendung obliegt die Pflicht, diese Links aktuell zu halten und ggf. zu löschen.

hashtag
Einrichtung der Sprungpunktkonfiguration

Im API-Key können im Tab "Externe Sprungpunkte" neue externe Sprungpunktkonfigurationen hinzugefügt werden.

Wird eine neue Konfiguration angelegt, muss ein Name vergeben werden, welcher dann in der Entität angezeigt wird. Hinter diesem Namen liegt der individuelle Link in die Partneranwendung. Zudem muss der Systemzweck und die Entität angegeben werden. Der Systemzweck wird üblicherweise "Echt" oder "Test" lauten. Die Entität bestimmt, in welchem Bereich von WOWIPORT der Sprungpunkt angezeigt werden kann.

Derzeit stellen wir die Funktion für folgende Entitäten bereit:

  • Auftrag

  • Darlehen

  • Fremdverwaltungsvertrag

  • Gebäude

  • Grundstück

  • Mitgliedschaft

  • Nutzungsvertrag

  • Nutzungseinheit

  • Person

  • Wirtschaftseinheit

Bereits angelegte Sprungpunkte werden unterhalb der Einstellungen in einer Tabelle angezeigt, können jedoch nicht bearbeitet werden.

hashtag
Externe Sprungpunkte Konfiguration abfragen

Dies sind die Konfigurationen, für welche externe Links von Ihrem User aus angelegt werden können.

hashtag
Version 1.2

Autorisierungen
OAuth2passwordErforderlich

Use username and password.

Token URL:
Abfrageparameter
apiKeystringOptional
limitinteger · int32OptionalExample: 20
offsetinteger · int32Optional
idinteger · int32Optional
externalLinkEntityIdinteger · int32Optional
namestringOptional
showNullValuesbooleanOptionalDefault: false
Antworten
chevron-right
200

OK

get
/openwowi/v1.2/ExternalLink/ExternalLink

hashtag
Externe Sprungpunkte abfragen

Dies sind die tatsächlich mit den Objekten der Entität verbundenen Links in die Partneranwendung.

hashtag
Version 1.2

Autorisierungen
OAuth2passwordErforderlich

Use username and password.

Token URL:
Abfrageparameter
apiKeystringOptional
limitinteger · int32OptionalExample: 20
offsetinteger · int32Optional
idinteger · int32Optional
entityIdinteger · int32Optional
configurationIdinteger · int32Optional
configurationNamestringOptional
configurationEntityIdinteger · int32Optional
showNullValuesbooleanOptionalDefault: false
Antworten
chevron-right
200

OK

get
/openwowi/v1.2/ExternalLink/EntityLink

hashtag
Externe Sprungpunkte anlegen, ändern und löschen

Die EntityId stellt die Objekt-ID dar, mit welcher der Link verbunden werden soll. Die Entität selbst wird in der Konfiguration definiert.

hashtag
Version 1.2

post
Autorisierungen
OAuth2passwordErforderlich

Use username and password.

Token URL:
Abfrageparameter
apiKeystringOptional
Rumpf
ExternalLinkConfigurationIdinteger · int32Optional
Urlstring · nullfähigOptional
EntityIdinteger · int32Optional
CustomLabelstring · nullfähigOptional
Antworten
post
/openwowi/v1.2/ExternalLink/EntityLink
Autorisierungen
OAuth2passwordErforderlich

Use username and password.

Token URL:
Pfadparameter
entityLinkIdinteger · int32Erforderlich
Abfrageparameter
apiKeystringOptional
Rumpf
Urlstring · nullfähigOptional
EntityIdinteger · int32Optional
CustomLabelstring · nullfähigOptional
Antworten
chevron-right
200

OK

put
/openwowi/v1.2/ExternalLink/EntityLink/{entityLinkId}
Autorisierungen
OAuth2passwordErforderlich

Use username and password.

Token URL:
Pfadparameter
entityLinkIdinteger · int32Erforderlich
Abfrageparameter
apiKeystringOptional
Antworten
chevron-right
200

OK

delete
/openwowi/v1.2/ExternalLink/EntityLink/{entityLinkId}

hashtag
Kataloge

hashtag
Verfügbare Entitäten

hashtag
Version 1.2

get
Autorisierungen
OAuth2passwordErforderlich

Use username and password.

Token URL:
Abfrageparameter
apiKeystringOptional
Antworten
chevron-right
200

OK

get
/openwowi/v1.2/ExternalLinkCatalog/ExternalLinkEntity

Zuletzt aktualisiert