1                     Themenübersicht

Die Aktivitätsdefinition „Automatisierter Import im Hintergrund“ bietet einen automatisierten Datenimport über den Business Integration Service (BIS). Im Unterschied zur Anwendung „Daten automatisch importieren“, die alle in einem Ordner vorgefundenen Dateien importiert, verarbeitet die Aktivitätsdefinition eine Steuerdatei mit einer Liste von zu importierenden Dateien, die sich auch in verschiedenen Verzeichnissen befinden können.

2                     Zielgruppe

• Berater
• Entwickler
• Administratoren

3                     Begriffsbestimmung

Filter

Das BIS-Datenmodell zu einem Business Entity kann sehr umfangreich sein. Ein Filter ist ein Ausschnitt des BIS-Datenmodells zu einem Business Entity. Er definiert, welche Objekte, Attribute und Beziehungen eines Business Entitys bei einem Import- bzw. beim Exportvorgang berücksichtigt werden sollen.

4                     Anwendungsbeschreibung

4.1               Einrichten der Aktivitätsdefinitionen

Die Aktivitätsdefinition „Automatisierter Import im Hintergrund“ (cis.bis.ImportBatch) greift auf eine zweite Aktivitätsdefinition „Importiere eine Datei“ (cis.bis.ImportBatch.job) zu, die die Anwendung „Daten im Hintergrund importieren“ als Hintergrundanwendung aufruft.  Die Aktivität cis.bis.ImportBatch.job wird über ein von cis.bis.ImportBatch ausgelöstes Ereignis gestartet und muss daher über die Anwendung „Aktivitätsdefinitionen aktivieren“ vorher für die gewünschte Ziel-Datenbank auf aktiv gesetzt worden sein, damit der Import tatsächlich stattfindet.

Die in diesem Dokument beschriebenen Beispiel-Aktivitätsdefinitionen finden Sie im Datei-Entwicklungsobjekt „com.cisag.sys.tools.bi.WorkflowBIS“. Diese Aktivitätsdefinitionen werden per Softwareaktualisierung automatisch in Ihr System importiert. Sie müssen die Definitionen lediglich mit dem Exportpräfix Ihres Systems versehen, um sie verwenden zu können. Laden Sie dazu in der Anwendung „Aktivitätsdefinitionen“ die gewünschte Definition und starten Sie die Aktion „Aktivitätsdefinition übernehmen“.

4.2               Erstellen der Steuerdatei

Die Steuerdatei enthält pro Zeile alle Informationen, um eine Datei zu importieren.

Jede Zeile enthält die folgenden, jeweils durch ein Komma getrennten, Einträge:

• Name der Verarbeitungswarteschlange,
• Entweder vollständiger technischer Name des Business Objects oder Name des Filters,
• Import-Format:
• XML_NLS für mehrsprachigen XML-Import,
• XML für einsprachigen XML-Import,
• CSV_CP1252 für CSV-Import mit CP1252,
• CSV_UTF8 für CSV-Import mit UTF8,
• Name der Importdatei. {0} kann als Platzhalter verwendet werden. Komprimierte Dateien (Endung „.gz“) sind zulässig.

Beispiel:

JOBQUEUE01,com.cisag.app.general.obj.Item,XML_NLS,kstore://CFEPERFDV07/Import/XYZ/Item.xml.gz

JOBQUEUE01,com.cisag.app.general.obj.Partner,XML,file:///G:/Imports/XYZ/Partner/Partner.xml.gz

JOBQUEUE03,COUNTRY,XML_NLS,kstore://CFEPERFDV07/Import/XYZ/NewCountries.xml

Die Importvorgänge werden in der Reihenfolge der Steuerdatei in eine Verarbeitungswarteschlange eingelastet. Wenn die Verarbeitungswarteschlange nur einen Worker/Thread hat, dann werden die Importe sequenziell verarbeitet.

Namen einer Importdatei werden mit dem Schema „kstore://“ oder „file:///“ angegeben. Eine Datei mit dem Schema „file:///“ ist allerdings potenziell nicht von jedem Application-Server aus unter diesem Namen zugreifbar.

