Entwicklung > Skript-Dictionary > Objekte 

Die Objektverwaltung ist die Grundlage der meisten Funktionen des Softwarepakets. Bei einem Objekt werden die Datenblätter einer Tabelle oder einer Tabellengruppe komplett verwaltet (Anlegen, Aufrufen, ändern, ggf. Abbrechen usw.). Beispielsweise werden die Verwaltung von Kunden und Rechnungen sowie Buchungen usw. im Softwarepaket in Form von Objekten implementiert.

Ein Objekt wird hauptsächlich wie folgt dargestellt:

in Form eines Fensters mit einer Kopfzeile und einem oder mehreren Registern, die im rechten Fensterbereich angezeigt werden, und Auswahllisten im linken Fensterbereich ("Browser"). Es wird immer jeweils nur ein Datensatz verwaltet.

in Form einer einzigen Maske mit der Liste der einzelnen Datensätze einer Tabelle.

Mit diesem Objekt werden ein Datensatz in der Tabelle (ein Personenkontendatenblatt zum Beispiel) oder mehrere Tabellen (Kopfzeile der Bestellung und entsprechende Positionen) verwaltet.

Neben der Hauptauswahlliste links des Objekts können weitere Listen definiert werden, indem für jede weitere Auswahlliste links ein Objekt vom Typ Browser angegeben wird.

Vorbedingungen

SEEREFERTTO Siehe Dokumentation Umsetzung

Maskenverwaltung

Kopfzeile

Übersicht

In der Kopfzeile wird das Objekt identifiziert.

Schließen

 

Felder

In diesem Register befinden sich die folgenden Felder :

Der Code eines Objekts besteht aus 1 bis 3 alphanumerischen Zeichen. Die für Sage X3 reservierten Wörter sind nicht erlaubt.

  • Bezeichnung (Feld ZLIBEL)

 

  • Kurzbezeichnung (Feld ZLIBSHO)

 

Code der vom Objekt verwalteten Haupttabelle.

 

Schließen

 

Register Allgemeine Angaben

Übersicht

Schließen

 

Felder

In diesem Register befinden sich die folgenden Felder :

Allgemein

  • Modul (Feld MODULE)

Gibt das Anwendungsmodul an, an das das Datenblatt angehängt ist (und der eventuell angehängte Code). Die von mehreren Modulen verwendeten Datenblätter sind in einem der Module Stammdaten oder Supervisor klassifiziert.

Eine dem Modul zugeordnete Entwicklung (und der entsprechende Code) kann nur verwendet werden, wenn das Modul in der aktuellen Arbeitsmappe aktiv ist.

  • Parameterbez. (Feld ZLIBPAR)

 

Ist ein Aktivitätscode definiert, kann ein einem Objekt angehängter Aktivitätscode diesen optional setzen.




  • Standortfeld (Feld ZSITE)

 

  • Bereich Zugriffscode (Feld ZACC)

 

Blocknummer 2

  • Verwaltungsart (Feld TYPGES)

