Toolmaker Produkt-Dokumentation

Erstellen / Bearbeiten der IBM i-Datenbank

Inhaltsübersicht

Hinweis
Die Einstellungen der einzelnen Parameter, welche die Wiedergabe Ihrer Bild-, Ton- oder Videodateien steuern, werden in sogenannten Schablonen und Felddefinitionen = Felder in einer Datenbank abgespeichert. Diese Datenbank kann wahlweise entweder auf der IBM i oder auf Ihrem PC angelegt und abgespeichert werden. Durch die directmediaMenüoptionen herunter und herauf laden können diese Datenbanken entweder von der IBM i auf den PC oder umgekehrt übernommen / überschrieben werden.
Achtung
Darin besteht ein nicht unerhebliches Risiko. Bitte sorgen Sie dafür, dass es von der auf der IBM i befindlichen zentralen Datenbank eine aktuelle Sicherungskopie gibt. Falls Sie auf jedem PC unterschiedliche lokale Datenbanken erstellt haben, sollten Sie auch davon eine jeweils aktuelle Sicherungskopie besitzen!

Erstellen / Ändern von Schablonen und Felddefinitionen auf IBM i

Hinweis
Zum Erstellen / Ändern und Überarbeiten Ihrer directmedia-Schablonen muss die Bibliothek DIRMEDIA in der IBM i-Bibliotheksliste sein. Geben Sie daher folgenden Befehl ein:
ADDLIBLE DIRMEDIA

Erstellen / Ändern von Schablonen

Geben Sie nach Hinzufügen der Bibliothek DIRMEDIA in die Bibliotheksliste folgenden Startbefehl ein:
WRKDIRMED
Anschließend wird folgende IBM i-Maske angezeigt.

0050 - Auswahl-Bildschirm für directmedia-Schablonen (Liste der Schablonen)
Geben Sie nun in das Auswahlfeld 1 ein, NEU für den Namen der Schablone und den Text Neue Schablone im Textbeschreibungsfeld ein. Anschließend drücken Sie Eingabe und die soeben neu erstellte Schablone erscheint in der Liste der verfügbaren Schablonen. Wählen Sie diese Schablone mit der Option 2 aus.
Mit Auswahl 3 können Sie eine Schablone kopieren. Vergeben Sie in diesem Fall einen neuen Namen für die kopierte Schablone.
Listenanfang bei
Wenn Sie mehrere Schablonen definiert haben, können Sie mit Hilfe des Listenanfangs an eine bestimmte Schablone positionieren.

0051 - Schablone ändern 1. Seite
0052 - Schablone ändern 2. Seite
In diesem Bildschirm können sämtliche Parameter für die Wiedergabe Ihrer Dokumente (=Bild-, Ton- u. Videodateien) abgelegt werden.
Hinweis
Es gibt 3 Typen von Schablonen:

  • Schablonen Aktionstyp = 1: welche, bei denen die Feldwerte den Datenbankschlüssel bilden.
  • Schablonen Aktionstyp = 2: welche den Dokumentennamen der anzuzeigenden Bild-, Ton- oder Videodateien von vordefinierten Feldern direkt von Ihrem IBM i-Bildschirm einlesen.
  • Schablonen Aktionstyp = 3: welche den Dokumentenname nach Aufruf eines IBM i-Programmes von einer IBM i-Datenbank einlesen. (Dem in der Schablone hinterlegten IBM i-Programm werden dabei die Feldinhalte der vordefinierten Felddefinitionen als Eingangsparameter übergeben – z.B.: Kundennummer, Personalnummer etc. – worauf das IBM i-Programm das entsprechend dazu hinterlegte Dokument an directmedia zurückgibt.)

Benutzte Hotkeys
Der Aufruf von directmedia kann entweder über die Verwendung von Hotkeys oder durch einen CALL-Befehl von einem IBM i-Programm heraus erfolgen. Für den Aufruf über Hotkeys sind folgende Tasten bzw. Tastenkombinationen möglich:

  • F1-F12
  • CTRL / ALT / SHIFT / HELP / PRINT
  • Tasten PGUP, PGDWN,
  • BlättertastenBuchstaben A-Z,
  • Ziffern 0-9
  • Sonderzeichen außer das +


