TransdatiX.Configurator

Automatisierung von Prozessen mit dem TransdatiX.Configurator

Version 2.0.1.0 vom 03.02.2005

Inhalt

   Einführung
   Definitionen
   Dienste
   Komponenten
   Prozesse
   Profile
   Die Benutzeroberfläche
   Allgemeines
   Prozessparameter
   Dienste
   Die Ausführung eines Prozesses
   Technische Informationen
   Struktur einer .TPF-Datei
   Rechtserklärung

Einführung

TransdatiX kann mehr als nur bloße Datenkonvertierungen zwischen Formaten. Dem Anwender steht mit dem Transdatix.Configurator ein mächtiges aber einfaches Werkzeug zur Verfügung, mit dem er komplexe Abläufe konfigurieren kann.

In der Regel ist die Konvertierung von z.B. CSV-Dateien in EDIFACT nur ein Teil des Prozesses der Datenkommunikation mit Geschäftspartnern. In einem realen Szenario muss man aber eine Reihe von Aufgaben durchführen, damit man wirklich von Automatismus reden kann, z.B:

1.  Datenextraktion
  Die Rechnungsdaten müssen aus den Datenbanken gelesen und in die CSV-Dateien exportiert werden, die TransdatiX.Convert benötigt. Dazu kann man z.B. einen für das (ERP-)System des Anwenders passenden TransdatiX.Adapt verwenden.

2. Konvertierung
  TransdatiX.Convert erledigt die Datenkonvertierung, z.B. Umsetzung der Rechnungsdaten in EDIFACT Rechnungen für Spar (Invoice-Spar.edi).

3. Transport
  Die so generierte EDIFACT-Datei muss nun an den Empfänger übermittelt werden – das kann man mit Hilfe von TransdatiX.Comm durchführen.

4. Dateien sichern
  Nach Übermittlung der Datei möchte man die exportieren Daten in ein Backup-Verzeichnis kopieren, damit man den Sende-Vorgang nachvollziehen kann. Dabei soll auch der Dateinamen mit dem aktuellen Datum ergänzt werden, es wird dann z.B. aus der Datei Invoice-Spar.edi die Datei Invoice-Spar-10.02.2005.edi. Dafür stehen Werkzeuge in TransdatiX.Tool zur Verfügung.

5. Dateien bereinigen
  Die Ausgangsdateien (.EDI) werden nach der erfolgreichen Übermittlung gelöscht.

6. Daten markieren
  Um zu dokumentieren, welche Datensätze aus dem ERP-System bereits übertragen wurden, werden diese dort nach erfolgreicher Übermittlung als "gesendet" markiert. Dafür werden die CSV-Dateien erneut gelesen, und mit Hilfe von TransdatiX.Adapt oder einem Werkzeug aus TransdatiX.Tool erfolgt die Dokumentation direkt im System des Anwenders.

7. Statistik
  Für die bessere Übersicht soll zusätzlich eine Rechnungsliste generiert und am Bildschirm angezeigt oder automatisch als Datei in ein bestimmtes Verzeichnis gespeichert werden. Auch hierfür stehen Werkzeuge in TransdatiX.Convert zur Verfügung.

8. Benachrichtigung
  Nach erfolgreicher Bearbeitung dieser Schritte möchte der Zuständige im Unternehmen über E-Mail informiert werden – das ist mit Hilfe des TransdatiX.Tool E-Mail-Services automatisch möglich.

Die Ausführung der einzelnen Schritte hintereinander ist einfach, erfordert aber manuelle Eingriffe – und bleibt daher fehleranfällig. Das Ziel ist, den gesamten Vorgang über alle Schritte mit einem einzigen Klick auszuführen. Das ist durch Einsatz des TransdatiX.Configurator sehr einfach zu definieren. Er ermöglicht die Definition einer Folge von Aufgaben, die hintereinander in einem Block ausgeführt werden können. Diese Definition wird in der Regel als Datei gespeichert, damit man sie zu einem späteren Zeitpunkt per Doppelklick auf das Icon im Windows-Explorer oder automatisch aus einem Software-System ausführen kann.

Definitionen

Das Beispiel in der Einführung stellt einen Prozess dar. Die unterschiedlichen Aktionen werden mit Hilfe von Diensten erledigt, die sich in Komponenten befinden. Diese Begriffe werden nun genauer erläutert:

Dienste