Diese Eigenschaft definiert die Art, wie das Objekt die Datensätze der Tabelle verwaltet. Die Auswahlmöglichkeiten sind Einfach, Tabelle, Kombiniert. Ein vierter Wert, der Browser entspricht, ermöglicht die unabhängige Erstellung der Browser, die danach in ein Fenster integriert werden.

  Einfach. ist der häufigste Typ. Er entspricht dem Fall, in dem man in einer Datensatzdatei der Haupttabelle eine Liste mit Datensätzen verwaltet, die in der linken Auswahlliste angezeigt werden. Die Maske der Objektverwaltung unterliegt selbst dieser Logik (der Code dieses Objekts ist AOB). Es gibt noch viele weitere Beispiele: Kunden, Rechnungen, Belege, Bestellungen... sind alles einfache Objekte.

  Tabelle. Dies entspricht dem Fall, in dem die Tabelle, die ausreichend klein ist, direkt auf den Zeilen einer Tabelle geladen werden kann, die in der Maske angezeigt wird. In diesem Fall existiert die Explorerliste nicht mehr (sie ist nicht mehr nützlich). Die Verwaltung der Rubrikcodes wird ebenso durchgeführt.

  Kombiniert. Dies entspricht dem Fall, in dem man in einer Tabelle eine Datensatzgruppe einer Tabelle lädt, und Datensätze, deren Schlüssel Teil von N Teilen (N>1) ist, deren N-1 Teile fest sind und deren letzter Teil variiert. Achtung: dies ist nicht der Fall für Rechnungen (die einen Schlüssel vom Typ Belegschlüssel / Zeilennummer haben), denn in diesem Fall gibt es eine einfache Objektverwaltung in der Kopfzeile und es wird das Laden der Zeilen im Code verwaltet, der dem Objekt zugeordnet ist. Ein Beispiel für ein solches Objekt ist die Verwaltung der technischen Datenblätter: für einen Prüfcode gibt es 1 bis N Zeilen, die in einer Tabelle angezeigt werden.

  Browser. Dieser Typ ermöglicht die Definition der Explorerlisten, die anschließend einem Fenster angehängt werden. Die zu erfassenden Informationen in diesem Objekttyp werden auf die Informationen für die Erstellung einer Explorerliste reduziert.

Links

Dieses Feld definiert den Code desMenüs, in dem die Funktion Objektverwaltung für denADMIN-Benutzer angezeigt wird.

  • Rang im Menü (Feld RANG)

Den Rang angeben, auf dem die Funktion im Menü oben erscheint.
In einem Menü sind die Funktionen in aufsteigender Reihenfolge der Ränge sortiert.

  • Druck (Feld RPT1)

Dieser Druckcode definiert den oder die Status, die per Klick auf die Menüauswahl Datei / Drucken gestartet werden. Hinweis: Die Report-Bereiche können über die aktuelle Datei ausgefüllt werden: auf die Auswahl Datei / Drucken kann nur zugegriffen werden, wenn eine aktuelle Datei in der Maske angezeigt wird.

Werden diese Buttons verwendet, versucht die Software standardmäßig, die Reports auszugeben, deren Namen hier angegeben wurden. Es gibt auch eine Umleitungstabelle, mit der über den hier angegebenen internen Code ein oder mehrere Reports neu definiert werden können (z.B. der Ausdruck der Kommissionierscheine und der Lieferscheine im Register Lieferungen).

  • Liste (Feld RPT2)

Dieser Druckcode definiert den oder die Status, die per Klick auf die Menüauswahl Datei / Liste gestartet werden. Die Auswahl Datei / Listeist immer zugänglich und soll es ermöglichen, die Hauptlisten, die mit den Online-Tabellen verknüpft sind, auszudrucken.

Werden diese Buttons verwendet, versucht die Software standardmäßig, die Reports auszugeben, deren Namen hier angegeben wurden. Es gibt auch eine Umleitungstabelle, mit der über den hier angegebenen internen Code ein oder mehrere Reports neu definiert werden können (z.B. der Ausdruck der Kommissionierscheine und der Lieferscheine im Register Lieferungen).

  • Standardskript (Feld TRTSTD)

Verarbeitungen, in denen man zusätzliche Unterprogramme für die Objektverwaltung dieser Funktion schreiben kann. Eine Verarbeitung ist für die Standardentwicklung reserviert, der nächste für die vertikale und der letzte für die spezifische Entwicklung. Hilfe Entwicklung.

  • Vertical-Skript (Feld CTLSPV)

 

  • Spezifisches Skript (Feld TRTSPE)

Verarbeitungen, in denen man zusätzliche Unterprogramme für die Objektverwaltung dieser Funktion schreiben kann. Eine Verarbeitung ist für die Standardentwicklung reserviert, der nächste für die vertikale und der letzte für die spezifische Entwicklung. Hilfe Entwicklung.

