Einleitung
Die SAP Schnittstellen in CLARC ENTERPRISE basieren in weiten Bereichen auf definierten Standard-Schnittstellen in Form von Parameter- und Tabellen-Definitionen der entsprechenden SAP Funktionsbausteine.
Es existieren Schnittstellen für folgende Bereiche:
- Übergabe von Dokumenten und Metadaten.
- Verknüpfung von Dokumenten zu einem Business Objekt.
- Starten von Business Workflows.
- Übergabe von Barcodes - spätes und frühes Archivieren mit Barcode.
- Recherche in SAP Stammdaten.
- Buchung von Rechnungen.
Ablegen und Verknüpfen inkl. Wertübergabe
Interface Version 1
| Parameter | Typisierung | Opt. | Wert. | Beschreibung | |
|---|---|---|---|---|---|
Import Parameter | |||||
| CONTREP | LIKE | TOAV0-ARCHIV_ID | X | X | Content Repository |
| AROBJECT | LIKE | TOAV0-AR_OBJECT | X | X | Dokumentart |
| SAPOBJECT | LIKE | TOAV0-SAP_OBJECT | X | X | Objekttyp des Business Objekts |
| OBJECTID | LIKE | TOAV0-OBJECT_ID | X | X | Objekt-Id (Objektidentifikator) |
| LENGTH | TYPE | I | X | X | Contentlänge |
| DOCUCLASS | TYPE | BDS_BAR_EX-DOCUCLASS | X | X | Technischer Dokumenttyp |
Export Parameter | |||||
| RETURNCODE | TYPE | I | X | Returncode (0 ~ kein Fehler) | |
| RETURNMSG | LIKE | BAPIRET2-MESSAGE | X | Meldungstext | |
| RETDOCID | LIKE | TOAV0-ARC_DOC_ID | X | SAP Document Id | |
Tabellen | |||||
| DATA | LIKE | TBL1024 | Puffertabelle | ||
| ATTRIBUTES | LIKE | /CLARC/ALNK_EA_ST_ATTRIBUTES | X | Übergabestruktur für Metadaten | |
Struktur /CLARC/ALNK_EA_ST_ATTRIBUTES
| Komponente | Typ | Länge | Beschreibung |
|---|---|---|---|
| FIELDNAME | CHAR | 50 | Name des Datenfeldes aus CLARC ENTERPRISE |
| FIELDVALUE | CHAR | 250 | Feldwert zu NAME |
Interface Version 2
| Parameter | Typisierung | Opt. | Wert. | Beschreibung | |
|---|---|---|---|---|---|
Import Parameter | |||||
| CONTREP | LIKE | TOAV0-ARCHIV_ID | X | X | Content Repository |
| AROBJECT | LIKE | TOAV0-AR_OBJECT | X | X | Dokumentart |
| SAPOBJECT | LIKE | TOAV0-SAP_OBJECT | X | X | Objekttyp des Business Objekts |
| OBJECTID | LIKE | TOAV0-OBJECT_ID | X | X | Objekt-Id (Objektidentifikator) |
| LENGTH | TYPE | I | X | X | Contentlänge |
| DOCUCLASS | TYPE | BDS_BAR_EX-DOCUCLASS | X | X | Technischer Dokumenttyp |
Export Parameter | |||||
| RETURNCODE | TYPE | I | X | Returncode (0 ~ kein Fehler) | |
| RETURNMSG | LIKE | BAPIRET2-MESSAGE | X | Meldungstext | |
| RETDOCID | LIKE | TOAV0-ARC_DOC_ID | X | SAP Document Id | |
Tabellen | |||||
| DATA | LIKE | TBL1024 | Puffertabelle | ||
| HEADER | LIKE | Eigener Strukturtyp | X | Übergabestruktur für Kopfdaten | |
| POSITIONS | LIKE | Eigener Strukturtyp | X | Übergabestruktur für Positionsdaten | |
Hinweis
HEADER und POSITIONS können in der Schnittstellen-Version 2 einen beliebigen Aufbau haben - es werden durch den SAP Exportservice immer alle namentlich übereinstimmenden Felder befüllt und entsprechend übergeben. Das Matching erfolgt case insensitive.
Zum Beispiel:
Interface Version 3
| Parameter | Typisierung | Opt. | Wert. | Beschreibung | |
|---|---|---|---|---|---|
Import Parameter | |||||
| CONTREP | LIKE | TOAV0-ARCHIV_ID | X | X | Content Repository |
| AROBJECT | LIKE | TOAV0-AR_OBJECT | X | X | Dokumentart |
| SAPOBJECT | LIKE | TOAV0-SAP_OBJECT | X | X | Objekttyp des Business Objekts |
| OBJECTID | LIKE | TOAV0-OBJECT_ID | X | X | Objekt-Id (Objektidentifikator) |
| ARCDOCID | LIKE | TOAV0-ARC_DOC_ID | X | X | SAP ArchiveLink: Dokument-Id |
| LENGTH | TYPE | I | X | X | Contentlänge von DATA |
| DOCUCLASS | LIKE | SAEDOKTYP | X | X | Technischer Dokumenttyp |
| LENGTHATM | TYPE | I | X | X | Contentlänge der Anlage ATTAM |
| DOCUCLASSATM | LIKE | SAEDOKTYP | X | X | Technischer Dokumenttyp |
| DOCID | TYPE | CHAR32 | X | X | Eindeutige CLARC Dokumenten-Id |
Export Parameter | |||||
| RETURNCODE | TYPE | I | X | Returncode (0 ~ kein Fehler) | |
| RETURNMSG | LIKE | BAPIRET2-MESSAGE | X | Meldungstext | |
| RETDOCID | LIKE | TOAV0-ARC_DOC_ID | X | SAP ArchiveLink: Dokument-Id | |
Tabellen | |||||
| DATA | LIKE | TBL1024 | Binäre Dokument-Daten in Hex | ||
| ATTAM | LIKE | TBL1024 | Binäre Anlagen-Daten in Hex | ||
| HEADER | LIKE | /CLARC/ALNK_XC_ST_HEADER | Übergabestruktur für Kopfdaten | ||
| POSITIONS | LIKE | /CLARC/ALNK_XC_ST_POSITIONS | Übergabestruktur für Positionsdaten | ||
Struktur /CLARC/ALNK_XC_ST_HEADER
| Komponente | Typ | Länge | Beschreibung |
|---|---|---|---|
| NAME | CHAR | 30 | Name des Datenfeldes aus CLARC ENTERPRISE |
| VALUE | CHAR | 255 | Feldwert zu NAME |
| CONFIDENCE | INT1 | 3 | Vertrauenswert in Prozent 0..100 |
| CO_LEFT | INT4 | 10 | Koordinaten in Twips |
| CO_TOP | INT4 | 10 | Koordinaten in Twips |
| CO_WIDTH | INT4 | 10 | Koordinaten in Twips |
| CO_HEIGHT | INT4 | 10 | Koordinaten in Twips |
| CO_PAGE | INT4 | 10 | Seitennummer beginnend mit 0 |
| FIELD_TYPE | CHAR | 10 | Feldtyp
|
Struktur /CLARC/ALNK_XC_ST_POSITIONS
| Komponente | Typ | Länge | Beschreibung |
|---|---|---|---|
| ROWNUMBER | INT4 | 10 | Positionszeilennummer beginnend bei 0 |
| NAME | CHAR | 30 | Name des Datenfeldes aus CLARC ENTERPRISE |
| VALUE | CHAR | 255 | Feldwert zu NAME |
| CONFIDENCE | INT1 | 3 | Vertrauenswert in Prozent 0..100 |
| CO_LEFT | INT4 | 10 | Koordinaten in Twips |
| CO_TOP | INT4 | 10 | Koordinaten in Twips |
| CO_WIDTH | INT4 | 10 | Koordinaten in Twips |
| CO_HEIGHT | INT4 | 10 | Koordinaten in Twips |
| CO_PAGE | INT4 | 10 | Seitennummer beginnend mit 0 |
| FIELD_TYPE | CHAR | 10 | Feldtyp
|
Interface Version 4
Die Interface Version 4 beinhaltet alle Definitionen aus Version 3.
Hinzu kommt die Tabelle ROWS für die Übergabe von Positionszeileninformationen.
| Parameter | Typisierung | Opt. | Wert. | Beschreibung | |
|---|---|---|---|---|---|
Import Parameter | |||||
| CONTREP | LIKE | TOAV0-ARCHIV_ID | X | X | Content Repository |
| AROBJECT | LIKE | TOAV0-AR_OBJECT | X | X | Dokumentart |
| SAPOBJECT | LIKE | TOAV0-SAP_OBJECT | X | X | Objekttyp des Business Objekts |
| OBJECTID | LIKE | TOAV0-OBJECT_ID | X | X | Objekt-Id (Objektidentifikator) |
| ARCDOCID | LIKE | TOAV0-ARC_DOC_ID | X | X | SAP ArchiveLink: Dokument-Id |
| LENGTH | TYPE | I | X | X | Contentlänge von DATA |
| DOCUCLASS | LIKE | SAEDOKTYP | X | X | Technischer Dokumenttyp |
| LENGTHATM | TYPE | I | X | X | Contentlänge der Anlage ATTAM |
| DOCUCLASSATM | LIKE | SAEDOKTYP | X | X | Technischer Dokumenttyp |
| DOCID | TYPE | CHAR32 | X | X | Eindeutige CLARC Dokumenten-Id |
Export Parameter | |||||
| RETURNCODE | TYPE | I | X | Returncode (0 ~ kein Fehler) | |
| RETURNMSG | LIKE | BAPIRET2-MESSAGE | X | Meldungstext | |
| RETDOCID | LIKE | TOAV0-ARC_DOC_ID | X | SAP ArchiveLink: Dokument-Id | |
Tabellen | |||||
| DATA | LIKE | TBL1024 | Binäre Dokument-Daten in Hex | ||
| ATTAM | LIKE | TBL1024 | Binäre Anlagen-Daten in Hex | ||
| HEADER | LIKE | /CLARC/ALNK_XC_ST_HEADER | Übergabestruktur für Kopfdaten | ||
| ROWS | LIKE | /CLARC/ALNK_XC_ST_ROWS | Übergabestruktur für Positionsdaten (Zeilen) | ||
| POSITIONS | LIKE | /CLARC/ALNK_XC_ST_POSITIONS | Übergabestruktur für Positionsdaten (Zellen) | ||
Struktur /CLARC/ALNK_XC_ST_ROWS
| Komponente | Typ | Länge | Beschreibung |
|---|---|---|---|
| ROWNUMBER | INT4 | 10 | Positionszeilennummer beginnend bei 0 |
| CONFIDENCE | INT1 | 3 | Vertrauenswert in Prozent 0..100 |
| CO_LEFT | INT4 | 10 | Koordinaten in Twips |
| CO_TOP | INT4 | 10 | Koordinaten in Twips |
| CO_WIDTH | INT4 | 10 | Koordinaten in Twips |
| CO_HEIGHT | INT4 | 10 | Koordinaten in Twips |
| CO_PAGE | INT4 | 10 | Seitennummer beginnend mit 0 |
Hinweis
NULL-Werte in Kopf- oder Positionsdaten werden nicht an SAP übertragen und müssen entsprechend im Funktionsbaustein bzw. Nachfolgeprozess gehandelt werden.