XML-Import

XML-Import

Der Autoimport über XML-Dateien ermöglicht anderen Programmen, automatisiert auf EuroKass zuzugreifen. So können bspw. einzelne Buchungen oder Stapel von Buchungen per XML-Datei in EuroKass importiert werden. Eine weitere Möglichkeit besteht in der Ausführung von InterRun-Programmen. Dadurch haben Sie Zugriff auf den gesamten Funktionsumfang von EuroKass und InterRun.

Der Import aus anderen Programmen ist nicht als einmalig sondern als permanent anzusehen. Programme, die kein eigenes Kassenbuchmodul besitzen, können also die Dienste von EuroKass in Anspruch nehmen und so eine Lücke in ihrem eigenen Angebot schließen.

Ablauf
Der Ablauf des Imports erfolgt über den Dateiaustausch per XML-Datei. Der Aufbau einer XML-Datei entspricht den üblichen Standards. EuroKass sucht permanent in zyklischen Abständen in einem von Ihnen festgelegten Verzeichnis nach XML-Dateien. Findet EuroKass solche Dateien, wird immer die älteste Datei gelesen, ausgeführt, evtl. archiviert und anschließend gelöscht. Kommt es bei der Ausführung zu syntaktischen oder logischen Fehlern, wird die Interpretation abgebrochen und die Datei optional in ein Fehlerverzeichnis kopiert.

Steuerdateien
Durch Erzeugen einer Steuerdatei mit gleichem Dateinamen aber anderer Dateiendung kann sichergestellt werden, dass die eigentliche XML-Datei nicht schon während des Schreibens über das Fremdsystem durch EuroKass gelesen wird. Ein Beispiel: es soll die Datei Import.xml importiert werden. Erzeugen Sie zunächst eine leere Steuerdatei Import.sta, dann die eigentliche XML-Datei Import.xml und löschen Sie anschließen die Datei Import.sta. EuroKass ignoriert also Dateien, wenn diese ebenfalls mit der Dateiendung sta existieren. Die Dateiendung sta kann frei definiert werden.

Dateiaufbau
Der Aufbau einer XML-Datei hat mindestens folgende Struktur:
<EuroKass>
</EuroKass>
Im ersten Level muss das Item "EuroKass" stehen. Fehlt dieses, wirft EuroKass einen Fehler aus und bricht die Bearbeitung ab.

Buchungen importieren

Zur Erzeugung einer einfachen Buchung wird folgende Struktur verwendet:

<EuroKass>
<NewBookings>
   <NewBooking>
   <ID V="" />
   <Date V="2006-12-30" />
   <SourceAccount V="Kasse" />
   <TargetAccount V="Getränke" />
   <Value V="48.22" />
   <Description V="Sommerfest" />
   <Categories V="Ausgaben,Verzehr" />
   </NewBooking>
</NewBookings>
</EuroKass>

Hinweis: Der Block <NewBooking></NewBooking> ist beliebig wiederholbar.

Zur Erzeugung einer Splitbuchung mit zwei Buchungen wird folgende Struktur verwendet:

<EuroKass>
<NewBookings>
   <NewBooking>
   <Splitting V="True" SplitAccount="TargetAccount" />
   <ID V="" />
   <Date V="2006-12-30" />
   <SourceAccount V="Kasse" />
   <TargetAccount V="Getränke" />
   <Value V="48.22" />
   <Description V="Sommerfest" />
   <Categories V="Ausgaben,Verzehr" />
   </NewBooking>
   <NewBooking>
   <Splitting V="True" SplitAccount="TargetAccount" />
   <ID V="" />
   <Date V="2006-12-30" />
   <SourceAccount V="Kasse" />
   <TargetAccount V="Lebensmittel" />
   <Value V="214.80" />
   <Description V="Anzahlung Fleischerei" />
   <Categories V="Ausgaben,Verzehr" />
   </NewBooking>
</NewBookings>
</EuroKass>

Eigene Felder einer Buchung werden über den Block <UserFields> angesprochen:

<EuroKass>
<NewBookings>
   <NewBooking>
   <ID V="" />
   <Date V="2006-12-30" />
   <SourceAccount V="Kasse" />
   <TargetAccount V="Getränke" />
   <Value V="48.22" />
   <Description V="Sommerfest" />
   <Categories V="Ausgaben,Verzehr" />
   <UserFields>
   <UserField Index="0" V="4" />
   <UserField Index="1" V="66,22" />
   </UserFields>
   </NewBooking>
</NewBookings>
</EuroKass>

Adressen importieren

Zur Erzeugung einer Adresse wird folgende Struktur verwendet:

