agorum core dms importer konfigurieren

Mit diesem Plug-in importieren Sie zur Verfügung gestellte Exportdaten aus anderen Systemen nach agorum core.

Zu importierende Daten

Der Import der Daten läuft innerhalb des agorum core-Servers ab. Die Dateien / Daten müssen in dem Installationspfad von agorum core liegen, indem Sie diese dorthin kopieren oder mounten.

Dabei kann es sich um Dateien wie Word-, Excel- oder PDF-Dateien handeln, aber auch um Adressdaten oder andere Informationen.

• Der agorum core dms importer akzeptiert jedes Format der zu importierenden Dateien.
• Sie müssen die Dateien nicht aufbereiten oder ändern.

Das Format der Daten ist abhängig von der Ursprungssoftware.

• Jedes Dokument besteht aus dessen Originaldatei.
• Ein Dokument besteht aus zwei Dateien: Originaldokument und Metadatendatei
• Die Metadateninformationen wurden in dem Dateinamen der zu importierenden Datei eingepflegt.
• Eine Metadatendatei für alle zu importierenden Dokumente.
• Diese Metadatendatei kann etwa als TXT, JSON oder XML-Format vorliegen.

Den Datenimport planen

Planen Sie den Datenimport, damit Ihre Daten korrekt und problemlos in agorum core abgelegt werden können.

Um welche Daten handelt es sich?

​​​​​​Welche Daten importieren Sie? Handelt es sich etwa um Bilder, PDFs oder Word-Dokumente? Oder möchten Sie Adressdaten oder anderweitige Informationen in agorum core importieren?

Um welche Dokumententypen handelt es sich?

Handelt es sich bei den Daten, die Sie importieren möchten, um Rechnungen, Lieferscheine, Zeugnisse oder Verträge?

Wo sollen die Daten abgelegt werden?

In welcher Ordnerstruktur sollen die Daten abgelegt werden? Wird ein Objekttyp gebraucht, der etwa Adressdaten als Adressen darstellt? Oder sollen Dokumente in bestimmte Ordner abgelegt werden?

Existieren Metadaten?

Besitzen Ihre Dokumente Metadateninformationen? Welches Format haben diese und welche möchten Sie auf die Dokumente setzen? Müssen dazu neue Metadaten in agorum core definiert oder können bereits vorhandene verwendet werden? Haben die Dokumententypen verschiedene Metadaten? Etwa liegen nur bei Rechnungen die Rechnungsnummer, das Rechnungsdatum und der Rechnungsbetrag vor, während bei Verträgen ganz andere Metadaten greifen.

Wie können Ihre Benutzer die Daten finden?

Benutzer haben über die Suche einen schnellen Zugriff auf Dokumente und Informationen. Stellen Sie bei einem Import neuer Daten sicher, dass ein neuer Filter im System vorhanden ist oder bereits vorhandene auch die neuen Dokumente finden.

Welches Berechtigungsmodel benötigen Sie?

Falls Sie eine neue Ordnerstruktur erstellen, benötigen Sie neue ACLs. Möchten Sie die zu importierenden Dokumente mit Flags versehen, damit das System diese Dokumente etwa auf revisionssicher oder unlöschbar setzt?

Je besser und detaillierter Ihre Planung ist, desto weniger Korrekturen müssen Sie vornehmen. Änderungen können Sie als Administrator / Entwickler jederzeit durchführen, allerdings erfordert dies nachträglichen Aufwand.

Regeldefinitionen in einer CSV-Datei

Durch eine Regeldatei steuern Sie den Import Ihrer Daten nach agorum core und legen darin etwa fest:

• wo die Daten abgelegt werden (absolute und relative Pfade)
• welche Dokumente verlinkt werden
• welche Templates für den agorum core explorer aktiviert werden
• welche Metadaten übergeben werden
• welche Metadaten Sie wie priorisieren möchten (etwa zwei Werte für ein Metadatum)
• welche Metadaten, die nicht auf Dokumente gesetzt werden, übergeben werden, aber etwa für ein JavaScript benötigt werden