Optionen

  • Statistiken (Feld STA)

Diese Option ermöglicht die Aktivierung des Buttons 'Statistiken im Objekt'. Dieser Button ermöglicht den Aufruf der statistischen Abfragen, deren erste Kriterien von den Daten definiert werden, die mit der Haupttabelle oder den mit dem Objekt verknüpften Tabellen verknüpft sind.

  • Zeitverzögert löschen (Feld DELDEF)

Der Supervisor kann das differenzierte Löschen in der Haupttabelle sowie die sekundären vom Objekt verwalteten Tabellen autorisieren oder nicht autorisieren. Diese Möglichkeit gibt es für die Parameterbenutzer nach Löschbestätigung. Löscht dieser Benutzer eine Objektdatei, wird ein Bestätigungsfenster angezeigt. In diesem Fenster kann der Benutzer die Option "differenziertes Löschen" auswählen. Die Datei wird solange sichtbar sein, bis das Werkzeug differenziertes Löschen gestartet wird.

  • Import (Feld IMPORT)

Dieses Feld ermöglicht die Angabe, dass das Objekt über die Funktion Import-Export importiert werden kann.

  • Sperre in Bearbeitung (Feld MLOCK)

Ermöglicht das Anstoßen einer logischen Sperre bei der Änderung eines Datensatzes, der standardmäßig nach der Datensatzanzeige positioniert ist. Um eine Änderung vorzunehmen, muss man auf das blaue Buch im unteren Maskenbereich klicken.

 

Schließen

 

Register Auswahl

Übersicht

Alle Informationen, mit denen die Hauptauswahlliste links des Objekts erstellt werden kann, und das Auswahlfenster. Darüber hinaus können Auswahloptionen definiert werden.

Auswahloptionen

In dieser Tabelle werden Auswahlfilter für die Datensätze der verwalteten Tabelle definiert. Diese Filter, die in Form von logischen Bedingungen für die Tabellenfelder und von eventuellen Konstanten ausgedrückt werden, werden durch einen Buchstaben festgelegt (Großbuchstabe für die Standardversion, Kleinbuchstabe für spezifische Versionen). Sie können anschließend auf die Felder gesetzt werden, die einen mit diesem Objekt verbundenen Datentyp aufweisen.

Beispiel:

Bei der Eingabe von Verkaufsaufträgen sollen nur aktive Kunden zugelassen werden. Dazu wird ein Auswahlfilter auf das Objekt Kunde mit der Bedingung BPCSTA=2 und dem Titel "Akt. Kunde" definiert. In der Maske SOH0 wird ein Kundenfeld BPCORD vom Datentyp BPC angezeigt (der Typ ist mit dem Objekt BPC verbunden). Im Kontextmenü des Datentyps BPC kann unter "Optionen" jeder festgelegte Filter auf das Objekt der Kunden gesetzt werden.

Definition der Auswahlfenster
(Auswahlliste links, Auswahlfenster und Fenster zur erweiterten Auswahl)

Die Liste der Spalten, die in der Auswahlliste links angezeigt werden muss, wird in der unteren Tabelle des zweiten Registers eingegeben. Bei diesen Spalten kann es sich um Felder der Haupttabelle oder einer sekundären Tabelle handeln, die im dritten Register festgelegt wird, wenn der Beziehungsausdruck angegeben wird. Es kann sich auch um einen Ausdruck handeln. In diesem F all wird der Datentyp angegeben, um das Ergebnis des Ausdrucks zu speichern.

Schließen

 

Felder

In diesem Register befinden sich die folgenden Felder :

Tabelle Auswahloption

  • Bezeichnung (Feld ZOPTLIB)

 

  • Code (Feld OPTCOD)

Diese Tabelle ermöglicht die Definition der Optionen der Objektverwaltung. Eine Option ermöglicht die Beschreibung der Untergruppen der Dateien, die über eine Bedingung identifiziert werden (aktive Clients, zuordenbare Konten, ...).

