DB: Entwicklerdokumentation, so nicht!

Ich muss hier doch einmal ein Dokument posten, das sehr anschaulich zeigt, wie man eine Entwicklerdokumentation NICHT gestalten sollte. Es ist alles original bis auf die xxx, mit denen ich bestimmte Informationen unkenntlich gemacht habe. Los gehts:

Allgemeine Vorgehensweise zur Vorbereitung der xxx-Datenbank

1. Neues Verzeichnis Datenzusammenstellung 20xx in Verzeichnis xxx anlegen
   
   
   
   • Inhalt aus dem Vorjahr hinein kopieren
   
   
   • Daten-DB aus dem Verzeichnis xxx in Backup kopieren und die Daten-DB im Verzeichnis xxx umbenennen
   
   
   • Laufwerk K: zuweisen
   
   
   • xxx als Entwickler auf K: starten
   
   
   • Daten-DB im Verzeichnis xxx wieder zurück benennen
   
   
   • Arbeit an der Daten-DB am besten über xxx-Verwaltung Entwicklung.mdb – dort sind auch die später benötigten Abfragen
   
   


2. Tabelle xSystem aktualisieren
   
   
   
   • xxxjahr
   
   
   • ggf. Ebene / xxx
   
   


3. xxxblätter aktualisieren
   
   
   
   • Daten aus den Feldern für den aktuellen xxx in die Felder für den vorherigen xxx kopieren und dabei shiften (für Übersicht, welche Felder betroffen sind xxx-Entwickler-Dokumentation, Anlage 1, nutzen)
   
   
   • xxxansätze aus dem aktuellen xxx in die entsprechenden Felder eintragen
   
   
   
   
4. Stückzahlen aus dem Vorjahr shiften (aktueller xxx) – bis auf Stueckzahl01


5. Bearbeiter-Tabelle anhand Telefonliste xxx aktualisieren


6. Ausgewählte Vorhaben aus den xxx raussuchen und übertragen
   
   
   
   • Excel-Tabelle erstellen, in der die Zeilen aus den xxx eingetragen werden (Struktur wie in der Excel-Datei xxx_ausgewählte_Projekte.xls (Sammeltabelle). Raffungen in der Form Position/lfd. Nr eintragen.
   
   
   • Korrespondierende „alte“ Blätter suchen und ggf. BlattSchl dazu eintragen
   
   
   • xxx zu den Projekten suchen und eintragen
   
   
   • Daten aus Sammeltabelle in Importtabelle übertragen und umwandeln (BlattTyp umwandeln in Zahlen: 2 = xxxblatt, 3 = xxxblatt, 4 = xxxblatt), Spaltenüberschriften entsprechend anpassen (Finanzmittelxx etc), mehrere xxx in Text40, lfd Nr der Raffung in Text40
   
   
   • xxx-Tabelle aktualisieren (falls es neue Positionen gibt, die noch nicht in der DB existieren); Modul NeuNummerieren aufrufen und Prozedur xxxPosNummerieren() starten
   
   
   • In der Tabelle Blätter alle BlattSchl der Blätter negieren (=löschen), die im neuen xxx nicht mehr vorkommen sollen.
   
   
   • Neue BlattSchl in der Excel-Tabelle vergeben (2xxx = xxxblatt, 3xxx = xxxblatt, 4xxx = xxxblatt). Blätter, die bereits einen BlattSchl haben inhaltlich absetzen (z.B. kursiv darstellen), oder in ein anderes Blatt kopieren, damit sie in eine andere Tabelle importiert werden können.
   
   
   • Neue Blätter aus der Excel-Tabelle (Importtabelle) in Tabelle zz_neue_Blätter in xxx-Verwaltung-DB importieren, bereits vorhandene Blätter (kursiv) in zz_neue_alte_Blätter importieren
   
   
   • Mittels Aktualisierungsabfrage zz_qryNeueBlätterxxxPos den Schlüssel der xxxPos in der Tabelle zz_neue_Blätter eintragen lassen bzw. mittels zz_qryNeueAlteBlätter-xxxPos in der Tabelle zz_neue_alte_Blätter (Wichtig: vorher Schritt e) ausführen)
   
   
   • Abfrage zz_qryNeueBlätterAnfügen ausführen, um neue Blätter anzufügen
   
   
   • Abfrage zz_qryNeueAlteBlätterUpdate ausführen, um alte Blätter zu aktualisieren
   
   
   
   Wichtig: auf richtige Zahlenwerte achten (Tsd € / Mio €). zz_qryNeueBlätterAnfügen rechnet von Tsd € (xxx) in Mio € (xxx) um.
   Bei nachträglichen Änderungen / Neuaufnahmen von Blättern folgendes beachten:
   Sollten nach dem ersten Befüllen noch andere neue Blätter hinzukommen, die Tabelle zz_neue_Blätter entweder löschen oder kopieren und umbenennen, damit beim Anfügen durch Schritt j) wirklich nur neue Blätter aufgenommen werden. Sollen weitere alte Blätter aktualisiert werden, so genügt die Aufnahme der Blätter mit den neuen Daten in die Tabelle zz_neue_alte_Blätter. Anschließend Schritt k) ausführen. Immer auch die Schritte e) und i) befolgen – im Grunde muss für „Nachzügler“ der gleiche Ablauf eingehalten werden.
   
   
7. In den xxxblättern die xxx-Daten aktualisieren, xxx-Verwaltung-DB öffnen




• Tabelle xxx einlinken
  
  
  
  • xxx.mdb aufmachen
  
  
  • xxx Tabelle exportieren in neu angelegte DB
  
  
  • xxx-Verwaltung aufmachen und Tabelle aus der neuangelegten DB verknüpfen
  
  
  
  
• Abfrage zz_qryxxxzuordnen aufrufen => Tabelle zz_Blattschlxxx wird erzeugt


• Abfrage zz_Updatexxx aufrufen => Tabelle Blätter wird mit den entsprechenden Werten aktualisiert


• Ggf. eine lokale Tabelle xxx_lokal anlegen und dort manuell zusammengerechnete Daten aus mehreren xxx eintragen. Dann die xxx-Tabellen umbenennen (xxx => xxx_remote, xxx_lokal => xxx) und Schritte 2 und 3 ausführen.



Wichtig: auf richtige Zahlenwerte achten (€ / Mio €). zz_qryxxxzuordnen rechnet von € (xxx) in Mio € (xxx) um. Falls der genehm. xxx nicht in xxx steht, dann die entsprechende Tabelle verwenden!


8. Bearbeiter der Blätter am besten mit xxx-Verwaltung aktualisieren (Kennungen aus xxx auslesen). xxx Kennungen = xxx X YY mit X = xxx und YY = lfd. Nr aus dem Telefonverzeichnis, wobei der xxxLtr nicht mitzählt.



9. Bearbeitet-Kennung zurücksetzen.



10. Daten-DB komprimieren und nach T:\xxx kopieren.

Alles klar? Na ja, diese Prozedur muss ja nur einmal im Jahr durchlaufen werden.