Aktion der Schablone Auswahl = 1
Die Übergabe des Pfades und Namens des Dokumentes (=Bild-, Ton- oder Videodatei) erfolgt durch den Datenbankschlüssel.
Aktion der Schablone Auswahl = 2
Die Übergabe des Pfades und Namens des Dokumentes (=Bild-, Ton- oder Videodatei) erfolgt durch Pfad- und Dokumentennamen, der in Schablonen und Felddefinitionen festgelegt wird.
Aktion der Schablone Auswahl = 3
Die Übergabe des Pfades und Namens des Dokumentes (=Bild-, Ton- oder Videodatei) erfolgt durch ein IBM i-Programm, welches in der Schablone anzugeben ist. Dieses IBM i-Programm wird über einen Hotkey aufgerufen und erhält als Eingangsparameter die Feldinhalte der zu dieser Schablone angelegten Felddefinitionen. Diese als Eingangsparameter vom IBM i-Bildschirm eingelesenen Felder können zum Beispiel eine Kundennummer, eine Personalnummer etc. sein, hinter der auf einer IBM i-Datenbank ein Dokument hinterlegt ist, das im Anschluss daran von diesem IBM i-Programm an directmedia zurückgegeben wird. Näheres zur Parameterübergabe siehe Kapitel 6.2.
Position des Fensters (hor) / (ver)
Horizontale und vertikale Anfangsposition des Windows in Pixel. Beachten Sie, dass diese Angabe von der Auflösung Ihres Bildschirmes abhängig ist.
Größe des Fensters (hor) / (ver)
Breite und Höhe des Windows in Pixel.
Horizontal / Vertikal verschieben
Verschieben des Windows in Pixel.
Zoomfaktor
Eingabe eines Zoomfaktor von 1-999.
Drehung
Es kann eine Drehung von 0, 90, 180, 270 Grad eingestellt werden.
Werkzeugleiste verbergen / Statusleiste verbergen / Menü verbergen / Fenstertitel verbergen
Hier ist jeweils optional die Auswahl 1 möglich.
Vorherige Bilder löschen
Falls schon andere Windows vorher geöffnet wurden sind die Optionen 0,1,2 möglich zum Schließen des zuletzt geöffneten (=1), aller offenen Windows (=2) oder keines schließen (=0).
Auf IBM i überschreiben
Ausgabe der Windows über bereits geöffnete Fenster.
Text (Kommentar)
Zur näheren Beschreibung der Schablone
Wenn Sie nun nach Einsetzen aller Einstellungen die Eingabetaste drücken, erscheint für den Schablonen-Aktionstyp = 2: der
Name des Suchpfades
Angabe eines PC-Verzeichnisses, wo sich das Dokument befindet. Dies kann auch ein Netzwerkverzeichnis sein.
oder für den Schablonen-Aktionstyp = 3: der
Name und Bibliothek des Aufrufprogrammes
Hier werden Name und Bibliothek des Aufrufprogrammes eingegeben

Erstellen/Ändern von Felddefinitionen