Ein Dienst ist die kleinste Transformations- oder Datenmanipulationsaktion, die mit einem verwertbaren Ergebnis ausgeführt werden kann. Dienste können sehr einfach sein, wie z.B. das Löschen einer Datei oder komplex wie die Erzeugung einer EDIFACT-Datei aus mehreren CSV-Inputdateien. Die Dienste, die eine Komponente anbietet, werden im TransdatiX.Runtime gezeigt, wie im folgenden Bild zu sehen:

Normalerweise benötigen die Dienste vor der Ausführung zusätzliche Daten, damit sie den Vorgang korrekt erledigen. Diese Daten heißen Parameter. Ein Dienst, der z.B. die Rechnungsdaten von einer Periode aus einer Datenbank extrahiert, benötigt zwei Parameter: Einen für das Von-Datum und den zweiten für das Bis-Datum. Diese Parameter haben Namen, die in der Dokumentation des Diensten beschrieben sind. Softwaresysteme können auf unterschiedliche Arten Dienste parametrisiert ausführen. Hier finden Sie mehr Information diesbezüglich.

Die Ausführung des Dienstes kann auch im interaktiven Modus erfolgen. In diesem Fall werden die notwendigen Parameter abgefragt.


Komponenten

Eine TransdatiX-Komponente ist ein Stück Software, das der Anwender aus der TransdatiX-Homepage herunterladen und installieren kann und stellt beliebig viele Dienste zur Verfügung, um konkrete Aufgaben zu erledigen. Diese Diensten in Komponenten werden je nach Themenbereich gesammelt, so können wir z.B. von E-Mail- oder von Metro-Rechnungs-Komponenten reden. Die Komponenten werden in Dateien mit der Erweiterung .TXF gespeichert und mit dem TransdatiX.Designer erstellt.

Es gibt vier Gruppen von Komponenten: Adapt, Convert, Comm und Tool. Im Folgenden ein Überblick über die wichtigsten Dienste der verschiedenen TransdatiX-Komponenten:

TransdatiX.Adapt
Liest und schreibt Daten in Datenbanken und ERP-Systeme. Folgende Dienste können beispielsweise zur Verfügung stehen:
CheckConnection
Falls die Verbindung zum Anwender-System über ODBC zur Datenbank hergestellt wird, wird diese auf Verfügbarkeit überprüft.
SelectInvoices
Exportiert Rechnungen je nach Kriterium, z.B. unter Eingabe eines Rechnungsbereichs Von/Bis-Datum und speichert sie so, dass sie als Eingabe für TransdatiX.Convert verwendet werden können.
SelectInvoices
Exportiert Rechnungen je nach Kriterium, z.B. unter Eingabe eines Rechnungsbereichs Von/Bis-Datum und speichert sie so, dass sie als Eingabe für TransdatiX.Convert verwendet werden können.
UpdateInvoicesAsSent
Markiert die exportierten und übertragenen Rechnungen als gesendet.
SelectDeliveryNotes
Selektiert Lieferscheindaten nach gewünschten Kriterien und stellt diese im Format für die Bearbeitung durch TransdatiX.Convert zur Verfügung.
InsertOrders
Wenn im Zuge der elektronischen Kommunikation auch Bestellungen empfangen werden, werden diese mit diesem Service importiert.
TransdatiX.Convert
Transformiert Dateien.
ConvertFiles
Wandelt Dateien von einem Format in ein anderes um.
GenerateInvoiceList
Erstellt für Statistikzwecke eine Rechnungslisten-Übersicht.
TransdatiX.Comm
Empfängt oder sendet Dateien.
SendFiles
Sendet Dateien an einen Geschäftspartner. Der Übertragungskanal (E-Mail, ftp, http oder exite) und -parameter sind bereits für den jeweiligen Geschäftspartner vorkonfiguriert.
ReceiveFiles
Empfängt Dateien von einem Geschäftspartner. Der Übertragungskanal (E-Mail, ftp, http oder exite) und -parameter sind bereits für den jeweiligen Geschäftspartner vorkonfiguriert.
TransdatiX.Tool
Erledigen Standardaufgaben, wie z.B.:
COPY
Kopiert Dateien.
DEL
Löscht Dateien.
SendEmail
Verschickt eine E-Mail mit oder ohne Anhang.

Prozesse

Ein Prozess ist eine Kombination von parametrisierten Dienstaufrufen, die hintereinander ausgeführt werden. Das Ziel ist, mit einem einzigen Klick eine ganze Reihe von Aktionen laufen zu lassen. Die Prozesse werden als Datei mit der Erweiterung .TPF gespeichert und können aus dem Windows-Explorer mit einem Doppelklick ausgeführt werden. Die Prozessdateien werden mit dem TransdatiX.Configurator erstellt und dieses Dokument beschreibt, wie dies genau funktioniert. Ein Unternehmen kann beliebig viele Prozesse für die unterschiedlichsten Zwecke definiert, wie folgende Grafik zeigt:

