IGEL Schnittstelle

Inhalt

Kurzbeschreibung

Die "IGEL-Schnittstelle" wertet die Daten Ihrer IGEL-Importdateien aus und importiert sie in Ihr FlowFact. Die IGEL-Haus-Importdaten bestehen aus fünf Dateien im Format "CSV", deren Dateipräfix sich nach folgendem Chema aufbaut:

Die folgende Abbildung zeigt ein Beispiel eines Datenblocks:

Installation

Die Installation wird vollautomatisch mit Hilfe des in FlowFact integrierten AddIn-Konfigurators durchgeführt.

  1. Bitte gehen Sie wie folgt vor:
  2. Öffnen Sie FlowFact und klicken Sie im Menü "Extras" auf den Eintrag "AddIn-Konfigurator".
  3. Starten Sie das Live-Update durch Klick auf die gleichnamige Schaltfläche im "AddIn-Konfigurator". Achten Sie darauf, dass Sie dazu über einen Internetzugang verfügen müssen.

  4. Nach erfolgtem Download der aktuellen bzw. neuen AddIns erhalten Sie eine Bestätigung, die Sie bitte durch Klick auf OK bestätigen. Hier sollte bereits Ihre IGEL-Schnittstelle aufgeführt sein. Bitte beachten Sie, dass dieser Eintrag nur dann erscheint, wenn Sie berechtigt sind, das IGEL-AddIn zu verwenden!

  5. Wenn Sie nun im linken Bereich des "AddIn-Konfigurators" auf das Ordnersymbol "Editions" klicken, sollte der Eintrag "IGEL" sichtbar sein (andernfalls fehlt Ihre Nutzungsberechtigung, wie oben erwähnt).
  6. Wählen Sie diesen Eintrag aus und klicken Sie anschließend entweder auf das Kästchen am linken Zeilenrand oder verwenden sie die Schaltfläche "Installieren". Bestätigen Sie die darauf folgende Frage mit "OK".

  7. Sobald die Installation durchgeführt wurde, erhalten Sie eine entsprechende Meldung, die Sie bitte mit OK bestätigen.
  8. Schließen Sie den AddIn-Konfigurator.
  9. Schließen Sie FlowFact und starten Sie FlowFact neu.
  10. Nach dem Neustart von FlowFact befindet sich im Navigator ein neuer Eintrag mit der Bezeichnung "IGEL-Import". Das AddIn ist jetzt funktionsfähig, sodass Sie mit dem Einlesen Ihrer Importdateien beginnen können. Wie das funktioniert, erfahren Sie im nächsten Kapitel.

IGEL Datenimport

Vorbereitungen

Damit das IGEL-AddIn Ihre Importdateien auslesen und verarbeiten kann, müssen Sie Ihren Datei-Datenblock (siehe oben) zuerst in Ihren FlowFact Import-Ordner kopieren. Ist dies nicht der Fall, erhalten Sie eine Fehlermeldung (siehe folgendes Beispiel):

Gehen Sie bitte wie folgt vor:

  1. Erstellen Sie, falls noch nicht vorhanden im Ordner "import" einen Ordner namens "IGEL". Klicken Sie dazu mit der rechten Maustaste zuerst auf eine freie Stelle innerhalb des Ordners "import" und dann auf die Funktion "Neu" -> "Ordner". Benennen Sie den Ordner mit "IGEL":

  2. Öffnen Sie den Ordner "IGEL" und kopieren Sie dort hinein Ihren Datenblock:

Import starten

  1. Öffnen Sie FlowFact und klicken Sie im Navigator auf den Eintrag

  2. Die Schnittstelle beginnt nun zu arbeiten. Meldungen halten Sie auf dem Laufenden:

  3. Sobald sich der Informationsdialog automatisch geschlossen hat, ist der Import beendet. Die  Daten stehen Ihnen nun in FlowFact zur Verfügung. Detaillierte Informationen dazu finden Sie im nächsten Kapitel "IGEL-Daten in FlowFact".

Nach der Übertragung

Sobald der Import abgeschlossen ist, werden Ihre Importdateien (CSV-Dateien) in den automatisch erzeugten Ordner "Save" (im Verzeichnis "import/IGEL") verschoben.

Außerdem finden Sie im Save-Ordner drei neue Dateien:

XXX_import.err

Diese Datei erscheint, wenn während des Imports Fehler aufgetreten sind. Sie können Ihren Standard-Editor verwenden, um die Datei zu öffnen und die dort dokumentierten Fehler zu sichten.

Achten Sie in diesem Zusammenhang bitte darauf, dass das Importieren von IGEL-Daten nur für FlowFact-Administratoren zugelassen ist. Ein Fehlen der Rechte wird ebenfalls in der Err-Datei angezeigt.

XXX_import.log

Diese Datei enthält alle Informationen hinsichtlich der durchgeführten Aktionen.

XXX_import.xml

Diese Datei enthält alle Importdaten und Steuerelemente, die für das Einlesen in die jeweiligen FlowFact Datenbankbereiche notwendig sind.