Grober Aufbau einer Regeldatei

Sie haben sich Ihre Dokumente angeschaut und wissen, welche Dokumententypen Sie nach agorum core importieren möchten. Diese Informationen bilden Sie in der CSV-Regeldatei ab.

Beispiel für den Dokumententyp „Rechnung“

• Welche Metadaten sollen auf diese Dokumententypen gesetzt werden (Rechnungsnummer, Rechnungsdatum und so weiter?)
• In welchem Pfad werden die Dokumente abgelegt?
• Welche Flags sollen auf alle Rechnungen gesetzt werden (etwa revisionssicher für 11 Jahre)?

Beispiel: Grober Aufbau einer Regeldatei

Auszug der enthaltenen Spalten

<Lieferant>/Rechnungen/<Rechnungsdatum:Jahr>/<Rechnungsdatum:Monat>

Regeln innerhalb der Regeldatei

• Ein JavaScript ruft die Regeldatei auf und führt es auf die zu importierenden Dokumente aus.
• Pro Dokumententyp existiert eine Regel.
• Diese Regel besteht aus einer oder mehreren Zeilen.
• Das System erkennt anhand der Spalte scr_doctype, dass eine neue Dokumententypregel existiert.
• Steht in der Spalte src_doctype ein Eintrag, beginnt ab hier die Regel für einen Dokumententyp. Danach können beliebig viele Zeilen folgen, in denen die Spalte src_doctype leer ist.
• All diese Zeilen gehören zu dieser Regel.
• Erst wenn wieder ein neuer Eintrag in der Spalte src_doctype erscheint, beginnt ab dort eine neue Regel für einen weiteren Dokumententyp.

Beispiele für Regeldateien

1. Öffnen Sie links in der Seitenleiste Explorer.
2. Öffnen Sie den Pfad:

   Eigene Dateien/Administration/customers/dmsimporter/samples

Beispiel 1

Eigene Dateien/Administration/customers/dmsimporter/samples/migration-table-test-1/undefined>migrationtable.csv​​​​​​

Beispiel 2

Eigene Dateien/Administration/customers/dmsimporter/samples/migration-table-test-fs/migrationtable-fs.csv​​​​​​

Dokumentinhalt

name;description;src_doctype;ac_condition;src_metadata;src_format;ac_metadata;ac_type;ac_staticvalue;ac_save_on_doc;ac_function;ac_destfolder_start;ac_destfolder;ac_asa_record;ac_name;ac_systemflags;ac_ac_revisionyears
Datei;;file;;name;;dmsimporter_name;string;;true;;FS/${dmsimporter_parent:f};Dateien/${dmsimporter_lastmodified:yyyy}/${dmsimporter_lastmodified:MM};dmsimporter_fs;${originalName}.${extension};0;
;;;;lastmodified;dd.MM.yyyy;dmsimporter_lastmodified;date;;true;;;;;;;
;;;;;;dmsimporter_doctype;string;File;true;;;;;;;
;;;;size;;dmsimporter_size;long;;true;;;;;;;
;;;;parent;;dmsimporter_parent;string;;;;;;;;;
;;;;parent;;dmsimporter_dummy;string;;;;;;;;;

Kopfzeile der CSV-Regeldatei

• Die Regeldatei muss ein CSV-Dokument mit einer Kopfzeile sein.
• In der Kopfzeile sind vordefinierte Spaltennamen enthalten.

ac_condition

ac_staticvalue

Einen festen Wert zuweisen

Tragen Sie in dieser Spalte einen Wert ein, den das System dem Metadatum aus der Spalte ac_metadata fest zuweist.

Beispiel
Bei der Regel offer handelt es sich immer um ein Angebot. Sie weisen dem Metadatum dmsimporter_doctype deshalb immer den Wert Angebot zu. Tragen Sie dazu in dieser Spalte Angebot ein.