Hinweis 1
Zu jeder Schablone müssen ein oder mehrere Felder (=Felddefinitionen) definiert werden. Diese Felddefinitionen beinhalten in erster Linie die Position auf Ihrem IBM i-Bildschirm (Zeile und Spalte) und die Länge des jeweiligen Strings, der vom IBM i-Bildschirm eingelesen werden soll.
Hinweis 2
Für den Schablonen-Aktionstyp = 2 ergibt der eingelesene String auch gleichzeitig den Dokumentennamen der anzuzeigenden Bild-, Ton- oder Videodatei. Dieser String kann sich auch aus den Inhalten mehrerer Felder zusammensetzen.
Zum Beispiel kann vom ersten Feld der String "TEST" und vom zweiten Feld der String ".BMP" vom Bildschirm eingelesen werden, so dass sich als endgültiger Dokumentenname "TEST.BMP" ergibt.
Hinweis 3
Für den Schablonen-Aktionstyp = 3 werden vorerst die Inhalte dieser vom IBM i-Bildschirm eingelesenen Felder an ein IBM i-Programm übergeben, welches anschließend den endgültigen Dokumentenname der anzuzeigenden Bild-, Ton- oder Videodatei an directmedia zurückgibt. Die eingelesenen Felder können zum Beispiel eine Kundennummer oder Personalnummer sein, zu denen auf einer IBM i-Datenbank bestimmte Dokumente hinterlegt sind, welche vom IBM i-Programm ermittelt und zurückgegeben werden.
Zum Erstellen eines neuen Feldes geben Sie im Auswahlfeld 1, den Feldnamen sowie eine kurze Bezeichnung ein und drücken auf Eingabe. Anschließend können Sie dann mit der Auswahl 2 weitere Angaben für dieses soeben neu erstellte Feld eingeben. Nachfolgend abgebildete zwei IBM i-Masken sollen dies verdeutlichen. (Feldliste und Felddefinitionen)
0053 - Auswahlbildschirm für Felddefinitionen
0054 - Überarbeitungsbildschirm für Felddefinitionen
Feldname
Eingabe oder Ändern des Namens der Felddefinition
Text
Nähere Bezeichnung der Felddefinition
Zeilennummer / Spaltennummer
Hier können IBM i-Zeilen- und IBM i-Spaltennummer eingegeben werden, welche die Anfangsposition auf dem IBM i-Bildschirm festlegen, ab dem ein String eingelesen werden soll.
Länge
Eingabe der Länge des einzulesenden Strings
Zeichen entnehmen
Hier können Sie wahlweise Zeichen eingeben, welche nicht eingelesen werden sollen. (z.B.: Falls Hochkommata, Punkte, führende Nullen etc. ignoriert werden sollen).
Linksbündig ausrichten
Geben Sie hier eine 1 ein, falls der eingelesene String linksbündig ausgerichtet werden soll.
Rechtsbündig ausrichten
Geben Sie hier eine 1 ein, falls der eingelesen String rechtsbündig ausgerichtet werden soll.
In Großbuchstaben / Kleinbuchstaben umwandeln
Wahlweise kann in diesen beiden Feldern eine 1 eingeben werden
Linksbündig / Rechtsbündig auffüllen
Falls der eingelesene String Blanks enthält, kann er mit beliebigen Zeichen Ihrer Wahl entweder links- oder rechtsbündig aufgefüllt werden.
Rang falls Schlüsselfeld
Falls der einzulesende String sich aus den Werten mehrerer Felddefinitionen zusammensetzen soll, kann hier die Reihenfolge der Felder eingegeben werden, in der der String aus den einzelnen Feldinhalten zusammengesetzt werden soll.
Drücken Sie nun auf Eingabe und Sie erhalten auf der nächsten Seite die Vergleichsparameter angezeigt.
0055 – Felddefinitionen Rang falls Schlüsselfeld
Vergleichsparameter
Mittels der auf den nächsten beiden Seiten sich befindenden Vergleichsparameter kann die Anzeige der Dokumente gezielt gesteuert werden, so dass dadurch nur ganz bestimmte, ausgewählte Bild-, Ton- oder Videodateien wiedergegeben werden können.
Operator für Vergleiche: (GT LT GE LE EQ NE)
Die Auswahlen Greater than, Less than, Greater equal, Less equal, Equal und Not equal sind zulässig oder Blanc falls keine Vergleichsparameter verwendet werden sollen.
Vergleiche mit anderem Feld
Hier kann im Falle des gewünschten Vergleiches des Feldes mit dem Inhalt einer anderen Felddefinition der Name dieser Definition eingegeben werden.
Vergleiche mit Konstante
Hier kann der Name einer Konstante eingegeben werden, falls die Wiedergabe sich nur auf ein einzelnes Dokument beschränken soll.
Vergleichswert Niedrig / Vergleichswert Hoch
Hier kann eine unteres Limit / oberes Limit eingegeben werden. (z.B.: A001.BMP / A999.BMP
Drücken Sie Eingabe um die nächste Seite zu erhalten:
0056 – Felddefinitionen Vergleichswert niedrig / Vergleichswert hoch
Werteliste
Falls sich die Anzeige der Dokumente auf eine gezielte Liste erlaubter Einträge beschränken soll, können hier die Dokumentennamen der zulässigen Bild-, Ton- oder Videodateien eingegeben werden.