Eine Option ist definiert über:

  • Ein Schlüsselwort
  • Einen Titel
  • Eine logische Bedingung
  • Eine Fehlermeldung, die angezeigt wird, wenn das Objekt nicht auf die Option antwortet.
  • Optionsbedingung (Feld OPTCND)

 

  • Fehlermeldung (Feld ZOPTERR)

 

Auswahlmaske

  • Index (Feld SELCLE)

Dieses Feld ermöglicht die Definition eines Durchlaufindexes der Hauptdatei für die Anzeige in der Explorerliste und den Auswahlfenstern. Ist das Feld leer, wird der erste Index der Tabelle verwendet.

  • Richtung (Feld SELORD)

Dieses Feld ermöglicht die Definition einer Durchlaufrichtung der Haupttabelle für die Anzeige in der Explorerliste und den Auswahlfenstern.

  • Auswahloption (Feld SELOPT)

Dieses Feld ermöglicht die Angabe einer oder mehrerer Optionen für die Dateien im Auswahlfenster.

  • Hierarch. Liste (Feld SELTREE)

Besteht der ausgewählte Durchlaufschlüssel für die Explorerliste aus mehreren Teilen, stellt die Liste zunächst nur den ersten Teil des Schlüssels an. Mit einem Doppelklick auf einen der Schlüsselwerte prüft man die Unterwerte des Schlüssels auf der Anzahl der vorhandenen Unterschlüsselebenen. Wurden alle Schlüsselebenen geprüft, kann man einen Datensatz der Tabelle auswählen.

Beispiel für diese Funktion im Verwaltungsobjekt der Standorte: für jeden Standort, der einem Unternehmen angehört, zeigt man zunächst die Unternehmensliste an. Danach hat man die Möglichkeit, ein Unternehmen über einen Doppelklick zu erweitern: es wird die Liste der Unternehmensstandorte angezeigt, aus der man einen auswählen kann.

Ist diese Option nicht ausgewählt, handelt es sich um eine einfache Liste.

  • Anzahl Zeichen (Feld SELCAR)

Jedes Maskenfeld, dessen Typ mit einem Objekt verknüpft ist, hat ein Auswahlfenster, das über einen Rechtsklick oder über erreicht werden kann.

Dieser Wert ermöglicht die Definition der verwendeten Zeichenanzahl für die Angabe, wo die Auswahl beginnen soll, in Bezug auf die im Feld vor der Auswahl definierten Informationen. Ist dieser Wert N, beginnt die Auswahl ab dem ersten Schlüssel, dessen N ersten Zeichen größer oder gleich der erfassten Kette sind. Es gilt daher:

  • Parametrisiert man den Wert 2 und gibt man die Kette DEF vor dem Öffnen der Auswahl ein, beginnt das Auswahlfenster die Suche ab dem ersten Schlüsselwert, der höher oder gleich DE ist (gibt es Schlüssel, die mit DEA beginnen, werden diese zuerst im Fenster angezeigt). Hat man H eingegeben, beginnt die Auswahl beim ersten Schlüssel, der höher oder gleich H ist.
  • Gibt man diesem Feld den Wert 0 und gibt man die Kette UVW vor dem Öffnen der Auswahl ein, beginnt die Auswahl bei A und ist nicht begrenzt.

Tabelle Nummer 2

Hier wird die Tabelle erfasst, in der sich das anzuzeigende Feld befindet. Diese Tabelle ist entweder die Haupttabelle oder eine der Tabellen, die als mit der Haupttabelle in der Objektdefinition verknüpft definiert sind.

Dieses Feld kann leer sein, wenn der berechnete Ausdruck angezeigt wird.

  • Feldname (Feld SELZON)

Hier werden die Felder in der linken Auswahlliste definiert. Sie werden von der zuvor definierten Tabelle ausgegeben.

  • Ausdruck (Feld SELEXP)

