Datei Busitec.Dms.Utilities.Importer.config

Diese Datei enthält die Basiskonfiguration des Importermoduls, welches für die Verknüpfung von SAP Business One Daten zu ELO Dokumenten verwendet wird und das nach Dokumenten in ELO sucht. Diese Einstellungen werden automatisch gesetzt und auch geändert. Änderungen sollten, wenn überhaupt, nur über den MARIProject Konfigurationsdialog erfolgen.

In dieser, wie auch allen weiteren Dateien, finden sich XML Kommentare, welche die Einstellungen der einzelnen Elemente genauer beschreiben. Daher wird in diesem Handbuch nur grundsätzlich auf die Möglichkeiten eingegangen, welche für einen Regelbetrieb notwendig sind.

TargetUserGroup

Der Name der ELO Gruppe, in welcher ein Anwender Mitglied sein muss, um die Importerschnittstelle nutzen zu können.

Importers

Eine Liste der verfügbaren Importerkonfigurationen.

IndexingProfiles

Eine Liste der Archivierungsprofile, welche zur Ablage von Dokumenten genutzt werden können.

SearchProfiles

Eine Liste von Suchprofilen, mit denen nach Dokumenten gesucht werden kann.

 

Die Profile enthalten im wesentlichen Zuordnungen von Daten, die durch SAP Business One zur Verfügung gestellt wurden, auf ELO Verschlagwortungsfelder. Die übrigen Einstellungen eines Profils bestimmen die zu verwendende Ablagemaske, die Zuordnung auf Standardmaskenfelder und, bei den Ablageprofilen, die Ablagepfadregel und ein Filterkriterium für die Regelauswahl.

Die Werte für ein abzulegendes Dokument werden von SBO an das Importermodul in einem Datencontainer übergeben, der Schlüsselwerte zu Datenwerten zuordnet. Die Schlüsselwerte in der Konfiguration sollten daher nicht geändert werden, da diese durch SBO vorgegeben sind. Im schlimmsten Fall kann die Zuordnung von Werten aus SBO zur ELO Verschlagwortung nicht mehr durchgeführt werden und das Dokument wird fehlerhaft archiviert.

Eine individuelle Erweiterung um zusätzliche Profile ist möglich. Damit können kundenspezifische Sonderfälle bei der Ablage von Dokumenten abgebildet werden (z. B. eine Sonderbehandlung für Dokumente, die einem Projekt zugeordnet sind).

Mit Hilfe von regulären Ausdrücken lassen sich sehr spezielle und komplexe Anforderungen umsetzen. Eine Einführung in reguläre Ausdrücke ist verfügbar unter http://www.regular-expressions.info/reference.html.

Um ein eigenes Ablageprofil (IndexingProfile) zu konfigurieren, folgen Sie diesem Ablauf:

• Ändern Sie nicht die verwendeten Datenschlüssel (dataKey).

• Die Reihenfolge der Profile ist entscheidend. Es wird das erste Profil aus der Konfiguration verwendet, bei dem die definierten Filterregeln erfüllt sind. Daher sollten spezialisierte Profile zuerst in der Konfiguration stehen, generalisierte Profile am Ende.

• Kopieren Sie ein existierendes IndexingProfile Element und fügen es an die passende Stelle innerhalt des IndexingProfiles Elements ein.

• Passen Sie das Profil an die individuellen Anforderungen an. Dabei sind Änderungen an den folgenden Elementen sinnvoll:

• Name der Ablagemaske (<MaskName>)

• Benennungsregel für das Dokument (<NamePattern>; vgl. Beispielkonfigurationsdatei): Über ein zusätzliches Element <EnableMultiValue> mit dem Wert true werden die Felder, die mit mehr als einem Wert belegt sind, mit allen Werten in die Verschlagwortung aufgenommen.

• Archivierungspfad (<ArchivePathPattern>; vgl. Beispielkonfigurationsdatei)

• Zuordnung von Verschlagwortungswerten aus dem Datencontainer zu Verschlagwortungsfeldern der Ablagemaske (Attribut fieldId in <IndexMapping>)

• Stellen Sie sicher, dass die konfigurierten Felder in der Ablagemaske existieren, andernfalls können die Werte nicht zugeordnet werden.

• Ordnen Sie den dataKey Werten den passenden fieldId zu und entfernen Sie ggf. überflüssige dataKeys.

• Stellen Sie sicher, dass alle Pflichtfelder der Maske gefüllt werden (Datenintegrität) und dass alle Werte vorhanden sind, die zur Bildung der Namensregel und der Ablagepfade notwendig sind; andernfalls kann das Dokument nicht korrekt archiviert werden.

• Das Attribut appendData steuert das Verhalten beim Nachverschlagworten von Dokumenten, die bereits im Archiv liegen. Hat das Attribut den Wert true, wird der neue Wert, der mit dem Datencontainer übergeben wird, als zusätzlicher Wert an das Feld angehangen.

• Dublettenbehandlung (<DuplicateIdentifiers> und <DuplicateHandling>; vgl. Beispielkonfigurationsdatei)

• Filterkriterien (vgl. Beispielkonfigurationsdatei)

• <FilterValueKey> und <FilterValuePattern> für ein einzelnes Filterkriterium

• <FilterCriteriaList> für mehrere Filterkriterien

• Falls nötig, halten Sie die individuellen Ablageprofile mit anderen Konfigurationen (zum Beispiel Business Template) konsistent

Die Suchprofile sind stark von SBO anhängig und sollten nicht geändert werden, da ansonsten die Suchfunktionalität aus SBO u. U. nicht mehr lauffähig ist! Individuelle neue Suchprofile werden von SBO nicht erkannt und verwendet. Eine Veränderung der vordefinierten Suchprofile kann das Verhalten der Anwendung verändern und/oder zu Fehlern führen.