Dokumentenimport via Lobster_data
Überblick
Grundsätzlich verwendet der Import von Dokumenten in Lobster Data Platform / Orchestration via Lobster_data die im Kapitel Import beschriebenen allgemeinen Funktionalitäten für den Import von Objekten.
Typischerweise wird dazu ein Profil für den Batch-Import benutzt, das ausgehend von via Lobster_data empfangenen Dateiinhalten per CREATE zusätzliche Dokument-Objekte in Lobster Data Platform / Orchestration erzeugen soll.
Die Verarbeitung der Dokumenteigenschaften in Lobster Data Platform / Orchestration 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.
In Lobster_data stellt die Lobster Data Platform / Orchestration-Vorlage (s. Lobster_pro Vorlagen) für das Dokument-Objekt (bzw. die Entität: Lobster SCM/doc:Document) eine passende Zielstruktur bereit, die in einen Batch-Import eingebunden werden kann.
Für den Import mit Barcode-Erkennung anstelle des Dokument-Objekts die Lobster Data Platform / Orchestration-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 Lobster Data Platform / Orchestration (häufig aber nicht zwangsläufig 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 |
ein in Lobster Data Platform / Orchestration angelegter Dokumentenreferenztyp (interner Name) |
LL_UPLOAD |
|
Referenziertes Objekt |
referencedEntity_attr |
Bezeichner für die Klasse des zu referenzierenden Datenobjekts (Sendung, Benutzer, ...) |
shp:Shipment, base:User |
|
Dokumententyp |
documentType_attr |
ein in Lobster Data Platform / Orchestration angelegter Dokumententyp (interner Name) |
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.
Wenn der Import via Lobster_data erfolgt, 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 Lobster_data 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-Objekts die Lobster Data Platform / Orchestration-Vorlage für den Barcode-Präprozessor (doc:BarcodeDocument (Präprozessor)) eingebunden werden.
Dieser Präprozessor enhält einen Knoten "template", in dem Felder für die relevanten Eigenschaften des Dokument-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 |