Technische Voraussetzungen für eine Anbindung von Archiv Kompakt zu iDWELL

Archiv kompakt ist eine einfache und vorkonfigurierte Archivlösung von Aareon zur revisionssicheren Archivierung und Recherche von Dokumenten, die sich auf das Wesentliche beschränkt. Sie ermöglicht den Anwendern flexibles Arbeiten zu jeder Zeit, von überall und mit unterschiedlichen Endgeräten.

Folgendermaßen kann eine Datenübertragung zu iDWELL hergestellt werden: 

Für die Kommunikation zwischen iDWELL und Archiv Kompakt ist eine moderne API-Schnittstelle erforderlich.

• API-Endpunkt: Der Zugriff erfolgt über archiv-kompakt-api5.aareon.com auf Port 48193.
• Authentifizierung:  Die Anbindung erfolgt via OAuth2. Hierfür müssen in Ihrem Microsoft Entra ID (ehemals Azure AD) folgende Daten generiert werden:
  1. Client ID
  2. Client Secret
  3. Benutzername & Passwort eines dedizierten Systembenutzers
• Scope: Der definierte Scope für die Abfrage lautet: https://api.businesscentral.dynamics.com/.default.

Damit iDWELL erfolgreich auf die Dokumente zugreifen kann, sind administrative Schritte in Ihrer Aareon-Umgebung notwendig:

1. Benutzeranlage: Erzeugen Sie einen technischen Benutzer direkt in AAK (Aareon Archiv Kompakt).
2. Berechtigungen: Dieser Benutzer muss einer Gruppe zugewiesen werden, die explizite Leserechte für die relevanten Dokumentenarchive besitzt.
3. ODataV4-Freigabe: Stellen Sie sicher, dass die Endpunkte (insbesondere für Dokumenten-Metadaten) für den externen Zugriff über das OData-Protokoll freigeschaltet sind.

Um häufige Fehlerquellen vorab auszuschließen, beachten Sie bitte folgende Punkte:

• Metadaten vs. Datei-Inhalt: Stellen Sie sicher, dass nicht nur der Zugriff auf die Listen (Metadaten) erlaubt ist, sondern auch die Funktion GetFileContent aktiv ist. Nur so können die tatsächlichen PDF-Dokumente in iDWELL angezeigt werden.
• Zertifikate: Für die Verschlüsselung der Datenübertragung ist ein gültiges, von einer offiziellen Zertifizierungsstelle signiertes Zertifikat zwingend erforderlich.
• Ordnerstruktur: Die Zuordnung der Dokumente (z. B. Abrechnungen oder Protokolle) zu Objekten und Mietern in iDWELL erfolgt automatisiert. Achten Sie daher auf eine konsistente Verschlagwortung Ihrer Dokumente im Archiv.