Wird eine Spalte der Explorerliste bewertet, wird hier der berechnete Ausdruck definiert, dessen Ergebnis die Spalte ausfüllt. Ein Datentyp wird daher benötigt, um die Feldformatierung zu ermöglichen.

  • Bezeichnung (Feld ZSELINT)

 

Dieser Datentyp wird für die Formatierung des vorherigen Ausdrucks in der Explorerliste verwendet.

  • Optionen (Feld SELSAI)

Diese Information ermöglicht die Formatierung der Daten über die Optionsauswahl. Die Optionen sind abhängig vom Datentyp (Suchfenster verwenden).

  • Länge (Feld SELLNG)

Möglichkeit, eine Länge für eine alphanumerische Spalte anzugeben, die durch einen Ausdruck erstellt wurde. Falls nichts angegeben, wird standardmäßig eine Länge von 30 Zeichen genommen.

Schließen

 

Register Umgebung

Übersicht

Hier werden mehrere Tabellen definiert, die für die Ausführung der Funktion notwendig sind, sowie die Verbindung Tabelle-Maske für die Importverwaltung, die weiteren Masken, die über Buttons oder Menüs für die Webservices aufgerufen werden können.

Schließen

 

Felder

In diesem Register befinden sich die folgenden Felder :

Tabelle Nummer 1

Zusätzliche Tabellen für die vom Objekt verwaltete Haupttabelle. Diese Tabellen werden bei der Objektausführung automatisch geöffnet und geschlossen, und zwar mit der angegebenen Abkürzung oder der Dictionary-Abkürzung. Die Felder dieser Tabellen sind im Objekt zugänglich.

Des weiteren werden die Felder dieser Tabellen dazu verwendet, eine Spalte der Explorerliste und der Auswahlmasken ab dem Zeitpunkt zu definieren, ab dem der Verknüpfungsausdruck ausgefüllt wird. Es ist möglich, hierarchische Verknüpfungen zu definieren, wenn diese Tabellen in der Tabelle in hierarchischer Reihenfolge ausgefüllt werden.

Der Verknüpfungsschlüssel darf kein Homonym haben. Wird er nicht angegeben, nimmt der Supervisor den Hauptschlüssel.

  • Index (Feld TABCLE)

 

  • Linkausdruck (Feld TABLIEN)

 

  • Abkürz. (Feld TABABR)

 

 

Tabelle Import

Für den Import werden alle Tabellen angegeben, die aktualisiert werden. Dann werden für jede Tabelle die Masken angegeben, die sie verwalten. Zum Schluss gibt man für jeden Tabellenblock die Variable am Tabellenende an. Diese Informationen dienen zum Ausfüllen der Detailtabelle. 

 

  • Tabellenblatt (Feld IMPTAB)

 

Tabelle Zusatzmasken

Für die Webservices werden die zusätzlichen Masken für die Objektverwaltung über einen Button am Maskenende oder über ein Menü angegeben.

 

  • Abkürzungen (Feld SCRABR)

 

Schließen

 

Symbol Aktionen

Hinzufügen ATEXTRA-Links

Mit diesem Button werden automatisch die notwendigen Beziehungen zu den Tabellen der übersetzten Texte ATEXTRA angelegt.

 

Schließen

 

Register Views

Übersicht

Hier werden mehrere Views zur Ausführung der Funktion angezeigt. Diese Views werden in der generierten Verarbeitung des verbundenen WO-Objekts

geöffnet und geschlossen.

Schließen

 

Felder

In diesem Register befinden sich die folgenden Felder :

Tabelle

Diese Ansichten werden bei der Objektausführung automatisch geöffnet und geschlossen, und zwar mit der angegebenen Abkürzung oder der Dictionary-Abkürzung. Die Felder dieser Ansichten sind im Objekt zugänglich.

  • Abkürz. (Feld VUEABR)

 

 

Schließen

 

Reports

Standardmäßig sind der Funktion folgende Reports zugeordnet :

 PRTSCR : Druck Maske

