Listen-Element

Name

(Name)

Anhängen an Listen-Element der Partner-Kennung

(AppendToPartnerId, AppendToPackageId)

Partner- und Lösungs-Kennung des gleichnamigen Listen-Elementes, an das diese Definition angehängt werden soll.

Einsatzzwecke:

• Felder an das Listen-Element anhängen

Hinweis: Anhängen ist immer einstufig, Verkettungen sind nicht möglich.

Ersetzen

(Replace)

Festlegung, ob das Original beim Anhängen an ein Listen-Element ersetzt werden soll (bei Ja).

Die Verwendung des Ersetzens ist nur für Ausnahmefälle gedacht. Dabei wird das Original vollständig ersetzt. Die Verantwortung dafür trägt der Entwickler der Erweiterung.

In der Folge werden an das Original angehängte Listen-Elemente nicht mehr beachtet. Soll angehangen werden, muss an das ersetzende Listen-Element angehangen werden.

Berechtigungen des Originals werden ebenfalls nicht mehr beachtet. Es sind eigene Berechtigungen zu definieren.

Wird ein Listen-Element mehrfach ersetzt, „gewinnt“ das ersetzende Listen-Element, das die kleinste Partner-ID bzw. bei gleicher Partner-ID die kleinste Lösungs-Kennung hat. Bei Bedarf kann die Reihenfolge im AppDesigner angepasst werden.

Titel

(Title)

Titelerweiterung für Child-Elemente

(ChildTitleExtension)

(wird mit Leerzeichen getrennt und in Klammern an den Titel angehängt; steht bei Verwendung des Elementes im Control-Center nicht zur Verfügung)

Beim Anzeigen werden folgende Platzhalter ausgewertet:

• "$[ParentKeyField(n)]":
  Bei Verwendung als Detail-Element in einem Master-Detail-Element können Schlüsselwerte aus dem Master-Element per Platzhalter "ParentKeyField(n)" dynamisch übernommen werden.
• "$[Parameter(name)]":
  An ein Master-Detail-Element oder ein Daten-Such-Element von außen übergebener benannter Parameter.

Wird typischerweise verwendet, um voreingestellte Filter, die für den ganzen Dialog gültig sind, anzuzeigen.

Beispielsweise:

• In der Kundenauskunft werden Informationen für einen Kunden angezeigt. Dieser Kunde wird über einen Selektionsdialog voreingestellt. Die aktuelle Kundennummer und deren Matchcode sollten dann im Titel sichtbar sein. 

Beschreibung

(Description)

Kommentar

(Comment)

Beliebiger Kommentar zur Dokumentation.

Der Kommentar wird nicht zum Client übertragen und dient nur zur Dokumentation von Besonderheiten, Hinweisen, etc. Bei Auslieferung/Weitergabe der Lösung wird der Kommentar eingeschlossen, so dass der Empfänger ihn im AppDesigner sieht.

Selektionsdialog

(SelectionPartPartnerId, SelectionPartPackageId, SelectionPartName)

Partner-Kennung, Lösungs-Kennung und Name des Selektionselementes.

Dieses Element wird clientseitig für das Listen-Element "inplace" verwendet, ähnlich einer Filterzeile. Die Änderung eines Feldwertes bewirkt einen sofortigen Refresh der Daten, falls das Selektions-Element-Feld entsprechend gekennzeichnet ist (siehe Feld-Eigenschaft der Felder des Selektionsdialoges "Automatisch aktualisieren?").

Die Werte werden ignoriert, wenn das Listen-Element als Unterelement in einem Selektions-Element-Feld verwendet wird.

Datenquelle

(DataSourcePartnerId, DataSourcePackageId, DataSourceName)

Sortierbar?

(CanSort)

Höhe (Pixel)

(High)

Minimum-Höhe (Pixel)

(MinimumHeigh)

Datenanzeige abhängig von Schlüssel

(DisplayDataOnKey)

Anzeigetext bei Datenunterdrückung

(DataReplacementMessage)

Aktivierung Zeile durch Feld

(ActivationDefinedByField)

ab 9.0.5 umbenannt in

Verwendung durch Feld steuern

(UsageDefinedByField)

Feldname oder Ausdruck

Gültige Werte:

• 0 = Standard
• 1 = Nur Lesen
  • Die Zeilenwerte werden lesbar grau dargestellt und die Zeile kann selektiert werden.
  • Wenn das Listen-Element im Daten-Edit-Element als Navigations-Element verwendet wird, muss im Daten-Edit-Element verhindert werden, dass die Daten geändert werden können.
  • Kontextmenü-Einträge können für die Zeile aufgerufen werden, was aber durch entsprechende Prüfung im Kontextmenü-Eintrag blockiert werden kann.
• 2 = Inaktiv
  • Die Zeilenwerte werden hellgrau dargestellt und die Zeile kann nicht selektiert werden.
  • Es können auch keine Kontextmenü-Einträge für die Zeile aufgerufen werden.

Hinweis zur Verwendung des Feldwerts oder des Ausdrucks:

• Das Ergebnis wird immer in einen Integer konvertiert. Aus Performance-Gründen sind Datenzugriffe außerhalb der eigenen Zeile nicht möglich (kein „$Parent“ etc.).

Behandlung des Ergebnisses:

• Ist das Ergebnis vom Typ Integer und ist es ein gültiger Wert (siehe oben), wird dieser entsprechend verwendet. Handelt es sich nicht um einen gültigen Wert oder ist das Ergebnis nicht vom Typ Integer, wird das Ergebnis ignoriert und der Wert 0 verwendet.

Kontextmenü

(FunctionSetPartnerId, FunctionSetPackageId, FunctionSetName)

Freizuschaltende Funktionen

(FunctionSetActivationList)

Drag&Drop

(ab Version 9.0)

Titel Drop-Bereich

(DropzoneTitle)

Der Titel des Drop-Bereichs des Elementes. Darunter ist ein Bereich zu verstehen, in den per Drag&Drop-Aktion etwas abgelegt werden kann.

Der Drop-Bereich des Elementes wird angezeigt, wenn der Titel definiert ist.

Wenn als Drop-Formatname "FileDrop" eingetragen ist, wird an den Titel des Drop-Bereichs automatisch der Link "oder auswählen" angehängt. Wird der Link ausgewählt, wird automatisch ein Datei-Öffnen-Dialog angezeigt.

Der Titel kann bei angehängten Listen-Elementen (siehe "AppendToPartnerId" und "AppendToPackageId") definiert werden. Der Titel wird nach aufsteigenden Partner- und Lösungs-Ids an den Titel angehängt (außer Dubletten).

Drop-Formatnamen

(DropFormats)

Definiert eine Semikolon-separierte Liste von reservierten Namen, die angeben welche Datenformate auf dem Drop-Bereich abgelegt werden können.

Unterstützte Formate:

• "FileDrop" für Dateien (wird z.B. vom Windows Explorer beim Ziehen erzeugt)
  Eine Einschränkung der zulässigen Dateinamen-Erweiterungen kann optional (durch einen Doppelpunkt abgetrennt) angegeben werden. Mehrere Dateinamen-Erweiterungen werden durch Kommata getrennt. Z.B. schränkt "FileDrop:txt,PDF" auf TXT- und PDF-Dateien ein.

Hinweis: Alle Formatnamen aus "System.Windows.DataFormats" sind reserviert für System-seitige Erweiterungen.

Wenn "DropzoneTitle" definiert ist, muss mindestens ein Format angegeben werden.

Bei angehängten Listen-Elementen (siehe "AppendToPartnerId" und "AppendToPackageId") können weitere Formate definiert werden, die aber nur behandelt werden, wenn nicht bereits

Drop-Ausgangs-Verzeichnis

(DropInitialDirectory)

Hier kann ein Ausgangs-Verzeichnis für den Datei-Öffnen-Dialog (Drop-Format "FileDrop") angegeben werden. Ist dieses Attribut leer, wird das Desktop-Verzeichnis geöffnet.

Sinnvollerweise werden hier die zur Verfügung stehenden Platzhalter ("$[AppData]", etc.) verwendet. Insbesondere eignen sich hier "$[Temp]" und "$[UserProfile]".

Bei angehängten Listen-Elementen (siehe "AppendToPartnerId" und "AppendToPackageId") können weitere Verzeichnisse definiert werden, die aber nur behandelt werden, wenn nicht bereits für das entsprechende Format ein Verzeichnis definiert wurde.

Aktualisierungsbenachrichtigungen

(RefreshNotifications)

automatische Aktualisierung

(Refresh)

Automatische Aktualisierung (in Minuten, Wertebereich: -1 bis 120):

• 0 = keine
• -1 = Einstellung bei Konfiguration nicht angeben

Aus Performance-Gründen sollte man diese Eigenschaft sparsam einsetzen.