Prozesse erlauben den gleichen Parametrisierungsgrad wie die Dienste. Prozesse können nicht nur Dienste, sondern andere Prozesse und Profile beinhalten.

Profile

Ein Profil ist ein Prozess mit einen einzigen Dienst und dient dazu, manche fixe Parameter für den Dienstaufruf vorzubelegen. Beispiel: Die TransdatiX.Comm E-Mail-Komponente stellt einen Dienst namens SendEmail zur Verfügung, mit welchem man eine E-Mail mit Anhang verschicken kann. Wenn man eine Datei – z.B. eine EDIFACT-Rechnungsdatei – an einen konkreten Partner schicken möchte, müsste man immer bei der Verwendung des Dienstes die Empfängeradresse des Partners eintragen, was in vielen Fällen nicht sofort bekannt ist. Um dies dem Anwender zu ersparen, wurde ein Prozess mit dem SendEmail-Dienst generiert, welcher sofort in andere Prozesse integriert werden kann.

Die Profile werden ständig erweitert und liegen normalerweise im Verzeichis /Profiles der jeweiligen Komponente. Ein Beispiel über die Profile, die für die Kommunikation mit der hogast zur Verfügung stehen, ist:

Die Benutzeroberfläche

Der TransdatiX.Configurator besteht aus drei Bereichen: Allgemeines, Parameter und Dienste.

Allgemeines

Mit diesen Angeben legt man fest, wie sich der Prozess während der Ausführung verhalten soll. Sie definieren beispielsweise, ob Meldungen am Bildschirm angezeigt oder unterdrückt werden, ob der Anwender während des Ablaufs die Parameter noch verändern darf oder ob während der Ausführung Fortschrittsinformationen angezeigt werden sollen.

Der Button Ausführen dient dazu, den Prozess für Testzwecke auszuführen.

Prozessparameter

Wenn mehr als ein Dienst den gleichen Parameter benötigt, kann man diesen hier eintragen. Dazu gehören beispielsweise die GLN-Nummer des eigenen Unternehmens oder das Dateiverzeichnis auf dem Filesystem, in dem temporäre Dateien abgelegt werden (Temp-Verzeichnis). Diese Prozessparameter stehen in allen Diensten zur Verfügung.

Folgendes Bild zeigt die Definition von drei Parametern: @VonDatum und @BisDatum wurden als Abfrageparameter definiert, weil sie als Anzeigen markiert sind. Der Parameter @EdiDatei (Name der generierten Datei für die EDIFACT-Rechnung) agiert als Konstante, da er verborgen ist, d.h. er wird nicht zur Laufzeit abgefragt und kann daher auch nicht geändert werden. In der Spalte Defaultwert gibt man entweder den Wertvorschlag bei Abfrageparametern oder den fixen Wert bei Konstanten ein.


Dienste

Hier werden die Reihenfolge, in welcher Dienste ausgeführt werden sollen, und die für die Ausführung erforderlichen Eingabewerte (Parameter) definiert. Mit dem Button Hinzufügen fügen Sie einen neuen Dienst in die Liste hinzu. Mit den Pfeilen können Sie die Reihenfolge der Ausführung definieren.

TransdatiX.Configurator registriert automatisch, welche Parameter der entsprechende Dienst benötigt – diese werden im unteren Bereich angezeigt. Hier können Sie den Wert des Parameters setzen. Die Checkbox rechts von den Parametern gibt an, ob der Parameter zur Laufzeit abgefragt werden soll oder nicht.

Das Beispiel in der nächsten Grafik zeigt einen Prozess über vier Dienste. Der zweite Dienst erwartet eine Eingangsdatei, die in diesem Fall mit D:\Import\Metro\Rechnung.xml vorbelegt wurde. Da dieser Parameter aber abgefragt wird, kann er vom Anwender nachträglich geändert werden. Der zweite verborgene Parameter erhält seinen Wert aus dem Prozessparameter @EdiDatei, den man bereits definiert hat.

Prozessparameter sollten definiert werden, wenn Parameter von zwei oder mehreren Diensten den gleichen Wert benötigen. In unserem Fall dient der Parameter @EdiDatei auch als Wert für den Dateinamen im dritten Dienst.

Die Ausführung eines Prozesses

