Siehe Dokumentation Umsetzung
Die Definition eines Views erfolgt über drei Register: ein Abfragedefinitionsregister das Register zur Definition der Felder und das Register zur Definition der Schlüssel.
Felder
In diesem Register befinden sich die folgenden Felder :
| Der Code der Ansicht muss aus 1 bis 10 Zeichen bestehen (Buchstaben oder Zahlen, das erste Zeichen muss ein Buchstabe sein). Es handelt sich dabei um einen eindeutigen Identifikator für alle Daten-Dictionary-Ansichten. Eine Ansicht kann nicht den gleichen Namen wie eine Dictionary-Tabelle haben, da der Supervisor bei der Freigabe die Dateien *.srf und *.fde erzeugt. Die für X3 reservierten Wörter sind nicht erlaubt. |
| Die Abkürzung der Ansicht muss aus 1 bis 3 Zeichen bestehen (Buchstaben oder Zahlen, das erste Zeichen muss ein Buchstabe sein). Dieser Identifikator kann nicht eindeutig sein für alle Abkürzungen im Daten-Dictionary. Die für Sage X3 reservierten Wörter sind nicht erlaubt. |
| Erfassen Sie die Bezeichnung des betroffenen Datensatzes. Diese Langbezeichnung wird als Titel in den Masken und Status verwendet. |
|   |
Schließen
Übersicht
In diesem Register wird die Abfrage geschrieben.
Die Abfrage muss mindestens in der Sprache der aktuellen Ordnerdatenbank geschrieben werden. Zu jedem gelieferten Standard-View wird zu jeder Datenbank ein Skript geliefert. Bei Freigabe des Views wird die Datei*.viw mit dem für die Datenbank des aktuellen Ordners geeigneten Skript angelegt; das Skript wird auf dem Datenserver im Verzeichnis FIL angelegt.
Sollen in der Abfrage einem Aktivitätscode unterworfene Felder sowie ein Ordnername angegeben werden, wird die Verwendung einer Formel empfohlen. Es ist vorzuziehen, den Ordner nicht in der Abfrage "hart zu codieren", da die Abfrage sonst nach der Kopie des Views in keinem anderen Ordner verwendet werden kann.
Beispiel: Von 1 bis 3 dimensionierter Aktivitätscode für das Feld LIEN und Formel im Ordner:
Select CLENUM1_0, CLENUM2_0, LINK_0
%string$(find(func AFNC.ACTIV("ZZM"),2,3)<>0,", LINK_1")%
%string$(find(func AFNC.ACTIV("ZZM"),3)<>0,", LINK_2")%
From %nomap+"."%ZZMB
Die Feldhilfe enthält weitere Informationen über die Regeln beim Schreiben der Abfrage.
Schließen
Felder
In diesem Register befinden sich die folgenden Felder :
Eigenschaften
| Der Aktivitätscode und das Modul geben an, ob die im Dictionary beschriebene Ansicht tatsächlich in der Datenbank des Ordners angelegt werden muss. Dies ist der Fall, wenn die folgenden zwei Bedingungen gleichzeitig erfüllt sind: Das Feld Aktivitätscode ist leer oder der (in der entsprechenden Ansicht definierte) Aktivitätscode ist aktiviert. Das Modul, dem die Ansicht zugeordnet wird, ist als im Ordner aktiv deklariert. Eine Ansicht mit Aktivitätscode, der mit X, Y, oder Z beginnt, wird als spezifisch angesehen und ist in keinem Fall von einer Versionsänderung betroffen (diese Aktivitätscodes können auf Zeilenebene gesetzt werden). |
| Mit dieser Option kann der Zugriff auf die Datentabelle auf nur einen Besitzerordner der Tabelle und auf bestimmte berechtigte Ordner beschränkt werden. Dieser Hinweis gilt auch für die Ansicht. Wird dieses Feld geändert, muss die Tabelle neu validiert werden, um in der Datenbank berücksichtigt zu werden.
Die Ordner mit Rechten sind:
Die Sicherheitspolitik für die Tabelle wird als Parameter angesehen. Diese Option wird daher nicht per Patch aktualisiert. Bei der Validierung der Tabelle muss diese Option ausgewählt sein. Dadurch wird die Erstellung einer Konfigurationsdatei (mit Erweiterung ".cfg") mit dem folgenden Code ausgelöst:
Gibt es andere manuelle Vorschriften in der Konfigurationsdatei, werden diese berücksichtigt. Vorschriften können durch die Aktualisierung des Blocks "Konfigurationsdatei"im entsprechenden Register der Tabellenverwaltung hinzugefügt werden. |
| Der Aktivitätscode und das Modul geben an, ob die im Dictionary beschriebene Ansicht tatsächlich in der Datenbank des Ordners angelegt werden muss. Dies ist der Fall, wenn die folgenden zwei Bedingungen gleichzeitig erfüllt sind: Das Feld Aktivitätscode ist leer oder der (in der entsprechenden Ansicht definierte) Aktivitätscode ist aktiviert. Das Modul, dem die Ansicht zugeordnet wird, ist als im Ordner aktiv deklariert. Eine Ansicht mit Aktivitätscode, der mit X, Y, oder Z beginnt, wird als spezifisch angesehen und ist in keinem Fall von einer Versionsänderung betroffen (diese Aktivitätscodes können auf Zeilenebene gesetzt werden). |
|   |
Tabelle Verwendete Tabellen und Ansichten
|   |
|   |
Oracle
|   |
SQL-Server
|   |
Schließen
Übersicht
In diesem Register werden sämtliche Viewfelder in einer Drop-Down-Liste definiert. Die Beschreibung der Felder in der Abfrage und in diesem Register muss vollständig kompatibel sein (Anzahl, Reihenfolge und Feldtyp). Diese Prüfung wird bei Freigabe des Views durchgeführt. Diese Felder können im Tabellendictionary vorhanden sein. Dies ist jedoch nicht Pflicht.
Schließen
Felder
In diesem Register befinden sich die folgenden Felder :
Tabelle Felder
| In dieser Spalte wird der Name des Ansichtsfelds definiert, wie es in der Software definiert wird (auf ein Feld mit dem Namen NAMEFELD, das in der Abkürzungsansicht ABV definiert ist, kann über die Syntax [F:ABV]NAMEFELD zugegriffen werden). Die Feldnamen von spezifisch angelegten Feldern müssen mit den Zeichen X_, Y_ oder Z_ beginnen. Für ein dimensioniertes Feld (NAMEFELD_0, NAMEFELD_1, NAMEFELD_2…) wird nur ein Feld NAMEFELD definiert. | |
| Hier muss der Feldtyp definiert werden. Die wichtigsten Typen: A: Alphanumerisch Die Datentypen in Bezug auf die übersetzten Texte können hier nicht verwendet werden: AX1, AX2, AX3. | |
| Definiert die Nummer des lokalen Menüs, das dem in der Zeile definierten Feld zugeordnet ist. Ist ein Feld vom Typ lokales Menü, ist es als numerischer Wert (von 1 bis 255) gespeichert, entsprechend dem Rang eines Titels in einer aufgerufenen Tabelle lokales Menü, die in der Nachrichtentabelle APLSTD gespeichert ist. Bei der Erfassung oder Anzeige sieht man je nach Auswahl auf der Benutzeroberfläche:
Dieser Erfassungstyp dient dazu, dass die Auswahlliste in der Verbindungssprache des Benutzers angezeigt wird. Jede Nummer eines lokalen Menüs bezeichnet die Liste der möglichen Titel. Beispiel: Das lokale Menü 1 entspricht der Auswahl Nein / Ja in dieser Reihenfolge. In diesem speziellen Fall kann die Benutzeroberfläche auch die auszuwählende Option sein. | |
| Ermöglicht die Definition der Länge eines Feldes, wenn das Feld einen generischen Datentyp verwendet, dessen Länge nicht festgelegt ist. Dies gilt vor allem für die Typen A und DCB. Für die blob und clob muss die Länge erfasst werden, die die maximale Speicherlänge ist. Es gilt die folgende Codifizierung:
| |
| Ein Aktivitätscode ermöglicht folgende Aktionen:
Wenn der Aktivitätscode deaktiviert ist:
| |
| Bereichsdimension in der Ansicht. Die Dimension kann auch vom Aktivitätscode betroffen sein. | |
| Erfassen Sie die Bezeichnung des betroffenen Datensatzes. Diese Langbezeichnung wird als Titel in den Masken und Status verwendet. | |
| Die Optionen sind als Zeichen ausgedrückt. Wenn mehrere Optionen benötigt werden, können diese Zeichen miteinander verkettet werden. Die Optionen können in einem Auswahlfenster gewählt werden. Eine detaillierte Beschreibung aller möglichen Optionen ist verfügbar. |
Schließen
Symbol Aktionen
Übersicht
In diesem Register können sämtliche für ein "order by" auf den View verfügbaren Schlüssel definiert werden. Achtung, für den View wird kein Index angelegt.
Schließen
Felder
In diesem Register befinden sich die folgenden Felder :
Tabelle Schlüssel
|   |
| Dieses Feld entspricht dem Namen, unter dem der Schlüssel in der Reihenfolge Order By bekannt ist. Eine Norm wird in allen Anwendungsansichten verwendet: sie besteht daraus, die Schlüssel mit der Ansichtsabkürzung zu benennen, gefolgt von der 0 für den ersten Schlüssel, der 1 für den zweiten Schlüssel etc. Spezifisch muss der Code mit einem der drei folgenden Buchstaben beginnen: X,Y oder Z. |
| Hier wird die Liste der Felder erfasst, die den Index zusammensetzen. Bei mehreren Feldern durch ein '+' getrennt. |
| Dieses Feld wird standardmäßig auf Ja gesetzt. Es kann auch auf Nein gesetzt werden. In diesem Fall warnt eine Meldung davor, dass es keine doppelten Schlüssel in dieser Ansicht geben darf. Ist dies der Fall, gibt es keinen Fehler mehr, aber eine einfache Schleife For würde die Homonyme nicht entdecken. Das Feld sollte daher auf Ja bleiben, außer in speziellen Fällen, in denen die Option Nein die Unterstützung der Anweisungen "Read Next/Prev" in den Ansichten ermöglicht. |
| Ein Aktivitätscode ermöglicht folgende Aktionen:
Wenn der Aktivitätscode deaktiviert ist:
|
Konfigurationsdatei
| In diesem Block kann man einen Text erfassen, der die technische Konfiguration der Ansicht in der Datenbank beschreibt. Dieser Text ist in einer Datei "Ansichtsname.cfg" im Verzeichnis FIL der Anwendung gespeichert. Diese Datei wird über die Anweisung "valfil" verwendet. Für mehr Informationen wird der zugeordnete technische Anhang angezeigt. |
Schließen
Im über diese Schaltfläche geöffneten Fenster befinden sich die folgenden Felder: : Blocknummer 1
Blocknummer 2
Schließen Kopie der Viewstruktur in einen anderen Ordner. Achtung, es wird nur die Beschreibung des Views im Dictionary übernommen: Der View wird nicht im Zielordner angelegt (damit der View angelegt wird, muss diese Beschreibung freigegeben werden). |
Damit kann die Datei *.srf, die der aktuellen Tabelle in der laufenden Anwendung entspricht, angezeigt werden.
Diese Option ist besonders interessant, wenn ein Benutzer mit einem Server arbeitet, auf dem er keine Rechte für das FIL-Verzeichnis hat.
Damit kann die Datei *.viw, die die Quelle des Views in der laufenden Anwendung enthält, angezeigt werden.
Diese Option ist besonders interessant, wenn ein Benutzer mit einem Server arbeitet, auf dem er keine Rechte für das FIL-Verzeichnis hat.
Während der Erfassung können außer den generischen Meldungen folgende Fehlermeldungen auftreten: :
Es kann kein View angelegt werden, dessen Name bereits für eine Tabelle verwendet wird. Die Namen müssen über eine Tabellen und Views eindeutig sein, da das System die Dateien *.srf und *.fde erstellt.
Die Größe ist auf die Konfigurationsdatei begrenzt.
Es kann kein View mit einem Feld vom Typ AXX (übersetzbarer Text) angelegt werden.
Die Länge ist in Abhängigkeit des internen Feldtyps nicht korrekt.
Der Benutzer hat versucht, eine nicht vorhandene Option zu erfassen.
Wenn zu einem gegebenen alphanumerischen Datentyp ein Format vorgegeben wird, dürfen die Optionen A und # nicht verwendet werden.
Hinweis beim Versuch, eine Abkürzung für einen View zu erfassen, die bereits für eine Ansicht oder eine Tabelle vorhanden ist. Es wird empfohlen, eindeutige Abkürzungen zu verwenden.
Views werden in der Datenbank des Ordners angelegt, in dem die Datenbank zum Freigabezeitpunkt installiert ist. Sämtliche in solchen Views (mit der Syntax %Formel%) verwendeten X3-Funktionen werden bei Freigabe des Views ausgewertet und als Konstanten an die Datenbank übergeben.
Bei Anlage und Freigabe von Ordnern wird der Freigabevorgang im X3-Ordner angestoßen. Dieser ist nicht derselbe, in dem der View installiert ist. Daher sind folgende Vorkehrungen notwendig:
Können diese Vorkehrungen nicht getroffen werden, so müssen diejenigen Views, die nach der Ordnerfreigabe im Ordner Probleme bereiten, auf jeden Fall noch einmal erneut manuell freigegeben werden.