Einen Wert mappen (mapping csv)

Mit dieser Variante stellen Sie sicher, dass das System einen übergebenen Wert anhand einer Mapping-Tabelle anpasst.

Tragen Sie dazu in die Spalte ac_staticvalue diesen Wert ein:

${match:<Basisname der Mapping-Datei>:<Name des zu mappenden Metadatums>}

Beispiel

Eintrag in der Spalte ac_staticvalue:

${match:dmsimporter-demo-mapping-customernumber:dmsimporter_customernumber}

Aufbau der Mapping-csv:

value;mapping
default;
K999;Kunde 999
K0002;Kunde 02
K0003;Kunde 03

Findet das System den Wert von dmsimporter_customernumber in der Spalte value NICHT, mappt es den Wert von default. In diesem Fall ist der Wert leer.

Default-Wert

Sie definieren in src_metadata ein Metadatum für die Quelle und in ac_staticvalue einen festgelegten Wert, den das System verwenden soll, wenn der ausgelesene Werte später beim Import für das definierte src_metadata leer ist.

Den Import per JavaScript steuern

Die Dateien liegen im Installationspfad von agorum core, und Sie haben im Konfigurationsprojekt dmsimporter eine Regeldatei angelegt. Noch existieren diese beiden Einheiten unabhängig voneinander. Auch das System weiß noch nicht, wie diese zusammengehören.

Sie erstellen im nächsten Schritt ein JavaScript, das den Import steuert. Das JavaScript besitzt die Funktionen:

• read
• update

read

Verarbeitet nacheinander jedes Dokument in dem zu importierenden Pfad.

• In diesem JavaScript können Sie als Entwickler sicherstellen, dass die passenden Dokumente sowie die Anpassung von Metadaten an das Format von agorum core umgesetzt werden.
• Außerdem teilen Sie in diesem Skript dem System mit, welches Dokument mit welcher Metadaten-Datei zusammengehört.

Beispiel

Anschreiben.doc
Name der zu importierenden Datei.

Anschreiben.doc.json
In dieser Datei stehen die dazugehörigen Metadaten.

Dieses Beispiel zeigt, wie die Metadaten Ihrer Ursprungsdatei aussehen müssen, damit agorum core diese bearbeiten und annehmen kann:

data = {
   name: 'Anschreiben.doc'
   filesize: 123456
};

return data;

Diese Formatierung können Sie per JavaScript in der Funktion read verwenden.

Sollte Ihnen in einer einzigen Datei alle Metadaten für alle zu importierenden Dokumente vorliegen, müssen Sie dieses JavaScript anpassen und sicherstellen, dass Metadaten dem passenden Dokument zugeordnet werden.

Für das Return-Object existieren einige Metadaten, die von der Schreibweise her fest definiert sind.

Beispiel

 data = {
   name: 'Anschreiben.doc',
   size: 123456,

   //Fest definierte Metadaten
   src_doctype: 'file',     // ist ein Pflichtfeld, 
                            // durch diese Info greifen die Ablageregeln aus der Regeldatei
    ac_note: 'Enthält Text der als Notiz an das agorum-Object angehängt wird',
    ac_ignore: false,       // false: Datei wird nach agorum core importiert
                            // true: Datei wird NICHT nach agorum core importiert
                            // Dies können Sie etwa für die Metadaten-Datei <Filename>.json nutzen,
                            // sollten Sie keinen anderen Weg im JavaScript verwendet haben

    // die folgenden Werte sind nur im Rahmen versionierter Dateien notwendig
    ac_version: 1,          // optionale Versionsnummer für Sortierung
    ac_versionlabel: 'V1',  // optionale anzeigbare Versionsnummer
    ac_versioncomment: 'Dies ist Version 1'
                            // optionales Versionskommentar
  };

Beispiel für die Funktion „read“

function read(file) {
  data = {};
  // ..
  // ..
  return data;
}

update