<EuroKass>
<NewContacts>
   <NewContact>
   <PictureFileName V="C:\Bild.bmp" />
   <UserID V="1" />
   <MembershipNumber V="55" />
   <Title V="Dr." />
   <FirstName V="Udo" />
   <SecondName V="" />
   <NickName V="udoflamme" />
   <LastName V="Flamme" />
   <MaidenName V="" />
   <DateOfBirth V="1963-01-19" />
   <Characteristics V="Augenfarbe blau" />
   <SSN V="123456789" />
   <Salutation V="Sehr geehrter Herr Flamme" />
   <Company V="Firma XY-GmbH" />
   <ContactPerson V="Frau Grossmann" />
   <Department V="Werbung" />
   <Notes V="Meldet sich wieder..." />
   <Hobbys V="Segeln" />
   <Checked V=true />
   <Degree V="Dr." />
   <FormOfAddress V="Herr" />
   <Sex V="männlich" />
   <MaritalStatus V="Verheiratet" />
   <NativeLanguage V="deutsch" />
   <Nationality V="Deutschland" />
   <Religion V="rk" />
   <ReligionAffiliation V="" />
   <Mobility V="Auto" />
   <Job V="Handelsvertreter" />
   <Emails>
   <Email>
   <Address V="udo.flamme@firma.de" />
   <Description V="" />
   <Type V="geschäftlich" />
   </Email>
   </Emails>
   <Phones>
   <Phone>
   <DailingCode V="0201" />
   <PhoneNumber V="110 55 824" />
   <OutsideLine V="" />
   <Description V="von 8:00 bis 16:30" />
   <Type V="geschäftlich" />
   </Phone>
   </Phones>
   <Banks>
   <Bank>
   <AccountNumber V="6070809010" />
   <SortNumber V="200 300 40" />
   <Name V="Bank" />
   <Description V="" />
   <Type V="Firmenkonto" />
   </Bank>
   </Banks>
   <Links>
   <Link>
   <Address V="www.firma.de" />
   <Description V="Homepage" />
   <Type V="geschäftliche Internetseite" />
   </Link>
   </Links>
   <Addresses>
   <Address>
   <Description V="Hauptwohnsitz" />
   <Floor V="" />
   <Room V="" />
   <Street V="Am Rosengarten 15" />
   <PoBox V="" />
   <ZipCodePoBox V="" />
   <ZipCode V="45127" />
   <City V="Essen" />
   <Country V="Deutschland" />
   <Department V="NRW" />
   <Notes V="Keine" />
   <Emails>
   <Email>
   <Address V="familieflamme@provider.de" />
   <Description V="keine" />
   <Type V="privat" />
   </Email>
   </Emails>
   <Phones>
   <Phone>
   <DailingCode V="0201" />
   <PhoneNumber V="445566" />
   <OutsideLine V="0" />
   <Description V="ab 20 Uhr" />
   <Type V="privat" />
   </Phone>
   </Phones>
   <Banks>
   <Bank>
   <AccountNumber V="1020304050" />
   <SortNumber V="100 200 30" />
   <Name V="Bank" />
   <Description V="" />
   <Type V="Gehaltskonto" />
   </Bank>
   </Banks>
   <Links>
   <Link>
   <Address V="www.udoflamme.de" />
   <Description V="Homepage" />
   <Type V="private Internetseite" />
   </Link>
   </Links>
   </Address>
   </Addresses>
   </NewContact>
</NewContacts>
</EuroKass>

Hinweis: Die Blöcke <NewContact></NewContact>, <Email></Email>, <Phone></Phone>, <Bank></Bank>, <Link></Link>, <Address></Address> sind beliebig wiederholbar.

Termine importieren

Zur Erzeugung eines neuen Termins wird folgende Struktur verwendet:

<EuroKass>
<NewAppointments>
   <NewAppointment>
   <GUID V="" /> (Nur, wenn vorhandener Termin überschrieben werden soll)
   <Name V="Neuer Termin" />
   <Description V="Beschreibung des Termins" />
   <FamilyGUID V="55C34ADDA72E40A8BA31C7664678A68B" /> (Nur bei Terminketten)
   <BeginDateTime V="2009-06-30T08:15:00" />
   <EndDateTime V="2009-06-30T09:15:00" />
   <City V="Hamburg" />
   <ContactGUID V="" /> (GUID aus der Adressverwaltung)
   <AddressGUID V="" /> (GUID aus der Adressverwaltung)
   <ActiveReCall V="True" />
   <ReCallDateTime V="2009-06-30T07:15:00" />
   <ReCallSoundFile V="C:\Windows\Media\Beep.wav" />
   <ReCallProgramFile V="C:\ProgramFile.exe" />
   <ReCallMessageBox V="True" />
   <UserColor V="0" />
   <SymbolDisplayMode V="0" /> (Mögliche Werte = 0..7)
   <Creator V="" />
   <CreatorGUID V="" /> (GUID aus der Adressverwaltung)
   </NewAppointment>
</NewAppointments>
</EuroKass>

Hinweis: Der Block <NewAppointment></NewAppointment> ist beliebig wiederholbar.

InterRun-Programme
Der XML-Import unterstützt eine InterRun-Schnittstelle, die wie folgt angesprochen wird:

<EuroKass>
<InterRun>
   <Source>ShowMessage('Test')</Source>
</InterRun>
</EuroKass>

Über InterRun könnten z.B. Auswertungen in EuroKass durchgeführt und anschließend in eine Datei gespeichert werden um diese einem anderen Programm zur Verfügung zu stellen.

<EuroKass>
<InterRun>
   <Source>
   var S : String
   s = FloatToStr(Filter(0).Sum)
   SaveTextToFile("C:\Export.txt",s)
   </Source>
</InterRun>
</EuroKass>