A D S Anwendungssteuerung

Kapitel 13. Wartung Dokumentenvariablen

Dokumentenvariable sind Definitionen mit deren Hilfe bestimmte Dokumentinhalte (z.B.: Buchungsbetrag) ermittelt und für andere Funktionen bereitgestellt werden können.

Dokumentvariable werden derzeit im Rahmen der Buchungsdefinitionen (Expertcode FIRABBBUCD) z.B. für die Betragsermittlung verwendet.

Dokumentvariable sind im ADS definiert und gelten für alle Firmen! Sichern Sie daher auch die ADS-Bibliothek in regelmäßigen Abständen.

Als gelöscht markierte Sätze können mit ADS-Reorganisation Expertcode REORG entfernt werden!

Der Aufruf erfolgt durch Eingabe des Expertcodes DOKVAR, mit dieser Funktion können Dokumentenvariable einer Dokumentenvariablen-Gruppe gewartet werden.

Abbildung 13-1. Bildschirformat SW 'Wartung Dokumentenvariablen'

SW Wartung Dokumentvariablen

Firma: SAG Comarch Doku AG

Nach Erfassung/Änderung Eingabe nächster Satz.

Gruppe : DKSABB Doku.Variable : MCAZBETR

Bezeichnung : Mastercard: Auszahlungsbetrag

Suchbegriff : AUSZAHLUNGSBETRAG BRUTTO

Felddtyp : BTR

Suchrichtung: R Start : SB Beginn = Start + 027 Stellen

Ende = Start + 035 Stellen

Vorkommen : 001 Verarbeitung: EW Letzte Änderung

von DOKUUSER

Status : 3 am 05-11-21

Nächstes Eingabe:

Gruppe : DKSABB Doku.Variable : MCAZBETR verzweigen in

F3=Verlassen F7=Bild-ab F8=Bild-auf F4=Liste F24=Weitere Tast.

Tabelle 13-1. Eingabefelder im Bildschirmformat SW 'Wartung Dokumentenvariablen'

