D-velop:d3one App Connect Writer
Die Komponente D-velop:d3one App Connect Writer dient zur Anbindung eines D-velop d.3-Archivs über die D3One-Schnittstelle.
Sie stellt die technische Integrationskomponente für die Kommunikation zwischen intracon:bk und dem D3One App-Connect-Endpunkt dar.
Über diese Schnittstelle ruft D-velop regelmäßig Konfigurations- und Metadateninformationen ab, die für die Nutzung der Archivschnittstelle erforderlich sind.
Die Komponente wird in der Regel in zwei getrennten Prozessen eingesetzt:
- Aufrufprozess – stellt Konfigurationsinformationen und Metadaten für die D3One-Schnittstelle bereit
- Datenprozess – verarbeitet bzw. übergibt Archivdaten an das D3-Archiv
Der Aufrufprozess liefert dabei die notwendigen Konfigurationsparameter, Metadaten und Endpunktinformationen, über die der Datenprozess später aufgerufen werden kann.
Konfigurationsparameter
Schnittstellenkonfiguration
| Feld | Beschreibung |
|---|---|
| Schnittstellen Wert | Tabelle zur Definition aller mit D-velop abgestimmten Schlüssel für die Nutzung der D3One-Archiv-Schnittstelle. Die Namensvergabe sowie die Klassifizierung als Kategorie erfolgen gemäß der D3One-Schnittstellenbeschreibung und dem verwendeten Aktenplan. |
| App Name | Mit D-velop abgestimmter Identifikationswert der Anwendung, die über die D3One-Schnittstelle angesprochen wird. Dieser Wert dient zur eindeutigen Zuordnung der aufrufenden Anwendung. |
Prozess- und Endpunktdefinition
| Feld | Beschreibung |
|---|---|
| HRef | Mit D-velop abgestimmter Alias bzw. Endpunktpfad des Prozesses. Dieser Wert wird von D3One verwendet, um den Datenprozess aufzurufen. Ist dieses Feld konfiguriert, muss zusätzlich Ist Link Writer aktiviert werden. |
| Id | Repository-ID bzw. mit D-velop abgestimmte Route zur Identifikation des Zielarchivs innerhalb der D3One-Integration. |
| Ist Link Writer | Kennzeichnet den Prozess als Link-Endpunkt für die D3One-Schnittstelle. Wird dieser Parameter aktiviert, muss das Feld HRef definiert sein. |
Ausgabe
| Feld | Beschreibung |
|---|---|
| Output | Definiert den Namen des Objekts im Prozesskontext, in dem die Antwort des Webservice-Aufrufs gespeichert wird. Dieses Objekt enthält die generierten Konfigurations- bzw. Metadateninformationen für die D3One-Schnittstelle. |
Konfiguration „Schnittstellen Wert“
Die Konfiguration der Schnittstellenwerte erfolgt tabellarisch und ermöglicht die Definition von Metadatenfeldern gemäß der D3One-Spezifikation.
| Feld | Beschreibung |
|---|---|
| Ist Kategorie | Kennzeichnet, ob der definierte Wert als Kategorie gemäß der D3One-Spezifikation übergeben wird. Kategorien dienen zur strukturierten Ablage und Klassifikation im Archiv. |
| Name | Definiert den technischen Schlüssel, unter dem der Wert an die D3One-Schnittstelle übergeben wird. |
| Anzeigename | Interne Bezeichnung des Feldes innerhalb der Komponentenkonfiguration. Der Anzeigename dient ausschließlich der besseren Lesbarkeit in der Konfiguration. |
Verarbeitung
Die Komponente führt folgende Verarbeitungsschritte aus:
- Entgegennahme eines Aufrufs über die D3One App-Connect-Schnittstelle
- Bereitstellung der konfigurierten Metadaten- und Konfigurationsinformationen
- Übergabe der definierten Schnittstellenparameter und Kategorien gemäß D3One-Spezifikation
- Bereitstellung eines Link-Endpunkts (HRef) zum Aufruf des Datenprozesses
- Speicherung der Antwortdaten im definierten Output-Objekt des Prozesskontexts
Die Komponente dient primär als Integrationsendpunkt für die D3One-Schnittstelle und stellt die notwendigen Informationen für die Archivkommunikation bereit.