Wenn die Konfiguration des Prozesses abgeschlossen ist, kann der vordefinierte Ablauf als .TPF-Datei gespeichert werden. Das empfohlene Verzeichnis, in welchem die Prozesse abgelegt werden sollen, lautet \Processes im TransdatiX-Programmverzeichnis:

Mit einem Doppelklick kann der Anwender einen Prozess ausführen. Sind Abfrageparameter vorhanden (weil sie so konfiguriert wurden), werden diese zur Laufzeit abgefragt:

In der Regel wird dann die Fortschrittsmaske angezeigt. Damit wird der Anwender über den prozentuelle Fertigstellungsgrad der Dienste und des gesamten Prozesses informiert:

Sind die Benachrichtigungen über Meldungsfenstser nicht ausgeschaltet, erhält der Anwender bei korrektem Ablauf des Prozesses folgende Meldung:


Technische Informationen

Struktur einer .TPF-Datei

TPF-Dateien sind Textdateien im XML-Format, die mit jedem Text-Editor geöffnet und manuell bearbeitet werden können. Folgendes Beispiel – mit dem sich der Anwender aber dank TransdatiX.Configurator nicht auseinander setzen muss – zeigt den Inhalt einer TPF-Datei, die Rechnungsdaten aus Mesonic liest und in EDIFACT-Metro Invoice umwandelt:

<?xml version="1.0"?>
<Root>
  <ParameterFile>
    <Silent>0</Silent>
    <NoSplash>1</NoSplash>

    <!-- Datenextraktion mit dem Mesonic-Adapt für Metro, 
        parametrisiert nach Datumsbereich -->
    <Interface>
      <FileName>Applications\Adapt\Mesonic\Adapt.Mesonic.txf</FileName>
      <InterfaceName>SelectInvoices</InterfaceName>

      <InterfaceParameter>
        <Name>@Partner</Name>
        <Value>METRO</Value>
        <Visible>0</Visible>
      </InterfaceParameter>

      <InterfaceParameter>
        <Name>@FromDate</Name>
        <Description>Rechnungen von Datum</Description>
        <Visible>1</Visible>
      </InterfaceParameter>

      <InterfaceParameter>
        <Name>@ToDate</Name>
        <Description>Rechnungen bis Datum</Description>
        <Visible>1</Visible>
      </InterfaceParameter>

      <InterfaceParameter>
        <Name>@OutputFile1</Name>
        <Value>D:\Temp\Invoice-Mesonic.xml</Value>
        <Visible>0</Visible>
      </InterfaceParameter>

    </Interface>

    <!-- Datenkonvertierung in EDIFACT-Invoice -->
    <Interface>
      <FileName>
        Applications\Convert\Metro\Invoice\Convert.Metro.Invoice.txf
      </FileName>
      <InterfaceName>ConvertFiles</InterfaceName>

      <InterfaceParameter>
        <Name>@InputFile1</Name>
        <Value>D:\Temp\Invoice-Mesonic.xml</Value>
        <Visible>0</Visible>
      </InterfaceParameter>

      <InterfaceParameter>
        <Name>@OutputFile1</Name>
        <Value>D:\Temp\Invoice-Mesonic.edi</Value>
        <Visible>0</Visible>
      </InterfaceParameter>
    </Interface>
  </ParameterFile>
</Root>
            

Die Erstellung und Bearbeitung der .TPF-Dateien ist die Aufgabe von TransdatiX.Configurator. Sie können jedoch, wenn Sie möchten, die Prozessdefinition manuell in einem Texteditor bearbeiten.


Rechtserklärung

Alle Informationen in diesem Dokument werden ohne Abgabe von Garantien, welcher Art auch immer, zur Verfügung gestellt. MicroTown Software lehnt alle Haftungsansprüche, ausdrückliche oder implizite, einschließlich Ansprüchen bezüglich Verkaufbarkeit und Eignung für bestimmte Zwecke, ausdrücklich ab. In keinem Fall kann MicroTown Software oder ihre Lieferanten für irgendwelche Schäden, die direkt oder indirekt, zufällig oder als Folgeschaden auftreten, verantwortlich gemacht werden. Insbesondere sind Geschäftsverluste, Datenverluste oder spezielle Schäden von Haftungsansprüchen explizit ausgeschlossen, auch wenn MicroTown Software oder ihre Lieferanten auf die Möglichkeit derartiger Schäden hingewiesen haben. In jedem Fall werden Haftungsansprüche bis zum gesetzlich höchstmöglichen Ausmaß abgelehnt.


© 2005 MicroTown Software - www.transdatix.com