Anhänge in SAP S/4HANA Cloud Public Edition archivieren

Kurzantwort

Anhänge in SAP S/4HANA Cloud Public Edition sollten vom konkreten Geschäftsobjekt aus geplant werden: Welche App erzeugt den Anhang, welches Dokumentenframework verwaltet ihn, wo liegt der Inhalt und wie bleibt er später abrufbar? SAP dokumentiert für den Attachment Service ein Standard-Repository auf SAP BTP sowie eine optionale Anbindung externer Repositories. Eine Drittanbieter-Anbindung über CMIS ist damit eine Architekturentscheidung, nicht automatisch für jeden Anhang erforderlich. [1] [2]

Ein erfolgreicher Upload beantwortet noch nicht, ob ein Dokument über seine vorgesehene Nutzungsdauer nachvollziehbar verfügbar bleibt. Dafür braucht das Projekt festgelegte Aufbewahrungsregeln, überprüfte Berechtigungen und einen getesteten Abruf- und Exportweg. Dieser Leitfaden beschreibt die technische Planung und Abnahme, nicht die rechtliche Anerkennung einer Archivlösung.

Geltungsbereich und fachliche Grenzen

Der Leitfaden behandelt Dateien und Anhangs-URLs, die über unterstützte Geschäftsobjekte und Dokumentenframeworks der SAP S/4HANA Cloud Public Edition verwaltet werden. Die geprüfte SAP-Dokumentation ist Version 2608; der tatsächlich eingesetzte Release und die aktivierte Konfiguration müssen gesondert bestätigt werden.

Nicht behandelt werden eine pauschale Konfiguration für alle Fiori-Apps, eine Übertragung von On-Premise-Transaktionen auf die Public Edition, ERP-Datenarchivierung oder eine vollständige Migration beliebiger Bestandsarchive. Er enthält keine GoBD-, Zertifizierungs-, Kosten- oder SLA-Zusage. Die Eignung einer konkreten arcana-Lösung ist nicht durch diesen Artikel bestätigt.

Für eine allgemeine Schnittstellenentscheidung hilft der Beitrag ArchiveLink oder CMIS?. Hier geht es dagegen gezielt um den Lebenszyklus eines Public-Edition-Anhangs.

Phase 1: App, Geschäftsobjekt und Originaldatei festlegen

Beginnen Sie mit einem begrenzten Pilotfall: eine konkrete App, ein Geschäftsobjekt und eine fachlich relevante Dokumentart. Dokumentieren Sie App-Bezeichnung, Objekt- beziehungsweise Knotentyp, Objekt-Schlüssel, verwendetes Framework und den vorgesehenen Aufbewahrungszweck. Ein Pilot ist erst aussagekräftig, wenn diese Angaben aus dem eigenen System stammen und nicht aus einem allgemeinen Produktbeispiel.

Die Attachments-API API_CV_ATTACHMENT_SRV kann Anhänge und Anhangs-URLs für Geschäftsobjekte verwalten. Ihre Dokumentation beschreibt unter anderem Anlegen, Lesen, Umbenennen und Löschen. Sie nennt aber auch Einschränkungen: Die API unterstützt keine Draft-Funktion und ist laut Dokumentation nicht mit draft-fähigen konsumierenden Anwendungen kompatibel. Der Inhalt eines bestehenden Anhangs lässt sich über diese API nicht aktualisieren. Diese Grenzen müssen im konkreten App-Ablauf geprüft werden. [3]

Unterscheiden Sie außerdem eine hochgeladene Originaldatei von einem gespeicherten URL-Verweis. Für einen Link muss geklärt werden, wer das Ziel betreibt und ob das Dokument auch nach einer Änderung des Zielsystems noch erreichbar ist. Die Anhangsliste allein ist kein Nachweis, dass die Originaldatei langfristig gesichert ist.

Phase 2: SAP-Verknüpfung und Speicherort getrennt erfassen

SAP beschreibt zwei Ebenen: Strukturierte Angaben wie Dateiname und MIME-Typ werden in SAP-Datenbanktabellen verwaltet; der eigentliche Dokumentinhalt liegt in einem CMIS-basierten Repository. Das Repository hält seinerseits Inhalt und Metadaten. SAPs Standardpfad nutzt den SAP Document Management Service auf BTP über die SAP Content Bridge. [1]

