Schaltflächen customizen

Schaltflächen einbinden

Eine Schaltfläche wird als Datenfeld DI004336 Button/IronPython in den gewünschten Datenbereich eingebunden. Folgende Parameter mit den entsprechenden Einstellungen sind für Schaltflächen notwendig:

Shortcuts auf Schaltflächen hinterlegen

Es besteht die Möglichkeit, für Schaltflächen Tastenkombinationen zu hinterlegen.

Vorgehensweise:

• Im Datenbereich, in dem die Schaltfläche aufgenommen wurde, im entsprechenden Datenfeld im Parameter Hotkey den Buchstaben eintragen, der in der Tastenkombination enthalten sein soll.

• Speichern.

• Im Anwendungsmodul lässt sich die Funktion der Schaltfläche mit der Tastenkombination "Alt+Buchstabe" aufrufen.

Schaltflächenbereiche

• Schaltflächen können nicht nur in einen Datenbereich eingebunden werden, sie können auch in einem selbstständigen Datenbereich (Schaltflächenbereich) gecustomized werden.

• In diesem Fall besteht der Datenbereich ausschließlich aus Schaltflächen

• Folgende Parameter sind dabei im Datenbereich zu setzen:

  • DDI = 004336

  • DA-Klasse = 7

Zu Beachten beim Einbinden von Schaltflächen

• In PLANTA Project gibt es diverse Module, in denen das Einfügen und Anlegen der Datensätze eines bestimmten Bereichs zusätzlich zu Menüpunkt und Kontextmenü mittels Schaltflächen erfolgt, z.B. Schaltfläche Neu im Modul Personen (009A3Q).

• Sollen in dem von der Schaltfläche referenzierten Datenbereich die Anlage und das Einfügen verhindert werden, muss - zusätzlich zum Deaktivieren der Parameter Anlegen und Einfügen - die oben genannte Schaltfläche entfernt oder ausgeblendet werden.

Erweiterte Schaltflächen-Konfiguration (DF-Konfiguration)

Ab PLANTA Project 27 kann das Erscheinungsbild von Schaltflächen über eine JSON-Konfiguration im Parameter DF-Konfiguration (df_script_settings) individuell angepasst werden.

Die erweiterte Konfiguration steht für folgende DF-Verhalten zur Verfügung:

• c2, c4, c5: für das Datenfeld DI004336 Button/IronPython

• e2, e4, e5: für Link-Alpha-Datenfelder

Parameter der Schaltflächen-Konfiguration

Im Parameter DF-Konfiguration wird ein JSON-Objekt mit dem Schlüssel ButtonConfiguration hinterlegt. Folgende Einstellungen sind möglich:

JSON-Spezifikation

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "ButtonConfiguration",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "type": {
      "type": "string",
      "enum": ["Primary", "Default", "Dashed", "Text", "Link"],
      "description": "Visual style of the button"
    },
    "size": {
      "type": "string",
      "enum": ["Default", "Large", "Small"],
      "description": "Size of the button"
    },
    "content": {
      "type": "string",
      "enum": ["Label", "Icon", "IconLabel"],
      "description": "Defines whether the button shows text, icon only, or both"
    },
    "danger": {
      "type": "boolean",
      "description": "Whether the button represents a dangerous/destructive action"
    }
  },
  "required": [
    "type",
    "size",
    "content",
    "danger"
  ]
}

Beispiel-Konfiguration

Die folgende Konfiguration definiert eine primäre Schaltfläche in Standardgröße mit Symbol und Tooltip-Modul:

{
  "ButtonConfiguration": {
    "type": "Primary",
    "size": "Default",
    "content": "IconLabel",
    "danger": false
  },
  "Tooltip": {
    "Module": "009DWF"
  }
}

Zu beachten

• Der angezeigte Text stammt aus dem Datenfeld selbs.

  • Bei c#-Verhalten ergibt er sich aus dem Parameter DF-Überschrift (df_hdg),

  • bei e#-Verhalten aus dem Feldwert.

• Das anzuzeigende Symbol wird über den Parameter Standardwert festgelegt: DBOLE(XXXXXX) (z.B. DBOLE(001007)).

• Die Einstellung size überschreibt die Werte der Parameter DF-Breite und DF-Höhe. Bei neuen Schaltflächen haben DF-Breite und DF-Höhe keine Auswirkung.

• Für die Konfiguration steht ein Customizer-Hilfsdialog zur Verfügung (ähnlich dem Chart-Customizer).