Nimmt nachträgliche Anpassungen vor oder aktiviert Aktionen wie das Starten eines Workflows, nachdem die Dokumente mitsamt Ihren Metadaten durch die Funktion read nach agorum core importiert wurden.

Das System ruft die Funktion update für jedes importierte Objekt auf.

Die Funktion besitzt die Übergabeparameter:

• object
• rule

object
Stellt das importierte agorum core-Objekt dar. Die komplette agorum core JavaScript API steht zur Verfügung.

rule
Stellt die Informationen aus der Regeldatei dar, die das System als JSON-Struktur weiterreicht.

Die Datei enthält die Werte der gesetzten Metadaten und den Originalnamen der Datei (Metadatum originalName) sowie die Dateiextension (Metadatum extension).

Beispiel zum rule-Object

{
  "name": "offer",
  "condition": "dmsimporter_offertype=Angebotstyp2",
  "description": "Angebot Variante 2",
  "description2": "Angebot vom Typ 2",
  "metadata": [{
    "srcMetadata": "src_offertype",
    "acMetadata": "dmsimporter_offertype",
    "type": "string",
    "static": "",
    "acFunction": "",
    "format": "",
    "saveOnDoc": ""
  }, {
    "srcMetadata": "src_offernumber",
    "acMetadata": "dmsimporter_offernumber",
    "type": "string",
    "static": "",
    "acFunction": "",
    "format": "",
    "saveOnDoc": "true"
  }, {
    "srcMetadata": "src_offerdate_1",
    "acMetadata": "dmsimporter_offerdate",
    "type": "date",
    "static": "",
    "acFunction": "prio1",
    "format": "dd.MM.yyyy",
    "saveOnDoc": "true"
  }, {
    "srcMetadata": "src_offerdate_2",
    "acMetadata": "dmsimporter_offerdate",
    "type": "date",
    "static": "",
    "acFunction": "prio2",
    "format": "dd.MM.yyyy",
    "saveOnDoc": "true"
  }, {
    "srcMetadata": "",
    "acMetadata": "dmsimporter_doctype",
    "type": "string",
    "static": "Angebot",
    "acFunction": "",
    "format": "",
    "saveOnDoc": "true"
  }, {
    "srcMetadata": "src_customernumber",
    "acMetadata": "dmsimporter_customernumber",
    "type": "string",
    "static": "",
    "acFunction": "",
    "format": "",
    "saveOnDoc": ""
  }, {
    "srcMetadata": "src_customername",
    "acMetadata": "dmsimporter_customername",
    "type": "string",
    "static": "",
    "acFunction": "",
    "format": "",
    "saveOnDoc": ""
  }
              ],
  "destFolderStart": "Kunden/${dmsimporter_customername:f}",
  "destFolder": ["Angebote/${dmsimporter_offerdate:yyyy}/${dmsimporter_offerdate:MM}", "/Alle Angebote/${dmsimporter_offerdate:yyyy}/${dmsimporter_offerdate:MM}"],
  "asaRecord": "dmsimporter_kundenakte",
  "fileName": "An_${dmsimporter_offernumber}.${extension}",
  "sysFlags": "",
  "fileNameSet": "An_666777.txt",
  "destFolderStartSet": "Kunden/Testkunde 456",
  "destFolderSet": ["Angebote/2019/09", "/Alle Angebote/2019/09"],
  "values": {
    "src": {
      "src_offertype": {
        "value": "Angebotstyp2",
        "type": "string",
        "srcMetadata": "src_offertype",
        "acMetadata": "dmsimporter_offertype",
        "use": false
      },
      "src_offernumber": {
        "value": "666777",
        "type": "string",
        "srcMetadata": "src_offernumber",
        "acMetadata": "dmsimporter_offernumber",
        "use": "true"
      },
      "src_offerdate_1": {
        "value": "2019-09-18T10:00:00.000Z",
        "type": "date",
        "srcMetadata": "src_offerdate_1",
        "acMetadata": "dmsimporter_offerdate",
        "use": "true"
      },
      "src_customernumber": {
        "value": "K456",
        "type": "string",
        "srcMetadata": "src_customernumber",
        "acMetadata": "dmsimporter_customernumber",
        "use": false
      },
      "src_customername": {
        "value": "Testkunde 456",
        "type": "string",
        "srcMetadata": "src_customername",
        "acMetadata": "dmsimporter_customername",
        "use": false
      }
    },
    "agorum": {
      "dmsimporter_offertype": {
        "value": "Angebotstyp2",
        "type": "string",
        "srcMetadata": "src_offertype",
        "acMetadata": "dmsimporter_offertype",
        "use": false
      },
      "dmsimporter_offernumber": {
        "value": "666777",
        "type": "string",
        "srcMetadata": "src_offernumber",
        "acMetadata": "dmsimporter_offernumber",
        "use": "true"
      },
      "dmsimporter_offerdate": {
        "value": "2019-09-18T10:00:00.000Z",
        "type": "date",
        "srcMetadata": "src_offerdate_1",
        "acMetadata": "dmsimporter_offerdate",
        "use": "true"
      },
      "dmsimporter_doctype": {
        "value": "Angebot",
        "type": "string",
        "acMetadata": "dmsimporter_doctype",
        "use": "true"
      },
      "dmsimporter_customernumber": {
        "value": "K456",
        "type": "string",
        "srcMetadata": "src_customernumber",
        "acMetadata": "dmsimporter_customernumber",
        "use": false
      },
      "dmsimporter_customername": {
        "value": "Testkunde 456",
        "type": "string",
        "srcMetadata": "src_customername",
        "acMetadata": "dmsimporter_customername",
        "use": false
      },
      "extension": {
        "value": "txt",
        "type": "string",
        "acMetadata": "extension",
        "use": false
      },
      "originalName": {
        "value": "test3",
        "type": "string",
        "acMetadata": "originalName",
        "use": false
      }
    }
  }
}