Die Werte werden ignoriert, wenn das Listen-Element als Unterelement in einem Selektions-Element-Feld verwendet wird.

Beim Öffnen des Elementes

(OnOpenPart)

(Ab Version 9.0.4)

Makros, die beim Öffnen des Elementes aufgerufen werden sollen (Daten stehen noch keine zur Verfügung).

Wird typischerweise verwendet, um einmalig Daten-unabhängige Einstellungen zu lesen (Dialog-Variable mit zwei Unterstreichungszeichen ("__") am Anfang verwenden; diese stehen anschließend auch Client-seitig zur Verfügung, z.B. im "OnCurrent"-Makro) oder Spalten ein- und auszublenden.

Anwendungsbeispiele:

• Spalten ein- bzw. ausblenden

Das Ereignis wird auf Server-Seite ausgelöst; das Ereignis kann bei angehängten Listen-Elementen (siehe "AppendToPartnerId" und "AppendToPackageId") definiert werden, um zusätzliche Makros ausführen zu lassen.

Bei Drop

(OnDrop)

(ab Version 9.0)

Das Makro wird aufgerufen, wenn der Inhalt einer Drag&Drop-Aktion auf die Dropzone fallen gelassen wird oder der Link "oder auswählen" angeklickt wurde (in diesem Fall wird vorher noch der Datei-Öffnen-Dialog aufgerufen, um die Dateien zu ermitteln).

Das Ergebnis kann mit den Funktionen "GetDropFormat()" und "GetDropValue()" abgerufen werden.

Die weitere Verarbeitung obliegt dem Applikations-Entwickler, d.h. ist über das Makro zu realisieren.

im Control-Center verfügbar?

(IsAvailableForControlCenter)

für Rewe?

(UseForRewe)

für Wawi?

(UseForWawi)

für WebClient?

(UseForWebClient)

Land

(Country)

Land (additiv, -1 = alle Länder):

• 1 = Deutschland
• 2 = Schweiz
• 4 = Österreich
• 32 = international

-1 oder jede beliebige Summe aus den Einzelwerten.

Geprüft wird gegen das Land des aktuellen Mandanten.

Lizenz-Kürzel

(LicenseTokens)

Lizenz-Kürzel für Sage

(SageLicenseTokens)

Feldname

(Name)

Feld-Attribute anhängen?

(DoAppendTo)

Sollen Eigenschaften an das gleichnamige Feld der in "Anhängen an..." referenzierten Listen-Elementes angehängt werden?

Einsatzzweck für Standardfelder:

• Positionieren von Feldern, die im Original keine Position haben
• Sichtbarkeit von Feldern des Originals ändern

Einsatzzweck für benutzerdefinierte Felder siehe Anhängen an…

Funktionalität

(Functionality)

Funktionalität des Feldes:

• 0 = keine
• 1 = Telefonnummer
• 2 = E-Mail-Adresse
• 3 = Hyperlink
• 5 = IBAN-Kontonummer (Ab Version 9.0.4)

Spaltennummer

(Position)

Standard Spaltennummer

Bei Feldern mit angehängten Feld-Attributen wird ein im Original-Feld definierter Wert 0 überschrieben (beim Anhängen aus mehreren Lösungen heraus aber nur für die Lösung mit der niedrigsten Partner-Lösungs-ID). Hierdurch können nicht positionierte Felder (auch benutzerdefinierte Felder) explizit positioniert werden.

Breite (Pixel)

(Width)

Sichtbarkeit

(Visibility)

Sichtbarkeit der Spalte:

• 0 = Eingeblendet
• 1 = Ausgeblendet
• 2 = Versteckt

Diese Einstellung steuert das Datenvolumen und damit auch die Performance der Liste:

• Für eingeblendete Spalten werden die Daten gelesen. Der Benutzer kann sie im Frontend per Konfiguration ausblenden.
• Für ausgeblendete Spalten werden keine Daten gelesen. Der Benutzer kann sie im Frontend per Konfiguration einblenden.
• Für versteckten Spalten werden die Daten immer gelesen. Der Benutzer sieht sie nicht in der Konfiguration.
• Szenario 1: Schlüsselsegmente, die für den Anwender nicht sichtbar sein sollen, wobei trotzdem der komplette Schlüssel vorhanden sein soll
• Szenario 2: Spalten mit Dezimalstellen für die Eigenschaft „DecimalPlacesDefinedByField“
• Szenario 3: Felder, die für Anpassungen vorgehalten werden (z.B. in der Artikelliste (Element "lstArtikelstammArtikelstamm") die "PlatzID" als Schlüssel für den Lagerplatz)

