#

Cobukas - Dokumentation zur Portierung

 
 

Gegenüberstellung der alten/neuen Bezeichner 
============================================

Achtung:  
--------
Nachträglich - ab 11.08.06 - aus grund'buch' -> 'jour'al gemacht.
Der besseren Verständlichkeit wegen.


Allgemein
---------

  curr(ent) -> akt(uell)
  index,idx -> sprechende Bezeichner
  ptr       -> sprechende Bezeichner
  i, j, ..  -> sprechende Bezeichner

  para      -> config  (Konfigurationsparameter)
  Para      -> benPara (BenutzerParameter)
 
  name, text, saldo, nummer/nr, ... -> sprechende Bezeichner
                                                      
  11.08.06: Konsequent sein:
  in Variablennamen und Funktionen: 
     Konto/Konten -> Kto/Kten
     Nummer       -> Nr
     Kontonummer  -> Ktonr
  in Prozeduren lange Schreibweise
     
 

Bilg/Ausw - Ein historisches Problem
------------------------------------

  'Bilg' wurde benutzt, um die Daten im Bereich Auswertung zu bezeichnen,
  weist aber meines Erachtens auf Bilanz+GuV hin.
  'Ausw' wurde dagegen für 'Aktiva, Passiva, GuV' verwandt.

  Lösung der Verwirrung:
    Auf 'Bilg' wurde ganz verzichtet.
    Aus 'Bilg' wurde 'Ausw', nach dem
    aus 'Ausw' -> 'APG' wurde, wo dies sachlich angemessen war.


Manchmal:

 Ausw  ->APG (nochKeinAPG, aktiva, passiva, guv)
 tAusw -> tAPG
 currAusw ->aktAPG
 cAusw ->cAPG

Immer:

  Bilg -> Ausw
  bil...  +  bilg...  -> ausw...

  suchfBilg ->suchfAusw
  pruefBilg ->pruefAusw


Verwendung der Laufzeitbibliothek (RTL)
---------------------------------------

cutBlanks -> TrimRight(...)      (sysutils)
convIS    -> intToStr(...)       (sysutils)
lastCh    -> AnsiLastChar(...)^  (sysutils)
fillUp    -> padRight(wo,wielang) Leerzeichen anhängen (strutils)


Dateinamen geändert  ->  /  Inhalt übertragen   -->
---------------------------------------------------

  sysmod        -> cbk01alle
  cbkconst     --> cbk01alle

  cbkvars       -> cbk02satz (Records)

  verwpara      -> cbk03conf
  planhand      -> cbk04plan
  buchhand      -> cbk05jour
  belghand      -> cbk05jour
  auswhand      -> cbk06ausw

  verwuser      -> cbk10benu



cbk01alle (cbkmod)
------------------
  maxBuch        -> maxBuchungenJour (maxZeilenBuch)

  maxAuszug      -> maxBuchungenKto (maxZeilenKto)
  maxBeleg       -> maxBelege
  maxPara        -> maxUStKz (maxUStKennziffern)
  maxBelegzeile  -> maxBuchungenBeleg (maxZeilenBeleg)
  maxPlan        -> maxKtenPlan

xxx - maxPosAusw
  maxAuswzeile   -> maxZeilenAusw
  maxAuswkto     -> maxKtenAuswpos

  neu      ->  cbkDir       (= GetEnvironmentVariable('CBKDIR')
                       oder (= '/cobukas') 
  CD       ->  cbkDirDaten  (= cbkDir +'/daten')
  CF       ->  cbkDirConfig (= cbkDir +'/config')


cbk02satz (cbkvars)
-------------------

  benutzer
  --------
  benNr    -> benKng 


  auswertung
  ----------

  maxAuswzeile -> maxPosAusw (maxZeilenAusw)

  readAusw  -> readAPG (Aktiva, Passiva, GuV)
  readBilg  -> readAusw
  bilPos    -> auswpos
  bilPosNr  -> auswposNr

  tAPG      -> tAusw
  keineAusw -> nochKeinAPG

             tAuswZeile = RECORD:
  nr        -> posNr
  text      -> posName
  spalte    -> posSpalte
  weiter    -> verrechPos
  saldo     -> auswzeilSaldo
  pKto      -> anzKonAuswPos

  von: 
     tBilgDef = RECORD                         -> tAuswDef
       ausw: ARRAY [aktiva..guv] OF tAuswArr;  -> apg:
       chg: boolean;
     END;

  nach:
     tAuswDef = RECORD
       apg    : ARRAY [aktiva..guv] OF tAuswArr;
       apgBez : ARRAY [aktiva..guv] OF string8;
       chg    : boolean;
     END;
  
  currAusw: tAusw; -> aktAPG: tAPG;


  plan
  ----
               tUstSet = RECORD  {vormals : tUst}
  tUst      -> tUstSet
  vUst      -> stRel

  tPara     -> tbenPara 

               tPara = RECORD
  name      -> benName
  uSt       -> UStSet

               tKto = RECORD:
  nr        -> ktoNr
  art       -> ktoArt
  text      -> ktoName
  ustRel    -> ustArt
  saldoVJ   -> vjktoSaldo
  saldo     -> ktoSaldo

               tPlan = RECORD
  ptr       -> anzKonten
  para      -> benPara : tbenPara;

  Nicht benutzt:

    userFileName
    fileVersion
    readOnlyGlobal
    plan.par.readOnly
  


  belege
  ------
               tBeleg = RECORD 
  nr        -> belegNr
  datum     -> belegDatum
  buchIndex -> anfangBelegJour

  bZeile:
    kto     -> ktoNr
    gKto    -> gKtoNr




  jour
  ----
               tJourSatz = RECORD
  kto       -> ktoNr
  gKto      -> gktoNr
  belegText -> belegGrund

               tJour = RECORD
  ptr       -> anzBuchungJour



cbk03conf (verwpara)
-------------------

parFile  -> configDatei
paraStr  -> configStr
fPara    -> fConfig
paraName -> 'cobukas.par' im Verzeichnis '/cobukas/config'


cbk20stam
---------

  benutzerParameter  ->verwaltenBenutzer
  kontenplanListe    ->verwaltenKontenplan
  auswertungsListe   ->verwaltenAuswertungen


cbk30dobf
---------

nicht benutzt:
  getKto ->Variable können über vollen Namen direkt angesprochen werden: plan.arr[gefunden]^.<....>
           
cbk43auswsal
------------

sollSumme ->sollUmsatz
HabenSumme ->habenUmsatz



Prozeduren und Funktionen
-------------------------

 F suchKto   -> ktoImPlan