DKS-Finanzdatenbank Technisches Handbuch

Kapitel 11. Individueller Kontenwartungsschirm für Debitoren und Kreditoren

11.1 Einleitung

Das Programm DKSKTOW ermöglicht es Entwicklern von individuellen DKS-Zusätzen, anwenderspezifische Kontowartungen in der Stammdatenwartung (Expertcode DKW und KKW) zu integrieren. Das Programm DKSKTOW wird in der Stammdatenwartung über die Funktionstaste F23 aufgerufen.

Es wird dafür ein Basisprogramm zur Verfügung gestellt, das bereits leere Bildschirmformate enthält und nur mehr um den individuellen Sourcecode ergänzt werden muss.

11.2 Lieferumfang

Cobol-Sourcen

Die Cobol-Sourcen des Programms DKSKTOW finden Sie in der DKS-Bibliothek im SAV-File DKSZMOD in der Datei QDKSLBLSRC.

Displayformate

Folgende Bildschirmformate werden bereits mitgeliefert: DKSKTOWFM: Format KTW
Sie finden diese Sourcen in der DKS-Bibliothek unter QDKSDDSSRC.

Dateien

Das Programm DKSKTOW greift nur auf bereits bestehende Dateien des DKS-Paketes zu. Es befinden sich daher keine Dateien im Lieferumfang.

Hilfeformate

Folgende Hilfeformate werden mitgeliefert: DKSKTOW

11.3 Allgemeines

Das Programm DKSKTOW wird in der DKS-Stammdatenwartung für Debitoren (Expertcode DKW) und für Kreditoren (Expertcode KKW) über die Funktionstaste F23 direkt aufgerufen.

11.3.1 Hinweise für den Entwickler

Um das Programm umwandeln zu können, kopieren Sie die Sourcen aus QDKSLBLSRC in die QLBLSRC bzw. benennen Sie QDKSLBLSRC in QLBLSRC um, wenn diese in Ihrer DKS-Bibliothek nicht vorhanden sind. Auf dieselbe Weise verfahren Sie mit QDKSDDSSRC (--> QDDSSRC) und QDKSPNLSRC (--> QPNLSRC).

Bei der Umwandlung achten Sie darauf, dass sich die DKS-, die ADS-Bibliothek und eine Firmen-Bibliothek in Ihrer LIBL befinden.

Beachten Sie bei der Erstellung des DISPLAY-Files (DKSKTOWFM), dass der Parameter 'Anzeige wiederherstellen' (F10: Zusätzliche Parameter) auf *YES gesetzt ist.

11.4 Programm DKSKTOW

11.4.1 Aufrufmöglichkeiten

Das Programm DKSKTOW kann nur aus der Stammdatenwartung aufgerufen werden.

11.4.2 Definierte Funktionen von DKSKTOW

Folgende Funktionen sind im Programm bereits ausprogrammiert:

Parameterübernahme
kein Eingriff durch Programmierer erforderlich

Bildschirm lesen
kein Eingriff durch Programmierer erforderlich

Bildschirm schreiben
kein Eingriff durch Programmierer erforderlich

Funktionstastenbehandlung

Folgende Funktionstasten sind bereits codiert:

Verlassen (Programmende)

Auswahlunterstützung für Kontoart und Kontonummer muss bei Einschränkung auf bestimmte Kontoarten angepasst werden.

Wiederanzeige

Vorwärtsblättern

Rückwärtsblättern

F24

Funktionstasten-Blättern

BILD.AUF

Vorwärtsblättern

BILD.AB

Rückwärtsblättern

Blättern in der KontoID
kein Eingriff durch den Programmierer erforderlich

Prüfen eingegebene Kontoart und Kontonummer
kein Eingriff durch den Programmierer erforderlich

Lesen und Anzeigen der eingegebenen KontoID
kein Eingriff durch den Programmierer erforderlich

11.4.3 Benötigte Dateien

Funktionstastendatei Y8 (PF-DTA) / YZ (LF)

In dieser Datei finden Sie die Funktionstasten für die bereits definierten Display-Formate. Falls Sie mit den bereits vorgegebenen Funktionstasten auskommen, brauchen Sie keine Änderungen in dieser Datei vorzunehmen.

Einfügen neuer Funktionstasten

Falls Sie in ein bereits bestehendes Display-Format eine neue Funktionstaste aufnehmen wollen, müssen Sie den zum Format gehörenden Satz in dieser Datei um die Funktionstaste ergänzen.