Dies kann durch geeignete Parameter geändert werden.

Spezielle Buttons

Mit der Freigabe wird die automatische Verarbeitung des Objekts generiert (WOxxx, wobei xxx der Objektcode ist).

Im über diese Schaltfläche geöffneten Fenster befinden sich die folgenden Felder: :

Blocknummer 1

  • Feld OBJET

 

  • Feld CLES

 

Blocknummer 2

  • Von Ordner (Feld DOSORG)

Geben Sie den Ordner an, aus dem der Datensatz kopiert werden soll. Die möglichen Syntaxen sind im entsprechenden Anhang beschrieben.

  • Alle Ordner (Feld TOUDOS)

Mit dieser Option kann der Datensatz in alle im Dictionary definierten Ordner kopiert werden (Tabelle ADOSSIER der aktuellen Lösung).

  • Nach Ordner (Feld DOSDES)

Geben Sie den Ordner an, in den der Datensatz kopiert werden soll. Die möglichen Syntaxen sind im entsprechenden Anhang beschrieben.

Schließen

Mit diesem Button kann die Objektdefinition in einen anderen Ordnerkopiert werden. Achtung: Das Objekt muss im Zielordner freigegeben werden.

Menüleiste

Infos / Vertikale Verarbeitungen

Fehlermeldungen

Während der Erfassung können außer den generischen Meldungen folgende Fehlermeldungen auftreten: :

Für diesen Objekttyp ist eine verbundene Tabelle notwendig

Die verbundene Tabelle ist - abgesehen vom Browser - für die Objekte notwendig.

Auswahlfeld passt nicht zu Index

In einer hierarchisch strukturierten Liste (einfach oder Auswahl) muss die Anzahl der für die Auswahlliste links angegebenen Elemente größer oder gleich der Anzahl der Elemente des verwendeten Index sein.

Feld nicht vorhanden

Wenn das Feld "Standort" angegeben ist, wird als Wert ein Feldname eingegeben, der in der Haupttabelle enthalten sein muss.

Zeichen '«' nicht zulässig

Aus technischen Gründen ist das Zeichen '«' in allen Textfeldern verboten: Objekttitel, Parametertitel, Titel der Optionen, Bedingungsausdruck, Fehlermeldung, Beziehungsausdruck.

Ausdruck nicht korrekt Meldung

Der eingegebene Ausdruck entspricht nicht der X3-Syntax. In einer Meldung wird der Fehler ausführlich erklärt.

X: Option nicht zulässig

Die eingegebene Auswahloption existiert nicht in der Tabelle der Auswahloptionen.

Tabelle nicht definiert

Die Tabelle muss in der Liste der zu öffnenden Tabellen im Register "Umgebung" festgelegt sein.

Link nicht korrekt

Die Tabelle muss in der Liste der zu öffnenden Tabellen im Register "Umgebung" festgelegt sein und einen korrekten Beziehungsausdruck haben.

Feld nicht vorhanden

Dieses Feld muss in der Tabelle existieren, die im vorherigen Feld eingegeben wurde.

Feld gehört zu einem übersetzbaren Text - Beziehung benutzen

Das eingegebene Feld hat den Typ "AXX". Das Feld existiert nicht in der Datenbank, ermöglicht aber die Beziehung zur Texttabelle ATEXTRA.

Datentyp nicht korrekt

Das eingegebene Feld entspricht einem Datentyp, der nicht in der Auswahlliste links aufgeführt werden darf: Typ "AXX", Clob oder Blob.

Objekt im Importmodell deklariert

Das Kennzeichen "Import" soll entfernt werden, wobei die Importmodelle aber bereits existieren.

Abkürzung bereits vorhanden...

Die Abkürzung einer Tabelle oder eines Views darf nur ein Mal in den Tabellen und Views für das Objekt verwendet werden.

Verwendete Tabellen

SEEREFERTTO Siehe Dokumentation Umsetzung