Import

Konfigurierbarer Import (30.04.01,22.05.01,02.07.02)

Was ist ein Import: Beim Import-lauf werden Auftragsdaten in GaZMa zur
Weiterverarbeitung eingelesen. Ab dem Import-zeitpunkt wird nur noch im GaZMa
gearbeitet. �nderungen in der excel(csv) Datei (das ist die Datenquelle f�r GaZMa)
k�nnen nicht mehr nachimportiert werden.

Im Hauptmen�: "Projekt Import". Vor jedem Import sollte die entsprechende Baustelle
angelegt sein. Jetzt kann jede beliebige csv-Datei Importiert werden.
Dabei m�ssen GaZMa-Datendfelder (ganz linke Spalte) den csv-Datenfeldern (ganz
rechts) zugeordnet werden. Die Zuordnungen werden in der Mitte angezeigt. Beachten
Sie da� z.B. das Feld "Ort" in GaZMa ein einzelenes Datenfeld ist. In Excel kann
es jedoch aus dem Feld (PLZ) und (Ort-Name) gezogen werden. Dieser Umstand ist durch
die Nummernsymbole in den GaZMa Feldnamen angezeigt. (Ort_#_#) bei der Zurodnung
m�ssen dann 2 Parameterzeilen mit Feldern aus der csv gef�llt werden.
Also Beispiel wurde KA01 angelegt.

 Beispielhafter Ablauf f�r einen Import:

1) Schema laden: Taste "->" ganz oben neben "Schema (*.gzs)" dr�cken. "ka01"
   w�hlen.
   Schemen befinden sich in .\GaZMa\Schemen
   csv-Datei befinden sich in .\GaZMa\Rohstoffe
2) auf der rechten seite pr�fen, ob die richtige Import-Datei ausgew�hlt
   wurde (Der Name der Importdatei wird bei der Speicherung eines Schemas
   mit abgespeichert. Wollen Sie, da� der aktuelle Dateiname zusammen mit dem
   Schema gespeichert wird, so dr�cken Sie die Taste speichern).
   Bleibt die Tabelle verf�gbare Felder leer, so wurde die im Schema angegebene
   Datei nicht gefunden.
3) Eine Baustelle angeben. Dies erfolgt mit Hilfe einer Baustellen-Nummer, des
   sogenannten RIDs (Referenz IDentifikation). Diese Nummer finden sie ganz links
   in der Tabelle aller Baustellen mit der Tabellen�berschrift RID. Die Auflistung
   aller Baustellen erhalten Sie, wenn Sie im Hauptmen� die Taste "Baustelle"
   dr�cken. Mehr Infos auf in der Rubrik "Baustelle".
4) "Start" im umrahmten Feld "Import durchf�hren" dr�cken.

 Beispielhafter Ablauf f�r eine Import-Schema-Definition:

1) ev. ein Schema das �hnlich ist laden, oder ganz neu beginnen.
2) rechts neben "Quelle (csv-Datei)" die Taste "->" dr�cken. Die neue
   csv-Datei anw�hlen.
3) in der ganz rechten Tabelle m�ssen nun alle Feld-Namen erscheine.
4) wenn Sie auf einzelne Feld-Namen klicken, sollte in der tabelle darunter
   Beispiel-Daten f�r das jeweilige Feld erscheinen.
5) Nun beginnen sie mit der Feldzuordnung. Dazu ein GaZMa-Feld aus der Tabelle
   ganz links ausw�hlen, und Taste "->" dr�cken. Das Feld erschein nun in der
   Mittleren Tabelle. Diese Feld nun anklicken. Es erscheint unter der Mittleren
   Tabelle die "Parameter-Zuordnung". W�hlen Sie von der Quelle ein Datenfeld aus
   das passt. nun die taste "<-" rechts neben den jeweiligen Parameter (#1,#2,#3)
   Der parameter wurd in die mittlere Tabelle �bernommen (als Zahl, die echten Feld
   namen spielen keine rolle).
6) Das Schema sollte man von Zeit zu Zeit speichern.
7) Die Felder mit "_Info_#" (im Moment nur eines) k�nnen Sie mehrfach verwenden. Schauen
   Sie sich das Beispiel "KA01.gzs" an.
   Im ersten Parameter k�nnen Sie einen Text eingeben, z.B. "Standort", der 2. Parameter
   ist eine ganz normale Angabe f�r eine Quell-Spalte. Wird der Import durchgef�hrt, so
   werden die Daten in ein Textfeld mit dem Vorsatz "Standort_" importiert. Beispiel:

   Monteur_Info_#_#(Standort,30)

   #1 Standort
   #2 30

   Feld 30 wird als Text "Standort_Hier der Text" in das Memofeld Monteur-Info
   importiert. Steht hier z.B. "Keller", wird es als Standort_Keller importiert.
   Beim Import kann man auch mal einen Parameter frei lassen, es wird
   dann einfach "nix" importiert!