Die in dieser Datei definierten Funktionstasten werden in der dafür vorgesehenen Zeile des Display-Formates dargestellt. Die Funktionalität der Funktionstaste F24 ist bereits im Programm DKSKTOW enthalten. Sie brauchen sich um die richtige Darstellung der Funktionstasten nicht zu kümmern. Auch die Darstellung der Funktionstasten in den beiden Unterstützungsstufen wird bereits vom Programm erledigt.

Dateibeschreibung Y8

Die grau hinterlegten Felder können Sie Ihren Bedürfnissen anpassen.

Tabelle 11-1. Dateibeschreibung Y8 (DKSKTOW)

Feldname	Inhalt	Kommentar
Y8-Sprachenschl	Sprachenschlüssel	DKS-Sprachenschlüssel (im Normalfall leer)
Y8-Applikation	Applikationskennung	'DKS'
Y8-Formatname	Formatname	Für DKSKTOW wurden zum Format 'KTW' bereits ein Satz erfasst.
Y8-Formatlaufnr	nicht verwendet	bleibt leer
Y8-Stand	'5' - gelöscht '3' - aktiv	Status der Funktionstastendefinitionen
Y8-Anlage-Kz	internes Kennzeichen	'3'
Y8-FT-Zeile	Funktionstastenzeile	Zeile, in der sich die Funktionstasten befinden.
Y8-FT-Spalte	Funktionstastenspalte	Spalte, ab der die Funktionstasten dargestellt. werden
Y8-FT-Win-Zeile	Funktionstastenzeile	Zeile, in der sich die Funktionstasten befinden in Bezug zum Window.
Y8-FT-Win-Spalte	Funktionstastenspalte	Spalte, ab der die Funktionstasten dargestellt werden in Bezug zum Window.
Y8-FT-Zeil-Laenge	Länge der Funktionstastenzeile	Länge der Funktionstastenzeile laut Definition im Format
Y8-FT-Beschreibg	Beschreibung	freier Text zur Beschreibung
Y8-FT-Text-01	Funktionstastentext für Funktionstaste F1	DKS verwendet hier Variable, die auf Konstante in einer Textdatei hinweisen (zu erkennen an den '##'-Zeichen am Anfang des Textes). Geben Sie Ihren Text hier direkt an.
Y8-FT-Rule-01	Funktionstasten-Detaildefinition für Funktionstaste F1	5-stelliges Feld zur genaueren Definition der Funktionstasten XXYYZ: XX: Reihenfolge der Darstellung der Tasten YY: Indikator, der die FT ausblendet Z: Cursorpositionierung '1': Der Cursor bleibt auf der Funktionstaste stehen, wenn die Funktionstaste über Cursorpositionierung in der FT-Zeile und Eingabetaste ausgelöst wurde. '0': Der Cursor springt in das 1. Feld des Formates.
Y8-FT-Text-24	Funktionstastentext für Funktionstaste F24	siehe Y8-FT-Text-01 .
Y8-FT-Rule-24	Funktionstasten- Detaildefinition für Funktionstaste F24	siehe Y8-FT-Rule-01 .
Y8-FT-Text-25	reserviert	bleibt leer
Y8-FT-Rule-30	reserviert	bleibt leer
Y8-Transaktion	DKS internes Feld	bleibt leer
Y8-AEND-Versionnr	Änderungsdaten	'3'
Y8-AEND-Mode-Nr	Änderungsdaten	'6'
Y8-AEND-Jahr	Änderungsdaten
Y8-AEND-Monat	Änderungsdaten
Y8-AEND-Tag	Änderungsdaten
Y8-AEND-USERID	Änderungsdaten

11.5 Individuelle Anpassungen

Das Programm DKSKTOW gliedert sich in 3 Abschnitte.

1. FORMAT-CHECK
In diesem Abschnitt werden die Benutzereingaben geprüft.

2. FORMAT-PROCESS
Hier werden die Benutzereingaben ausgeführt.

3. FORMAT-CREATE
In diesem Teil des Programmes wird der neue Bildschirm erstellt.

Diese Abschnitte (siehe Kapitel 10.5.3, „ANZZIKFM anpassen“) werden durch Betätigung der EINGABE- oder einer Funktionstaste in der angegebenen Reihenfolge ausgeführt.