Für die Projektabnahme empfiehlt sich deshalb eine Zuordnung zwischen Geschäftsobjekt-Schlüssel, logischer Dokument-ID, physischer Dokument-ID und Speicher-Kategorie, soweit diese Felder im jeweiligen Ablauf verfügbar sind. Die API-Dokumentation nennt beispielsweise LogicalDocument, ArchiveDocumentID, LinkedSAPObjectKey und StorageCategory. [3]

Prüfen Sie zwei unterschiedliche Fehlerfälle: Eine Datei liegt im Repository, ist aber nicht mehr vom Geschäftsobjekt aus erreichbar; oder die Anhangsliste zeigt einen Eintrag, dessen Datei nicht geladen werden kann. Beide Fälle benötigen einen geklärten Wiederherstellungs- und Eskalationsweg.

Phase 3: Standard-Repository oder Drittanbieter-Anbindung entscheiden

Vergleichen Sie zunächst das vorhandene Standard-Repository mit den fachlichen Anforderungen. Wenn ein externes Repository gewählt wird, dokumentiert SAP den kundenverwalteten Kommunikationsfall SAP_COM_0597 und die Integration über den SAP Document Management service, integration option, auf BTP Cloud Foundry mittels CMIS. Die Konfiguration sowie die Integration nicht von SAP entwickelter Produkte liegen in der Verantwortung des Kunden. [2]

SAP empfiehlt für diesen Integrationspfad zertifizierte Lösungen. Das ist keine Bestätigung, dass ein bestimmter Anbieter, Produktstand oder Einsatzfall aktuell zertifiziert ist. Prüfen Sie einen entsprechenden Nachweis vor einer Auswahlentscheidung anhand des passenden Szenarios. [2]

Der vorhandene Leitfaden zur CMIS-Integration in SAP BTP behandelt die technische Verbindung ausführlicher. Wiederholen Sie diese Einrichtung nicht als unabhängiges Archivprojekt: Für Public-Edition-Anhänge müssen App-Verhalten, SAP-Verknüpfungen und Repository gemeinsam abgenommen werden.

Phase 4: Dokumenttypen, HDM und Speicher-Kategorien prüfen

Harmonized Document Management, kurz HDM, kann im konfigurierten Geschäftsobjekt unterstützte Dokumentenframeworks wie DMS und GOS zusammenführen. Ohne diese Konfiguration kann die API je übergebenem Objekttyp nur DMS- oder GOS-Anhänge liefern; für beide können getrennte Aufrufe erforderlich sein. Mit entsprechend konfiguriertem HDM werden die für das Objekt aktiv gepflegten Frameworks berücksichtigt. [3]

Die SAP-Konfigurationsdokumentation nennt 101090 – Define DMS Document Types, 105346 – Activate HDM for Attachment Object Type und 103583 – Maintain Storage Categories. Letztere Aktivität betrifft Kunden, die ein externes Repository für Dateispeicherung wählen. Nutzen Sie die Konfigurationsumgebung Ihres Releases und prüfen Sie die erforderlichen Konfigurationsberechtigungen; diese Aktivitäten sind keine universelle Anleitung für jede App. [4]

Halten Sie nach der Konfiguration fest, welche Dokumenttypen zugelassen sind, welches Framework tatsächlich verwendet wird und welche Speicher-Kategorie dem Pilotfall zugeordnet ist. Testen Sie mit einer neu angelegten Datei und einem vorhandenen Anhang, nicht nur mit einer erfolgreichen Verbindungsprüfung.

Phase 5: Zugriff, Aufbewahrung und Löschung als Verhalten testen

Legen Sie zunächst ein Sollverhalten fest. Wer darf ein Dokument lesen? Wer darf eine neue Fassung ablegen oder den Namen ändern? Wer darf eine Löschung anstoßen, und was geschieht während einer Aufbewahrungs- oder Sperrphase? Diese Regeln müssen aus dem fachlichen und rechtlichen Konzept des Unternehmens kommen; die technische Anbindung erzeugt sie nicht automatisch.