XXX_import.notfound

Hier werden Felder angezeigt, die in FlowFact noch nicht zugeordnet werden konnten, die sog. dynamischen Felder. Mehr dazu im nächsten Kapitel "IGEL-Daten in FlowFact". Sie können die Datei mit Ihrem Standard-Editor öffnen. Mehr dazu erfahren Sie im nächsten Kapitel.

Dynamische Felder anpassen

Nach dem ersten Import sollten Sie die Datei "XXX_import.notfound" öffnen, um festzustellen, welche Felder (dynamische Feldarten) noch nicht in Ihrem FlowFact zugeordnet werden konnten. Damit die Zuordnung beim nächsten Import erfolgen kann müssen Sie in FlowFact die jeweiligen Feldarten anlegen bzw. anhand einer sog. Mapping-Datei die Zuordnung auf bereits vorhandene Feldarten steuern.

Mehr dazu erfahren Sie aus dem folgenden Beispiel:

Wir gehen einmal davon aus, dass unsere Beispieldatei "XXX_import.notfound" folgende Informationen enthält:

Field|MEA

Field|Hausgeld numlf

Field|BK

Field|Hausgeld umlf

Hinweis:

Die fehlenden Feldarten gehen nicht verloren, d.h. sie werden beim nächsten Import nachgetragen, sofern Sie eine der folgenden Methoden verwenden.

Erste Möglichkeit: neue Feldarten

  1. Sie legen die fehlenden Feldarten "MEA", "Hausgeld numlf", "BK" und  "Hausgeld umlf" nachträglich in FlowFact an. Öffnen Sie dazu das FlowFact-Fenster "Extras/Feldarten":

  2. Klicken Sie dann auf die Neu-Schaltfläche:

  3. Füllen Sie folgende Felder aus:

  4. Tragen Sie im Feld "Namen" den Namen ein, der in der Datei "XXX_import.notfound" aufgeführt wurde, z.B. "MEA".
  5. Tragen Sie im Feld "Gruppen" z.B. den Eintrag "Basis" ein, damit der importierte Wert im entsprechen Feldarten-Register (Feldarten Eingabebereich im Fenster "Objekte") angezeigt wird.
  6. Im Feld "Sortierung" können Sie z.B. "igel" eintragen. Dieser Eintrag ist für eine Änderung der Position im Feldarten-Register (siehe oben) verantwortlich.
  7. Kreuzen Sie "Objekte" im Bereich "Verfügbar" an.
  8. Verwenden Sie die Option "Text" im Bereich "Typ".
  9. Weitere Felder brauchen Sie nicht zu beachten.
  10. Verfahren Sie genauso mit den restlichen Feldarten "Hausgeld numlf", "BK" und  "Hausgeld umlf".

 

Zweite Möglichkeit: auf bestehende Feldarten mappen

Erstellen Sie eine sog. Mapping-Datei und weisen Sie dort die fehlenden Felder bereits vorhandenen Feldarten zu. Gehen Sie wie folgt vor:

<?xml version="1.0" encoding="iso-8859-1"?>

<FFMapping xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <FieldMapping>

    <Map Extern="???" Intern="???" />

    <Map Extern="???" Intern="???" />

  </FieldMapping>

</FFMapping>
 

Darstellung der importierten Daten in FlowFact

Anschließend werden wir Ihnen anhand von Musterabbildungen zeigen, wie sich die importierten Daten in FlowFact präsentieren.

Bitte beachten Sie, dass die Adressen-Daten bei jeder Import-Funktion neu überschrieben werden. Nachträgliche Eingaben gehen somit verloren!

Fenster "Adressen"

Im Fenster "Adressen" befinden sich alle mit IGEL verbundenen Adressen, d.h. alle Objekt-Eigentümer und alle Mieter (sowohl aktive, als auch ehemalige Mieter).

Anhand der Einträge im Feld "Kennung" ersehen Sie den Typ der Adressen (XX = fortlaufende Nummer):

Die folgende Abbildung zeigt eine Eigentümer-Adresse:

Um z.B. alle IGEL-Adressen zu finden, gehen Sie bitte wie folgt vor:

  1. Klicken Sie bitte zuerst auf das Icon der Spezialsuche

  2. Tragen Sie im Feld "Kennung" ein: IG* (das Sternchen ist wichtig, damit alle nachfolgenden Zeichen ignoriert werden).
  3. Bestätigen durch Klick auf  
  4. Verfahren Sie in gleicher Art und Weise, um z.B. alle Mieter oder Eigentümer aufzulisten. Tragen Sie dazu anstatt IG folgende ein:

    IGR*     Objekt (Rootadresse)
    IGE*     für Eigentümer
    IGM*     für Mieter
     

Fenster "Objekte"

Im Fenster "Objekte" werden alle Root- und Haupt-Objekte und deren jeweiligen Einheiten gespeichert. Auch diese Unterscheidungen erkennen Sie an der Kennung (Feld "Kennung"):