Dokumentenimport per Profil
Überblick
Grundsätzlich verwendet der Import von Dokumenten per Profil die im Kapitel Import beschriebenen allgemeinen Funktionalitäten für den Import von Entitäten.
Typischerweise wird dazu ein Profil für den Batch-Import benutzt, das ausgehend von via Lobster Data Platform / Integration empfangenen Dateiinhalten per CREATE zusätzliche Dokument-Objekte erzeugen soll.
Die Verarbeitung der Dokumenteneigenschaften folgt dabei exakt der unter Dokumente importieren für den interaktiven Ablauf beschriebenen Logik. Allerdings muss das Profil anstelle des Benutzers die relevanten Inhalte bereitstellen.
Die vom System bereitgestellte Vorlage (s. Orchestration-Vorlagen) für das "Dokument"-Objekt (bzw. die Entität: Lobster SCM/doc:Document) definiert eine passende Zielstruktur, die direkt in einen Batch-Import eingebunden werden kann.
Für den Import mit Barcode-Erkennung muss anstelle des Dokument-Objekts die Vorlage für den Barcode-Präprozessor (doc:BarcodeDocument (Präprozessor)) eingebunden werden.
Import eines Dokuments ohne Barcode-Erkennung
Für das Erstellen eine neues Dokuments per Profil sind dabei typischerweise folgende Eigenschaften relevant:
|
Eigenschaft |
Feld der Zielstruktur |
Wert |
Beispiele |
|
Name |
name_attr |
Dokumentenname in (häufig aber nicht unbedingt der Dateiname) |
Ladeliste.pdf, LOADINGLIST |
|
Beschreibung |
description_attr |
Beschreibungstext für das Dokument |
Ladeliste im Druckformat |
|
Referenz |
reference_attr |
Schlüsselwert für das Referenzieren eines Datenobjekts (s. Dokumente zuweisen) |
123456789 |
|
Referenztyp |
referenceType_attr |
der interne "Name" (name) für einen Dokumentenreferenztyp |
LL_UPLOAD |
|
Referenziertes Objekt |
referencedEntity_attr |
Bezeichner für die Klasse des zu referenzierenden Datenobjekts (Sendung, Benutzer, ...) |
shp:Shipment, base:User |
|
Dokumententyp |
documentType_attr |
interner "Name" (name) für einen Dokumententyp |
LOADINGLIST |
|
Dokument Content |
documentContent |
Der Inhalt des Dokuments (Base64-codiert) |
...JVERasdhaw3ASd3fa5AGRS... |
Beim Importieren eines neuen Dokuments werden in weiteren Eigenschaften allgemeine Informationen zum Dokument (s. Dokumente importieren) sowie ggf. Ergebnisse des Referenzierens (s. Dokumente zuweisen) eingetragen.
Beim Dokumentenimport per Profil sind aus technischer Sicht sämtliche Angaben optional, auch wenn sie im interaktiven Prozess als Pflichtfeld erscheinen. Allerdings entfällt das Referenzieren, also der Versuch das neue Dokument einem Datenobjekt zuzuweisen, wenn nicht alle benötigten Angaben vorliegen (Referenz, Referenztyp und abhängig vom Referenztyp auch Referenziertes Objekt).
►HINWEIS◄ Im Unterschied zum interaktiven Ablauf kann ein Dokument beim Import via Profil auch direkt einem Datenobjekt zugewiesen werden, wenn das Profil die folgende Angaben liefert und keine vollständigen Angaben für das Referenzieren (s. o.) enthält.
|
Eigenschaft |
Feld der Zielstruktur |
Wert |
Beispiele |
|
Referenziertes Objekt |
referencedEntity_attr |
Bezeichner für die Klasse des zu referenzierenden Datenobjekts (Sendung, Benutzer, ...) |
shp:Shipment |
|
Referenziertes Objekt ID |
referencesEntityId_attr |
interne ID des referenzierten Datenobjekts |
2701 |
|
Referenz-Status |
referenceStatus_attr |
Als Referenz-Status muss "Referenziert" (REFERENCED) zugewiesen werden |
REFERENCED |
Import eines Dokuments mit Barcode-Erkennung
Für den Import mit Barcode-Erkennung anstelle des "Dokument" (Document)-Objekts muss die Vorlage für den Barcode-Präprozessor (doc:BarcodeDocument (Präprozessor)) eingebunden werden.
Dieser Präprozessor enthält einen Knoten template, in dem Felder für die relevanten Eigenschaften des "Dokument" (Document)-Objekts angeboten werden. Für diese Eigenschaften sind analog zum Import ohne Barcodes geeignete Einträge festzulegen (s. vorheriger Abschnitt).
Für die Barcode-Erkennung per Profil bietet der Präprozessor Felder an, die den Einstellmöglichkeiten im interaktiven Dialog entsprechen:
|
Eigenschaft |
Feld der Zielstruktur |
Wert |
Beispiele |
|
Barcode-Filter |
barcodeFilters/filter/format_attr |
Bezeichner für ein Barcode-Format (statische Aufzählung) |
CODE_128, EAN_13 |
|
barcodeFilters/filter/regex_attr |
Regulärer Ausdruck zur Prüfung der als Barcode gelesenen Zeichenfolge |
[0-9]{8}$ |
|
|
Barcode-Muster |
barcodePattern_attr |
Interpretationsschema für relevante Barcodes |
{referenceType}-{reference} |
|
Dokument aufteilen? |
splitDocument_attr |
true, wenn für jeden relevanten Barcode ein Teildokument erstellt werden soll |
true, false |
|
Überspringe Barcode-Seite? |
skipBarcodePage_attr |
true, wenn das Teildokument die Seite mit dem Barcode nicht enthalten soll |
true, false |