Um in der Funktion update auf eines der Metadaten zugreifen zu können, sprechen Sie die verschiedenen Kategorien an. Sie greifen etwa auf das Metadatum dmsimporter_customernumber wie folgt zu:

rule.values.agorum.dmsimporter_customernumber

In der Funktion update können Sie jetzt weitere Anpassungen am importierten Objekt vornehmen. Sie können damit Prozesse starten oder weitere Metadaten setzen.

Beispiel der Funktion „update“

function update(object, rule) {
  // ..
}

Zum Schluss müssen Sie die Funktionen read und update freigeben, damit diese aufrufbar sind:

module.exports = {
  read: read,
  update: update
};

Beispiel eines JavaScripts mit den Funktionen „read“ und „update“ ohne zusätzliche Datei

let InputStreamReader = Packages.java.io.InputStreamReader;
let File = Packages.java.io.File;
let BufferedReader = Packages.java.io.BufferedReader;
let FileInputStream = Packages.java.io.FileInputStream;
let sdf = new Packages.java.text.SimpleDateFormat('dd.MM.yyyy');

// Dieses Script wird für den Export einmal geladen.
// Sie können hier global z.B. auch Globale Daten schon mal einlesen,
// die Sie dann in den beiden Methoden read und update verwenden können

function read(file) {
  
  // Hier eine Beispielimplementierung

  let data = {};
  let f = new File(file);
  
  if (f.exists()) {
    let name = f.getName();
    if (name.indexOf('.') !== -1) name = name.substring(0, name.lastIndexOf('.'));
    data.name = name;
    data.lastmodified = sdf.format(f.lastModified());
    data.size = f.length();
    data.parent = f.getParentFile().getName();
    
    data.src_doctype = 'file';
    
    // special case note
    // data.ac_note = 'A Note Object for: ' + data.name;
    
    return data;
  }
  
  return null;
}

function update(object, rule) {
  
}

module.exports = {
  read: read,
  update: update
};

Beispiel eines Importer-Skripts, bei dem die Infos in einer mitgelieferten JSON-Datei abgelegt sind