Feld	Eingabe	Werte	Auswirkung
Gruppe	gesperrt		Zeigt die Gruppe der Dokumentvariablen an, die zur Bearbeitung ausgewählt sind. Zur Zeit nur DKSABB möglich und deshalb gesperrt!
Doku.Variable	gesperrt		Beinhaltet den Namen der aktuellen Dokumentvariablen. Über diesen Name kann dann von anderen Programmen auf den, von der Dokumentanalyse ermittelten Wert zugegriffen werden. Neuanlage erfolgt durch Eingabe eines neuen Namens im Bereich nächste Eingabe.
Bezeichnung	beliebig		Dieses Feld dient zur genaueren Beschreibung der Variablen. Er wird in der F4-Auswahlunterstützung angezeigt.
Suchbegriff			Gibt den Text an, der im zu bearbeitenden Dokument zuerst gesucht werden soll. Wird dieses Text gefunden (Gross- und Kleinschreibung wird ignoriert), so dienen die Angaben in den nachfolgenden Feldern zur genaueren Auffindung des gesuchten Wertes. Wird der Text jedoch nicht gefunden, so wird an die Programme, die diese Dokumentvariable verwenden möchten, kein Wert zurückgeliefert.
Feldtyp	gültiger Wert		Gibt den Feldtyp des zu ermittelnden Wertes an. Zur Zeit nur BTR möglich!
Suchrichtung	gültiger Wert	L R U	Wurde der Suchbegriff gefunden, so gibt die Suchrichtung vor in welcher Richtung vom gefundenen Suchbegriff aus gesehen, der Wert der Variablen gesucht werden soll. Links vom Suchbegriff Rechts vom Suchbegriff Unterhalb der Suchbegriffes *Beispiele:* Dokumentzeile: "Zahlung von Testbetrag=12,34" und Suchbegriff: "TESTBETRAG" 1.) Suchrichtung: R und Start: AB In diesem Fall würde das Programm mit dem Beginn = 24 und Ende = 28 exakt den Abschnitt "12,34" nach einem Betrag untersuchen. Wird der Beginn falsch gewählt und mit 25 angegeben, so wird nur der Abschnitt "2,34" untersucht und liefert so ein falsche Ergebnis. 2.) Suchrichtung: R und Start: SB Ausgangspunkt ist nun die Fundstelle des Suchbegriffes: Stelle 13 in der Dokumentzeile. Wird Beginn = 1 und Ende = 16 so wird der Abschnitt 'Testbetrag=12,34" durchsucht. Um exakt nur den Bereich mit dem Betrag zu durchsuchen, müsste Beginn = 12 und Ende = 16 gesetzt werden. Es würden jedoch beide Definitionen das gleiche richtige Ergebnis liefern: Es wird in diesem Bereich nämlich nach einem Betrag gesucht und andere Zeichen werden dabei herausgefiltert. Dokumentzeile: "Verwendungszweck: 12,34 für Rechnung AR001" und Suchbegriff: "RECHNUNG" Suchrichtung: L und Start SB Gefunden wird der Suchbegriff an der Stelle 29. Der Wert im Feld Beginn wird nun nach links gezählt, beginnend mit dem ersten Zeichen vor dem gefunden Suchbegriff. Um den Abschnitt genau einzugrenzen, muss man als Beginn 10 und als Ende 6 angeben (der Wert von Ende wird in diesem Fall auch nach links gezählt!). Es würden nun "12,34" durchsucht werden. Wird als Beginn 9 und als Ende 7 gewählt, so würde nur der Abschnitt "2,3" durchsucht werden. Tipp: Mit Suchrichtung: R und Start: AB lassen sich in der Regel fast alle Fälle lösen. Ausnahme: wenn der gesuchte Betrag in der Position in der Dokumentzeile variiert, dann muss als Start SB gewählt werden, vorausgesetzt der Abstand Suchbegriff zum Betrag ist konstant. Eine exakte Abgrenzung des Abschnittes ist hauptsächlich dann unbedingt notwendig, wenn sich in der Nähe des Betrages auch andere numerische Werte wie Datum, Kundennr. und Rechnungsnr. befinden. Ansonsten kann mit der Abgrenzung 'großzügig' umgegangen werden.
Start	gültiger Wert	SB AB	Wurde der Suchbegriff gefunden, so werden anschließend die Dokumentzeilen nach dem Wert abgesucht. Über Start kann nun definiert werden, wo die Suche begonnen werden soll. Die Fundstelle des Suchbegriff ist der Ausgangspunkt für die Suche in der Zeile. Der Ausgangspunkt wird an den Beginn der Dokumentzeile gesetzt.
Beginn			Bei Start = AB gibt Beginn jene Stelle an, bei der die Suche in der Dokumentzeile beginnt, unabhängig von einer Suchrichtung. (1 = erste Stelle der Dokumentzeile) Bei Start = SB gibt Beginn bei Suchrichtung R jene Stelle NACH der Fundstelle an, bei der in der Dokumentzeile zu suchen begonnen werden soll. (1 = es wird direkt an der Fundstelle zu suchen begonnen). Bei Start = SB gibt Beginn bei Suchrichtung L jene Stelle VOR der Fundstelle an, bei der in der Dokumentzeile zu suchen begonnen werden soll. (1 = es wird unmittelbar an der Stelle vor der Fundstelle zu suchen begonnen).
Ende			Bei Start = AB gibt Ende jene Stelle an, bei der die Suche in der Dokumentzeile endet. Bei Start = SB gibt Ende bei Suchrichtung R jene Stelle NACH der Fundstelle an, bei der in der Dokumentzeile die Suche beendet werden soll. Die Fundstelle selbst zählt als eigene Stelle (= 1.Stelle)! Bei Start = SB gibt Ende bei Suchrichtung L jene Stelle VOR der Fundstelle an, bei der in der Dokumentzeile zu suchen beendet werden soll. (1 = es wird unmittelbar an der Stelle vor der Fundstelle die Suche beendet).
Vorkommen			Das Vorkommen kann nur bei der Suchrichtung U (= unterhalb) einen anderen Wert als 1 annehmen. Ein Vorkommen größer als 1 wird dann definiert, wenn unterhalb des Suchbegriffes eine Tabelle mit Werten im Dokument gespeichert ist. Ist die Anzahl der tatsächlich in der Tabelle erfassten Werte nicht bekannt, so ist das Vorkommen auf 999 zu setzen. Es werden dann so lange die Zeilen unterhalb des gefunden Suchbegriffes durchsucht, bis eine Zeile gefunden wird in der kein Wert für die Variable gefunden wird.
Verarbeitung	gültiger Wert	EW SU	In der Regel wird ein einzelner Wert der Variable zugeordnet. Handelt es sich jedoch um eine Tabelle (Vorkommen > 1), so kann hiermit gesteuert werden, ob die Werte einzeln ( EW ) an das Programm übergeben werden sollen, oder ob die Summe der einzelnen Werte ( SU ) übergeben werden soll. Zur Zeit ist nur die Kombination: Vorkommen = 1 und Verarbeitung = EW Vorkommen > 1 und Verarbeitung = SU zulässig.
Status	gesperrt	3 4	Hier erfolgt die Anzeige oder Eingabe des Status des Satzes, den Sie gerade bearbeiten oder ansehen. Legen Sie einen neuen Satz an, so ist dieses Feld gesperrt. Gültige Codes · der Satz ist aktiv · der Satz ist gelöscht Hinweis: Status 4 (gelöscht) bedeutet, dass solche Dokemtenvariablen in den Buchungsdefinitionen nicht mehr verwendet werden können, auf dem Auswahlschirm (F4) nicht angezeigt und in der Analyse keinen Betrag ermittelt wird. Es wird jedoch geprüft, ob die Dokumentavariable verwendet wird, wenn der Status auf 4 gesetzt wird.
Letzte Änderung	gesperrt		Datum und UserID der letzten Änderung.

Mögliche Funktionstasten:

F3: Ende der Arbeit
F4: Auswahlunterstützung
F5: Storno letzte Eingabe
F10: Musterdaten für Erfassung
BILD AUF: Nächste Dokumentvariable
BILD AB: Vorige Dokumentvariable
F16: Dokumentenvariable drucken

Der Ausdruck der Dokumentenvariablen erfolgt mit dem Expertcode DOKVARL.

Datei

Datei YSD0