Hinweis zu technisch erforderlichen Spalten:

• Diese werden zur Laufzeit beim Lesen der Daten automatisch als „versteckt“ hinzugefügt, z.B. Schlüsselspalten, Spalten für "DecimalPlacesDefinedByField" und in Makros erwähnte Spalten

Hinweis zu nicht lizensierten Spalten:

• Diese stehen grundsätzlich nicht zur Verfügung. Um die Konsistenz sicherzustellen, fügt das System aber diese Spalten als „Versteckt“ wieder hinzu, falls sie technisch erforderlich sind.

Hinweis zu Spaltennamen in Ausdrücken oder Makros:

• Das Referenzieren auf Spalten in Ausdrücken oder Makros bewirkt, dass diese immer geladen werden, also auch, wenn der Anwender sie abgewählt hat. Deshalb sollten in der Regel nur Schlüsselfelder referenziert werden und bei nachgeschalteten Verarbeitungen darüber die Daten nachgelesen werden.

Bei Feldern mit angehängten Feld-Attributen wird der Wert des Original-Feldes überschrieben (beim Anhängen aus mehreren Lösungen heraus aber nur für die Lösung mit der niedrigsten Partner-/Lösungs-ID). Die Sichtbarkeit "Versteckt" kann nicht überschrieben werden.

Ausrichtung

(Alignment)

Ausrichtung:

• 0 = linksbündig
• 1 = rechtsbündig
• 2 = mittig

Bei Sage werden immer die Standard-Werte verwendet, abhängig vom „Datentyp“ in der Datenquellen-Definition:

• 1 bei Integer, Decimal
• sonst 0

Ampeltyp

(TrafficLight)

Ampeltyp:

• -1 = keine Ampel möglich
• 0 = keine Standard-Ampel
• 1 = gemäß Ausrichtung
• 3 = Ampel anstelle des Wertes
• 4 = Einfärbung des Wertes
• 5 = Einfärbung der Zeile (wird von Sage nicht verwendet)

"gemäß Ausrichtung" bedeutet, dass bei linksbündiger Feldausrichtung die Ampel hinter dem Wert und bei rechtsbündiger Feldausrichtung die Ampel vor dem Wert steht.

Die Definition darf nur einmal pro Listen-Element vorkommen und wird für die Datentypen Boolean, indizierter String und indiziertes Bild nicht berücksichtigt. 

Tendenz Ampel

(TrafficLightValuation)

Tendenz Ampel:

• 1 = Grenzwerte, große Werte entsprechen Rot
• 2 = Grenzwerte, kleine Werte entsprechen Rot
• 3 = SQL-Ermittlung (nur verfügbar, wenn für dieses Feld die Eigenschaft "SQL-Ampelermittlung" in der Datenquelle definiert ist)

Grenzwert Ampel-Grün

(TrafficLightLimitGreen)

Standard für Grenzwert für Ampel-Grün

Eingabe nur, wenn Tendenz Ampel 1 (Grenzwerte, große Werte) oder 2 (Grenzwerte, kleine werte) ist, Eingabe ist dann erforderlich

Grenzwert Ampel-Grün inklusive?

(IsTrafficLightLimitGreenInclusive)

Ist der Grenzwert noch grün, d.h. inklusive?

Eingabe nur, wenn Tendenz Ampel 1 (Grenzwerte, große Werte) oder 2 (Grenzwerte, kleine werte) ist, Eingabe ist dann erforderlich

Grenzwert Ampel-Gelb

(TrafficLightLimitYellow)

Standard für Grenzwert für Ampel-Gelb

Eingabe nur, wenn Tendenz Ampel 1 (Grenzwerte, große Werte) oder 2 (Grenzwerte, kleine werte) ist, Eingabe ist dann erforderlich.

Grenzwert Ampel-Gelb inklusive?

(IsTrafficLightLimitYellowInclusive)

Ist der Grenzwert noch gelb, d.h. inklusive?

Eingabe nur, wenn Tendenz Ampel 1 (Grenzwerte, große Werte) oder 2 (Grenzwerte, kleine werte) ist, Eingabe ist dann erforderlich.

Lizenz-Kürzel

(LicenseTokens)

Lizenz-Kürzel für Sage

(SageLicenseTokens)