let InputStreamReader = Packages.java.io.InputStreamReader;
let File = Packages.java.io.File;
let BufferedReader = Packages.java.io.BufferedReader;
let FileInputStream = Packages.java.io.FileInputStream;

/**
 * internal fields:
 * - ac_ignore: true/false - ignore this file
 * - ac_note: string: Add note to object with the given text
 * - src_doctype: has to be given, is used to identify the rule in the migrariontable
 */
// read in metadata file, contains json
function read(file) {
  let data = {};
  let f = new File(file + '.json');
  if (f.exists()) {
    let stream = new FileInputStream(file + '.json');

    let br = new BufferedReader(new InputStreamReader(stream, 'UTF-8'));
    try {
      let lines = [];

      let line = null;
      while ((line = br.readLine()) !== null) {
        lines = lines.concat(line);
      }
      
      let data = JSON.parse(lines.join('\n'));
      
      data.dmsimporter_createdate = new Date('1978/09/17 12:00:00');
      return data;
    }
    finally {
      br.close();
    }
  }
  else if (new File(file).getName().toLowerCase().endsWith('.not')) {
    return {
      ac_ignore: true
    };
  }
  
  return null;
}

function update(object, rule) {
  // e.g.
  // object.createDate = rule.values.agorum.ac_createdate.value;
  if (rule.values.agorum.dmsimporter_createdate) {
    // throw 'date: ' + JSON.stringify(rule.values.agorum.dmsimporter_createdate);
    object.createDate = rule.values.agorum.dmsimporter_createdate.value;
  }
}

module.exports = {
  read: read,
  update: update
};

Beispiel-Skript für d3

let InputStreamReader = Packages.java.io.InputStreamReader;
let BufferedReader = Packages.java.io.BufferedReader;
let FileInputStream = Packages.java.io.FileInputStream;

/**
 * internal fields:
 * - ac_ignore: true/false - ignore this file
 * - ac_note: string: Add note to object with the given text
 * - src_doctype: has to be given, is used to identify the rule in the migrariontable
 */
// read in jpl an return a map with the data
function read(file) {
  let jplData = {};
  let stream = new FileInputStream(file + '.jpl');
  
  let br = new BufferedReader(new InputStreamReader(stream, 'UTF-8'));
  try {
    let line = null;
    while ((line = br.readLine()) !== null) {
      if (line.indexOf(' = ') !== -1) {
        let name = line.substring(0, line.indexOf(' = ')).toLowerCase();
        let value = line.substring(line.indexOf(' = ') + 4);
        value = value.substring(0, value.length - 1);
        jplData[name] = value;
      }
    }
  }
  finally {
    br.close();
  }
  
  return jplData;
}

module.exports = {
  read: read
};

Mehrere Versionen einer Datei importieren

Sie können eine einzelne Datei in verschiedenen Versionen importieren und diese Versionierung in agorum core nachbilden.

• Alle Versionen dieser Datei müssen in ein und dasselbe Versionsverzeichnis, um verschiedene Versionen einer Datei bereitzustellen.
• Das Versionsverzeichnis muss mit acversion_ beginnen.

Beispiel

• ..../Ordner/acversion_test.txt/
  • test_1.txt
  • test_1.txt.json
  • test_2.txt
  • test_2.txt.json
  • ...

Unterhalb dieses Verzeichnisses liegen die einzelnen Versionen der Datei.

Sie können:

• den Ordner beliebigen benennen, solange er mit acversion_ beginnt
• die darunterliegenden einzelnen Versionsdateien beliebig benennen

Für jede einzelne Versionsdatei muss das Import-JavaScript diese Werte zurückgeben:

• ​​​​​Die Ablage ergibt sich aus der ersten gelesenen Version. Alle anderen Metadaten wie auch der Name ergeben sich aus dem Regelwerk (CSV-Datei + JavaScript).
• Ignorieren Sie beim Definieren des Pfads den Versionsordner, falls die Struktur des Import-JavaScripts auf der eingelesenen originalen Struktur basiert. Ansonsten legt das System diesen Versionsordner ebenfalls an.