Die API liefert unter anderem Angaben wie AttachmentDeletionIsAllowed und AttachmentRenameIsAllowed. Solche Felder helfen bei der Prüfung eines konkreten Vorgangs, ersetzen aber weder ein vollständiges Berechtigungskonzept noch einen rechtlichen Aufbewahrungsnachweis. [3]

Empfohlene Abnahmeschritte sind:

  1. Eine berechtigte Person lädt das Original vom richtigen Geschäftsobjekt und vergleicht die Datei mit dem vereinbarten Referenzbestand.
  2. Eine nicht berechtigte Person erhält weder über die App noch über einen zusätzlich geprüften technischen Zugang unzulässigen Zugriff.
  3. Eine erlaubte Namensänderung und ein unzulässiger Änderungs- oder Löschversuch zeigen das festgelegte Verhalten.
  4. Ein Repository-Ausfall führt zu einem erkennbaren Fehler, einem dokumentierten Wiederanlauf und keinem stillen Verlust der Verknüpfung.
  5. Nach Ablauf einer vereinbarten Frist werden Freigabe, etwaige Sperren und Löschentscheidung nachvollziehbar protokolliert.

Diese Schritte sind Projekt-Empfehlungen. Ob sie im konkreten Produkt unterstützt werden, muss im Pilot nachgewiesen werden.

Phase 6: Export und späteren Systemwechsel vorbereiten

Planen Sie den Abruf außerhalb des täglichen App-Prozesses bereits vor dem Produktivstart. Ein Export sollte nicht nur Dateien liefern, sondern die benötigte Zuordnung zum Geschäftsobjekt, lesbare Metadaten und ein prüfbares Mengen- beziehungsweise Vollständigkeitsprotokoll. Legen Sie fest, welche Informationen dafür tatsächlich verfügbar sein müssen.

SAP beschreibt Onboarding vom kundenverwalteten ins SAP-verwaltete Repository und Offboarding in die Gegenrichtung. Beim Offboarding nennt SAP Attachment Data Returns einschließlich an Geschäftsobjekte gebundener Inhalte und bestimmter Ausgabedokumente. Das ist eine dokumentierte Prozessbasis, aber keine Zusage einer automatischen Migration zwischen beliebigen Drittarchiven. [5]

Für ein bestehendes Archiv ergänzt die Checkliste zur SAP-Archivmigration den hier beschriebenen Pilot. Übernehmen Sie einen Testexport in die Abnahme: Originaldatei lesbar, zugehöriges Geschäftsobjekt identifizierbar, erforderliche Metadaten vorhanden und Mengenabgleich nachvollziehbar.

Häufige Fragen

Braucht jeder Public-Cloud-Anhang ein externes Drittarchiv?

Nein, eine solche pauschale Pflicht folgt nicht aus der verwendeten SAP-Dokumentation. SAP beschreibt ein Standard-Repository und eine alternative Drittanbieter-Anbindung. Welche Variante die eigenen fachlichen und rechtlichen Anforderungen erfüllt, ist gesondert zu prüfen. [1] [2]

Reicht eine funktionierende CMIS-Verbindung für die Archivabnahme?

Nein. Die Verbindung belegt zunächst einen technischen Kommunikationsweg. Für die Abnahme dieses Anhangs müssen zusätzlich Geschäftsobjekt-Verknüpfung, Originalabruf, Berechtigungen, festgelegter Lebenszyklus und ein geeigneter Export geprüft werden.

Ist eine gespeicherte Anhangs-URL dasselbe wie eine archivierte Originaldatei?

Nein. Die API unterstützt sowohl Anhänge als auch Anhangs-URLs. Bei einem Verweis hängt die Verfügbarkeit des Inhalts zusätzlich vom Ziel ab; die langfristige Sicherung des Originals muss im jeweiligen Konzept nachgewiesen werden. [3]

Quellen

arcana Solutions

Vereinbaren Sie einen Beratungstermin

Sie benötigen noch Klarheit und möchten eine kostenfreie Beratung mit uns? Wählen Sie einen Termin aus und erfahren Sie, welche Archiv-Lösung optimal für Sie ist.