Enthält der Name einer Importdatei den Platzhalter {0}, so wird dieser zur Ausführungszeit durch das als Parameter angegebene Importverzeichnis ersetzt, s. Abschnitt Vorgehensweisen.

5                     Customizing

Für die Anwendung „Aktivitätsdefinitionen“ sind in der Anwendung „Customi-zing“ keine Einstellungen festzulegen.

6                     Business Entitys

Für die Anwendung „Aktivitätsdefinitionen“ ist das nachfolgende Business Entity relevant, das Sie beispielsweise verwenden, um

• Berechtigungen zu vergeben oder
• Daten zu importieren oder zu exportieren.

Aktivitätsdefinition

com.cisag.sys.workflow.obj.ActivityDefinition

Das Business Entity gehört zu folgender Business-Entity-Gruppe:

Workflowobjekte im Repository

com.cisag.sys.workflow.RepositoryWorkflowObjects

Für die Anwendung „Daten im Hintergrund importieren“ ist das nachfolgende Business Entity relevant.

Filter

com.cisag.sys.tools.bi.obj.FilterDefinition

Allgemein benötigen Sie Änderungsberechtigung für das Business Entity, das Sie importieren möchten.

7                     Berechtigungen

Berechtigungen können sowohl mithilfe der Berechtigungsrollen als auch durch die Zuordnung einer Organisation vergeben werden. Das Berechtigungskonzept können Sie in der Technischen Dokumen­tation Berechtigungen nachlesen.

7.1               Spezielle Fähigkeiten

Für die Anwendung „Aktivitätsdefinitionen“ bestehen keine speziellen Fähigkei-ten.

7.2               Organisations-Zuordnungen

Für die Anwendung „Aktivitätsdefinitionen“ ist eine Organisations-Zuordnung nicht erforderlich.

7.3               Besonderheiten

Für die Anwendung „Aktivitätsdefinitionen“ bestehen keine Besonderheiten.

Für die Anwendung „Daten im Hintergrund importieren“ sind folgende Besonderheiten zu berücksichtigten:

• Um Datenimporte mit gespeicherten Filtern durchzuführen, ist die Fähigkeit „Öffnen“ ausreichend.
• Um einen Datenimport durchzuführen, sind Lese- und Schreibberechtigungen für den Knowledge Store bzw. das Dateisystem erforderlich.

7.4               Berechtigungen für Geschäftspartner

Die Anwendung „Aktivitätsdefinitionen“ ist für Geschäftspartner nicht freigegeben.

8                     Vorgehensweise: Manuelles Starten eines Batch-Imports

1. Öffnen Sie die Anwendung „Aktivitätsdefinitionen“.
2. Laden Sie die Definition cis.bis.ImportBatch für OLTP-Daten.
3. Wählen Sie in der Menüleiste die Funktion „Aktivitätsdefinition ausführen“.
4. Geben Sie im Dialog die Parameter für den Batch-Import an:

• Steuerdatei
  Geben Sie hier den kompletten Pfadnamen der Steuerdatei an, z.B. „kstore://ADV51002/Import/ImportListe.txt“ oder „file:///c:/Import/ ImportListe.txt“
• Import-Verzeichnis
  Hier ist nur eine Eingabe erforderlich, wenn die Steuerdatei mindestens eine Importdatei auflistet, in deren Name der Platzhalter „{0}“ enthalten ist. Geben Sie hier den Ausdruck ein, der den Platzhalter ersetzen soll.
• Benutzer
  Geben Sie hier einen gültigen Benutzernamen an, unter dem die Importaufträge ausgeführt werden sollen.

5. Wählen Sie „Ausführen“.
   • Das System legt für jeden Eintrag in der Steuerdatei einen Verarbeitungsauftrag ein, der gemäß den Hintergrundeinstellungen abgearbeitet wird.
     Die Ergebnisse können Sie wie gewohnt über das Cockpit: Datenaustausch-Protokolleinträge abfragen.