Ausschnitt aus dem Beispiel-JavaScript zur Verdeutlichung der Pfad-Operation

// ....
// Achtung: Versionsdateien sind in einem Unterordner, deswegen muss der letzte Ordner ignoriert werden
if (data.ac_version) {
  path = path.substring(0, path.lastIndexOf('/'));
}
// ....

Ein Beispiel für einen Import finden Sie unter Die Filestruktur mit Metadaten aus den Dateinamen importieren.

Die Konfiguration über das User-Interface (UI) anlegen

Für die Konfiguration der Grundeinstellungen des Imports steht ein User-Interface (UI) zur Verfügung.

1. Öffnen Sie links in der Seitenleiste Explorer.
2. Klicken Sie mit der rechten Maustaste auf ein Objekt.
3. Wählen Sie im Kontextmenü dms importer > UI starten.
   
   Ergebnis: Eine Oberfläche öffnet sich, in der Sie:
   
   • eine Import-Datei erstellen
   • alle benötigen Daten eintragen, die das System zum Import von Dateien benötigt

Oberfläche für die Konfiguration

Schaltflächen in der Kopfzeile

Einstellungen

Bereich „Status“

In diesem Bereich starten Sie den Import. Das System gibt Statusinformationen aus, während es den Import ausführt.

Angezeigte Werte

Bereich „Log“

• In diesem Bereich gibt das System das Log aus.
• Das System führt während des Imports das Log mit und gibt es zeitnah aus.
• Sie können dadurch den Stand und Status des Imports mitverfolgen.

Protokoll des Imports

Das System protokolliert den kompletten Import und legt das Protokoll in den Ordner Output folder ab.

Aufbau eines Protokolls

<Pfad des Output folder>/done.txt

<Pfad des Output folder>/error.txt (wird nur erstellt, wenn Fehler vorhanden sind)

<Pfad des Output folder>/audit/audit_dd_MM_yyyy-HH_mm_ss.csv

done.txt

Enthält jede Datei, die das System erfolgreich importiert hat.

Beispiel

/opt/agorum/agorumcore/dmsimporter-demo/import-folder/folder 2/folder 3/folder 4/test4.txt
/opt/agorum/agorumcore/dmsimporter-demo/import-folder/folder 2/test2.txt
/opt/agorum/agorumcore/dmsimporter-demo/import-folder/folder 5/test5.txt
/opt/agorum/agorumcore/dmsimporter-demo/import-folder/test.txt

Anhand dieser Einträge weiß das System bei einer Importunterbrechung, welche Dokumente es bereits importiert hat, und überspringt diese.

error.txt

Enthält Fehlermeldungen, die während des Imports aufgetreten sind. Der Inhalt der Datei ändert sich, wenn Sie die Einstellung Skip errors aktiviert haben.

Einstellung „Skip errors“ aktiviert
In der Datei error.txt stehen alle Fehlermeldungen, die während des Imports aufgetreten sind.


Einstellung „Skip errors“ deaktiviert
Der Import wird durch einen Fehler aufgehalten und zeigt diesen Fehler in der Datei an.

Die Datei ist wie folgt aufgebaut (zur besseren Sichtbarkeit wurde Source File fett dargestellt, die Fehlermeldung normal):

<Source File>
<Fehler-Text>
<Source File>
<Fehler-Text>

Beispiel

/opt/agorum/agorumcore/dmsimporter-demo/import-folder/folder 2/folder 3/test3.txt
Metadatum dmsimporter_dt kann nicht generiert werden es fehlt scr_dt
/opt/agorum/agorumcore/dmsimporter-demo/import-folder/folder 1/test1.txt
Datum ist falsch belegt {"value":"1978-09-17T11:00:00.000Z","type":"date","acMetadata":"dmsimporter_createdate","use":false}

Bereich „audit“