8) Jeder Zeit k�nnen Sie einen Import starten. Das Ergebnis l�sst sich im
   Termin-Arbeitsplatz begutachten.
   Einzelne Import-L�ufe kann man "r�ckg�ngig" machen, indem man den
   Import-RID notiert oder aus den Auftragsdaten ermittelt, und sp�ter
   wieder alle Datens�tze mit diesen RIDs l�scht.
9) Infos �ber den jeweiligen Import werden im Verzeichnis .\Importe abgelegt, hier
   werden daten, das schema und zus�tzliche Infos zu jedem einzelnen Import ab-
   gelegt.

 Neue csv-Dateien, bedeutet das immer neue Schemen?

NEIN. Da das Format ev. immer leicht variiert m�ssen vorhandene Schemen ev. leicht abge�ndert
werden. Mit jeder neuen Datei k�nnen auch neue Anforderungen entstehen. GaZMa ist hier
flexibel, bitte in diesem Fall das Schema (?.gzs) und die csv-Datei an Andreas Filsinger
mailen. �ndert sich das Format nicht (nur die Dateninhalte) bleibt das Schema immer
gleich.

Bemerkungen zum Import (11.06.01,02.07.01,28.08.01)

* unwichtige Z�hler Infos (die weder auf dem Protokoll noch auf der Termin-Planungs
  Anzeige gebraucht wird) sollten in die Intern-Infos importiert werden. Diese sind
  dann zwar noch abrufbar, jedoch belasten sie nicht die Word-Datei und die Listenanzeige.
* nach einem Import immer mal die Daten in der Liste anzeigen lassen. Dabei vor allem
  auch mal auf die Z�hler-Infos umschalten, ob alles gut sichtbar ist. Wenn nicht sollte
  die Import-Reihenfolge anders aufgeteilt werden.
* �ber die Z�hler-Infos 1..9 sollte ein Einvernehmen herrschen was z.B. Z�hler-Info
  3 (=3.Zeile) in der Regel zu bedeuten hat. Damit die Serienfelder der Protokolle
  in der Regel so bleiben k�nnen wie immer.
* Liegt bei einem Import nur eine Adresse vor, so sollte diese innerhalb des Schemas
  dennoch "2x" importiert werden, zum einen in "Z�hler_Ort_..." sowie in "Kunde_Brief_...".
* Ein Import ist nicht m�glich, wenn die csv-Datei bereits doppelte Z�hlernummern enth�lt!
  Man muss diese per Hand in der CSV-Datei suchen, und manuell entscheiden welches der
  richtige Datensatz ist. Handelt es sich um unbekannte Nummern muss eine Phantasie-
  nummer in die csv eingetragen werden. Oder Doppelte Nummern mit "a" und "b" am Ende
  unterscheidbar gemacht werden.
  Die maximale L�nge einer Z�hlernummer ist 15 Stellen. Ist die Nummer in der csv l�nger,
  so werden nur die ersten 15 Stellen verwendet.
* Werden Monteurnamen importiert, so muss genau das K�rzel des Monteurs angegeben werden.
  Sogar Gross- und Kleinschreibung spielt eine Rolle.

Nachtr�glicher Import von Z�hler-Infos (12.06.01,02.07.01)

Zweck: Hier k�nnen Sie in GaZMa schon vorhandene Daten mit "neuen" Z�hler-Infos �berschreiben.
Dabei werden alle bisherigen Z�hler-Infos durch den neuen Import �berschrieben. Alle
anderen Daten (Termin, Sperren, AB-Nummer) bleiben erhalten. Das �berschreiben kann
nicht r�ckg�ngig gemacht werden, aber mehrmals wiederholt werden.

1) legen Sie eine neue (Dummy- oder Test-) Baustelle an (="neue Baustelle").
2) Optimieren Sie das Import-Schema bis alles stimmt und verwenden Sie f�r den
   Import jeweils diese neue Testbaustelle.
3) Wenn alle Z�hler-Infos stimmen, w�hlen Sie im Men� "Baustelle", klicken Sie auf die
   fehlerhafte Baustelle -> nun auf den Reiter "Korrektur" nun den RID der
   "neuen Baustelle", nun den Knopf "Nachtr�gliche Z�hler Info Korrektur".
4) pr�fen Sie das Ergebnis
5) l�schen Sie alle Daten der "neuen Baustelle"
6) l�schen sie die "neue Baustelle"

