Ersetzen des Inhalts der Perspektive "Anzeige" in der Detailansicht
Freigegeben: Erweiterungspunkt
Sie können den Inhalt der Perspektive Anzeige zur Detailansicht zu einem Element (z.B. Dokument oder Akte) ersetzen, damit Sie unter bestimmten Bedingungen eine eigene Vorschau darstellen können.
Die App, die eine solche Erweiterung bereitstellen möchte, muss unter der Linkrelation dmsobjectextensions
eine HTTP-Antwort im JSON-Format zurückgeben, in der zu jedem Erweiterungspunkt der Anzeige-Perspektive folgende Informationen bereitgestellt werden:
Kontext des Erweiterungspunkts:
DmsObjectDetailsPreview
Aktivierungsbedingungen zum Anzeigen Ihrer Vorschau.
Die URL für die Vorschau, die angezeigt werden soll, wenn der Anwender die Perspektive Anzeige der Detailansicht öffnet und Ihre definierten Aktivierungsbedingungen zutreffen. Geben Sie einen relativen Link an, der per
HTTP GET
von der DMSApp aufgerufen wird.
Jede Kontextaktion kann auch per HTTP POST
-Anforderung für die URL /dms/extensions
in der DMSApp erstellt werden. Die Anforderung darf nur von einem Benutzer mit Administrationsrechten gestellt werden. Wenn die Antwort der Anforderung erfolgreich ist, wird die Erweiterung in der DMSApp gespeichert und Sie erhalten eine Location
-URL im Header der Antwort. Über die Location
-URL kann ein Benutzer mit Administrationsrechten die Erweiterung in der DMSApp auch wieder löschen. Dazu muss eine HTTP DELETE
-Anforderung an den Wert der Location
-URL gesendet werden.
Beispiel
Das Beispiel zeigt, wie Sie die HTTP-Antwort der Linkrelation dmsobjectextensions
gestalten, um eine Erweiterung zum Erweiterungspunkt DmsObjectDetailsPreview
hinzuzufügen. Je Erweiterung definieren Sie verschiedene Eigenschaften.
{ "extensions": [ { "id": "myapp.viewer", "activationConditions": [{ "propertyId": "dmsobject.mainblob.content_type", "operator": "or", "values": [ "text/plain", "application/pdf" ] }], "context": "DmsObjectDetailsPreview", "uriTemplate": "/myapp/preview?layer0={dmsobject.mainblob.content_url}" }] }
Eigenschaft | Eigenschaften eines enthaltenen Objekts | Beschreibung |
---|---|---|
| - | Legt den eindeutigen technischen Namen fest, der verwendet wird, um die Erweiterung von anderen Erweiterungen zu unterscheiden. |
| Pro Erweiterung teilt die Anwendung mit, unter welchen Aktivierungsbedingungen die Erweiterung der Anzeige-Perspektive angezeigt werden soll. Diese Aktivierungsbedingungen werden vorab von der Anwendung mitgeteilt. Würden die Aktivierungsbedingungen nicht vorab mitgeteilt, müsste die DMSApp zu einem späteren Zeitpunkt, an dem der Anwender sich ein Element ansieht, andere Apps mit einer Netzwerkanforderung (Request) abfragen. Die Wartezeit für den Anwender würde dann stark steigen, wenn eine App nur verzögert auf diese Anforderung reagiert. Eine Erweiterung wird dann angezeigt, wenn alle Einzelbedingungen zutreffen. Enthält die Liste der Aktivierungsbedingungen keinen Eintrag, ist die Erweiterung generell aktiv. Sie geben die Aktivierungsbedingungen als Array an. | |
| Gibt die ID der Eigenschaft an, die für die Aktivierungsbedingung geprüft wird. Mögliche Werte werden weiter unten beschrieben. | |
| Der Operator gibt an, auf welche Art und Weise eine Einzelbedingung ausgewertet wird. Folgender Operator steht zur Verfügung: or: Eine notOr: Eine | |
| Gibt die Werte in Form eines Arrays an, die mit dem Wert der | |
| - | Gibt den gewünschten Erweiterungspunkt an, zu dem die Erweiterung hinzugefügt werden soll. Geben Sie für Erweiterungen der Anzeige-Perspektive der Detailansicht folgenden Wert an:
|
| - | Sie definieren in der Eigenschaft AnmerkungDas Verwenden eines Platzhalters im Host-Teil der URL ist aus Sicherheitsgründen nicht erlaubt und führt zu einem Fehler. |
Die nachfolgenden Werte können Sie bei der Definition von Erweiterungen, die den Inhalt der Anzeige-Perspektive ersetzen, in folgenden Bereichen nutzen:
Definieren von Aktivierungsbedingungen für die Eigenschaft
propertyId
Festlegen von Platzhaltern in der Eigenschaft
uriTemplate
Thema | Wert | Beschreibung |
---|---|---|
Repository |
| ID des Repositorys, wie in der d.ecs repo-App angegeben. Die Repository-ID finden Sie in der Detailsektion des Features d.3 Repositorys ( Im Kapitel Ermitteln eines Repositorys können Sie nachlesen, wie Sie die ID zu einem Repository programmatisch ermitteln. |
Benutzer |
| Aktivierungsbedingung: ID einer d.3-Benutzergruppe (maximal acht Zeichen), in der der aktuell angemeldete Anwender Mitglied ist. Platzhalter |
| Aktivierungsbedingung: GUID einer Benutzergruppe der identity provider-App, in der der aktuell angemeldete Anwender Mitglied ist. Platzhalter | |
Eigenschaften zum Element |
| Bearbeiter des Elements. |
| Besitzer des Elements. | |
| Dateiname des Elements. | |
| Dateityp des Elements. | |
| Dokumentnummer des Elements. | |
| Erstellungsdatum des Elements. | |
| Dateigröße des Elements. | |
| Dokumentstatus des Elements. Mögliche Werte:
| |
| Variantennummer des Elements. | |
| Zugriffsdatum des Elements. | |
| Bemerkungen zum Element. | |
| Änderungsdatum des Elements. | |
| Titel des Elements. | |
| ID der Kategorie des Elements. | |
| UUID der Kategorie des Elements. | |
| Farbmarkierung des Elements. | |
| Aktivierungsbedingung: ID einer Dokumentklasse des Elements. Platzhalter | |
| Dokument ID des Elements. | |
| Eindeutige ID der Anzeigeversion seitens der DMSApp. | |
| Eindeutige ID der aktuellen Version seitens der DMSApp. | |
| Typ des Elements. Mögliche Werte:
| |
| Geben Sie für den Platzhalter Handelt es sich bei der d.3-Eigenschaft um eine Mehrfacheigenschaft, wird der Platzhalter durch den ersten oder den ersten gefüllten Wert der Eigenschaft ersetzt (abhängig von der d.3-Repositorykonfiguration). Sind mehrere Werte für die Mehrfacheigenschaft vorhanden, wird der zurückgegebene Wert um drei Punkte (...) ergänzt. | |
| Geben Sie für den Platzhalter AnmerkungWir empfehlen Ihnen dringend, die ID der erweiterten Eigenschaft ( Handelt es sich bei der d.3-Eigenschaft um eine Mehrfacheigenschaft, wird der Platzhalter durch den ersten oder den ersten gefüllten Wert der Eigenschaft ersetzt (abhängig von der d.3-Repositorykonfiguration). Sind mehrere Werte für die Mehrfacheigenschaft vorhanden, wird der zurückgegebene Wert um drei Punkte (...) ergänzt. | |
| Relative URL des Elements. | |
Originaldatei des Elements |
| MIME-Typ der Originaldatei (z.B. |
| (Veraltet) Absolute URL der Originaldatei. Wenn der Benutzer keine Berechtigung hat, das Dokument zu exportieren, dann ist dieser Parameter leer. | |
| Relative URL der Originaldatei. Wenn der Benutzer keine Berechtigung hat, das Dokument zu exportieren, dann ist dieser Parameter leer. | |
| ID der Originaldatei, falls der Anwender das Recht besitzt, die Originaldatei zu exportieren. | |
Abhängige Dateien zum Element |
| Liste der IDs der abhängigen Dateien, falls der Anwender das Recht besitzt, die abhängige Datei zu exportieren. |
| (Veraltet) Absolute URL der abhängigen Datei mit der ID aus | |
| Relative URL der abhängigen Datei mit der ID aus |