Unterhalb des Ordners audit legt das System eine CSV-Datei an, die das audit-Protokoll enthält.

Der Dateiname basiert auf folgendem Format:

audit_dd_MM_yyyy-HH_mm_ss.csv
Beispiel: audit_09_09_2019-11_06_26.csv

dmsimporter_offernumber (src_offernumber)=38493 dmsimporter_offerdate (src_offerdate)=Sat Sep 21 2019 12:00:00 GMT+0200 (CEST) dmsimporter_doctype=Angebot dmsimporter_customernumber (src_customernumber)=K999 dmsimporter_customername=Kunde 999

Beispiel der Audit-Datei undefined>audit_09_09_2019-11_23_34.csv mit folgendem Inhalt

source name;date;source file;destination name;destionation folder;metadata;systemflags;revision years;success;info
"test3.txt";"09.09.2019 11:23:35";"/opt/agorum/agorumcore/dmsimporter-demo/import-folder/folder 2/folder 3/test3.txt";"?";"?";"";"";"";false;"Metadatum dmsimporter_dt kann nicht generiert werden es fehlt scr_dt"
"test4.txt";"09.09.2019 11:23:35";"/opt/agorum/agorumcore/dmsimporter-demo/import-folder/folder 2/folder 3/folder 4/test4.txt";"An_34343.txt";"Kunden/Testkunde 456/Angebote/2019/09
/Alle Angebote/2019/09";"dmsimporter_offernumber (src_offernumber)=34343
dmsimporter_offerdate (src_offerdate)=Fri Sep 20 2019 12:00:00 GMT+0200 (CEST)
description (src_description1)=Teil 1 Teil 2
dmsimporter_doctype=Angebot
";"";"";true;""
"test2.txt";"09.09.2019 11:23:36";"/opt/agorum/agorumcore/dmsimporter-demo/import-folder/folder 2/test2.txt";"An_98765.txt";"Kunden/Testkunde 456/Angebote/2019/09
/Alle Angebote/2019/09";"dmsimporter_offernumber (src_offernumber)=98765
dmsimporter_offerdate (src_offerdate)=Tue Sep 17 2019 12:00:00 GMT+0200 (CEST)
dmsimporter_doctype=Angebot
";"";"";true;""
"test1.txt";"09.09.2019 11:23:36";"/opt/agorum/agorumcore/dmsimporter-demo/import-folder/folder 1/test1.txt";"?";"?";"";"";"";false;"Datum ist falsch belegt {""value"":""1978-09-17T11:00:00.000Z"",""type"":""date"",""acMetadata"":""dmsimporter_createdate"",""use"":false}"
"test5.txt";"09.09.2019 11:23:36";"/opt/agorum/agorumcore/dmsimporter-demo/import-folder/folder 5/test5.txt";"An_38493.txt";"/Alle Angebote/2019/09";"dmsimporter_offernumber (src_offernumber)=38493
dmsimporter_offerdate (src_offerdate)=Sat Sep 21 2019 12:00:00 GMT+0200 (CEST)
dmsimporter_doctype=Angebot
dmsimporter_customernumber (src_customernumber)=K999
dmsimporter_customername=Kunde 999
";"";"";true;""
"test.txt";"09.09.2019 11:23:37";"/opt/agorum/agorumcore/dmsimporter-demo/import-folder/test.txt";"Re_12345_test.txt";"Kunden/Testkunde 123/Rechnungen/2019/09";"dmsimporter_invoicenumber (src_invoicenumber)=12345
dmsimporter_invoicedate (src_invoicedate)=Tue Sep 17 2019 12:00:00 GMT+0200 (CEST)
dmsimporter_doctype=Rechnung
";"";"";true;""

Verwendbare Metadaten in der CSV-Datei

Globale agorum core-Metadaten existieren, die Sie verwenden können.

Mitgelieferte Beispiele

Der agorum core dms importer liefert Beispiele mit, die die Funktionsweise des Imports vorstellen.