Anmerkung: Diese Datenauffrischung ist im Moment auf die Felder "Z�hler Info" sowie
Planquadrat beschr�nkt. Der Umfang kann jedoch einfach erweitert werden.

Auto Planquadrat Funktion (beim Import)

sind in der Quell-Datei die Strassen schon beieinander sortiert und sind die
Strassen auch schon nach einem Laufweg sortiert, so kann man das Feld
PLANQUADRAT von GaZMa automatisch f�llen lassen. Dabei wird bei einer angebbaren
Nummer begonnen, die immer um eins erh�ht wird, wenn der Strassenname wechselt.
Der Effekt ist, das die Anzeigereihenfolge im GaZMa (fast) genau so ist wie in
der Import (csv-) Datei. (fast weil bei den Hausnummern die GaZMa-eigene-Logik
greift)

Beispielhafte Problemstellung "Straubing"
3 Dateien 1990,1991,1992,
alle sollten importiert werden, die erste Datei gibt eine ordentliche Laufrichtung
an ohne jedoch ein Planquadrat zu besitzen. 1990 soll komplett erledigt werden,
1991 nur die Strassen, die in 1990 eh schon vorkommen. 1992 sollen auch die Strassen
rausgezogen werden, die eh schon in 1990 angelaufen werden. L�sung:
1990 mit "Auto Planquadrat Funktion" importieren
1991 OHNE "Auto Planquadrat Funktion" importieren
1992 OHNE "Auto Planquadrat Funktion" importieren
-> im GaZMa-Terminarbeitsplatz nun die PQ1,PQ2 Funktion durchf�hren. Dadurch werden
   bekannten Strassen (aus 1990, "bekannt" weil sie Planquadrate besitzen) die schon
   automatisch zugeteilten Planquadrate zugeordnet. Alles was nach dieser Funktion
   keinen Planquadrat Eintrag hat sind Strassen, die exclusiv nur in 1991 und 1992
   angelaufen wurden.
-> (jetzt wirds kompliziert) irgendwann will man ja die Planquadrate von 1991 und
   1992 �bernehmen. In 1991 ist ja auch schon eine ordentliche Laufrichtung drin.
   Hier k�nnte man 1991 in die Spielbaustelle importieren (mit
   "Auto Planquadrat Funktion" (Start Nummer auf die n�chst h�chste nicht vergebene
   Nummer aus der bisherigen Datei setzen). Und nun eine Baustellen Korrektur-Lauf
   auf das Feld Planquadrat durchf�hren (aber nur die Datens�tze, die noch KEINEN
   Planqudrat-Eintrag haben (diese Funktion gibt es so noch nicht -> bei Bedarf
   in Auftrag geben. Bisher wird einfach PLANQUADRAT immer �berschrieben!)

PQ: passende Strassen dazwischen mischen

Vorbemerkungen

* Diese Option ist sinnvoll, wenn schon Daten in der Baustelle gespeichert sind,
  und der Import teilweise "bekannte" teilweise "neue" Strassennamen bringt.
* Pro Strasse ein eigenes Planquadrat zugeordnet sein. Die alten Daten wurden
  z.B. mit der Auto-Planquadrat Funktion importiert. Oder bisherige Planquadrate
  vor dem (dazu)Import neu durchnummerieen lassen (n, n+1 Funktion)
* Vor dem Import mit dieser Funktion wird dringend empfohlen die Funktion (n, n+1
  Funktion durchzuf�hren, da GaZMa numerisch vom ersten gefundenen Planquadrat
  1 subtrahiert. Sollte das erste gefundene PQ z.B. P9390002 lauten misslingt
  diese Funktion.

Diese Funktion sucht im aktuellen Bestand nach den Strassennamen, die auch in der
neuen Datei vorkommen und ordnet sie dem bisherigen Planquadrat zu.
(nicht gefundene) Strassen vorher und danach werden z.B. mit dem Planquadrat
19280003
^ bisheriger Eintrag (1928)
    ^ neuer Zusatz (0003)
bezeichnet.

Im aktuellen Beispiel

1990 mit "Auto Planquadrat Funktion"
1991 mit "PQ: passenden ..."
 a) simulation
 b) echt importieren
nun Baustelle im Terminarbeitsplatz ansehen und n,n+1 ausf�hren
1992 mit "PQ: passenden ..."
 a) simulation
 b) echt importieren

Dazumischen macht eigentlich nur bei "unterminierten" Sinn, andere PQs
werden dabei nicht verwendet! Wollen Sie zwischen den Gesamtbestand mischen,
so nehmen Sie den Schalter "nur zwischen "unterminierte" mischen" raus.