5.23.3. Konfigurationsdatei für 3Dfindit (custom_config.json)
5.23.3.2. Buttons zur Benutzeroberfläche zufügen
Zurück  Weiter

5.23.3.2. Buttons zur Benutzeroberfläche zufügen

5.23.3.2.1. Benutzerdefinierter Button in der Hauptleiste
5.23.3.2.2. Benutzerdefinierte Unterbuttons in der Hauptleiste
5.23.3.2.3. Benutzerdefinierte Buttons oberhalb Tabelle
5.23.3.2.4. Benutzerdefinierte Buttons oberhalb 3D-Ansicht
5.23.3.2.5. Benutzerdefinierte Buttons in Suchergebnissen
5.23.3.2.6. Vollständiges Beispiel zum Kopieren

[Hinweis]Hinweis

Die Default-Konfiguration liegt unter /libs/pappserver/webapps/3dfindit-enterprise/custom_config.json und enthält nur ein paar Standard-Einstellungen:

{
  "baseApiPath": "",
  "basename": "/webapps/3dfindit-enterprise",
  "erp": true,
  "startRoute": "CadBim",
  "isEnterprise": true
}

Wenn Sie irgendwelche Änderungen vornehmen (z.B. zusätzliche Buttons) speichern Sie die komplette Konfiguration unter "$CADENAS_SITESETUP/3df/custom_config.json". Sofern die Datei noch nicht vorhanden ist, legen Sie diese entsprechend an.

Die Konfigurationsdatei enthält einen Hauptabschnitt mit einigen Standard-Einstellungen für 3Dfindit und dann einen "toolbars"-Abschnitt.

Toolbar-Buttons können an folgenden Positionen gesetzt werden:

  • Hauptmenü -> "mainMenu"

  • Oberhalb Tabelle -> "table"

  • Oberhalb 3D-Ansicht -> "viewer"

  • Bei den Suchergebnissen an verschiedenen Positionen bzw. bei verschiedenen Ereignissen:

    • Oberhalb vorhandener Suchergebnisse -> "searchResults"

    • Anstelle nicht vorhandener Suchergebnisse -> "noResults"

    • Im Kontextmenü von Suchergebnissen -> "searchResultsContextMenu"

Buttons selbst und deren Funktionalität sind definiert im "buttons"-Abschnitt. Jeder Button hat einen Typ, der entweder JS oder VBS ist:

  • JS wird direkt im Browser ausgeführt. Es kann nur auf Browser-Funktionen zugreifen, z.B. andere Webseiten oder APIs aufrufen.

  • VBS wird serverseitig ausgeführt und in der AppServer-Umgebung.

Jeder Button hat ein Icon icon und einen Namen name.

{
  "baseApiPath": "",
  "basename": "/webapps/3dfindit-enterprise",
  "erp": true,
  "startRoute": "CadBim",
  "isEnterprise": true,

  "toolbars": {
    "viewer": ["exampleButton"],
    "table": ["exampleVBSButton"],

    "mainMenuTitle": {
      "de-DE": "Spezial Menü",
      "en-GB": "Special menu"
    },
    "mainMenuTooltip": {
      "de-DE": "Spezial menü für zusätzliche Funktionen",
      "en-GB": "Special menu for additional function"
    },

    "mainMenuIcon": "/webapps/3dfindit-enterprise/plugins/plugInDefault.svg",
    "mainMenu": [
      ["customButton1_Group1", "customButton2_Group1", "customButton3_Group1"],
      ["customButton1_Group2", "customButton2_Group2", "customButton3_Group2"]
    ],
    "noResults": ["customButton1", "customButton2", "customButton3"],
    "searchResults": ["customButton1", "customButton2", "customButton3"],
    "searchResultsContextMenu": ["customButton1", "customButton2", "customButton3"],
  
    "buttons": {
      "exampleButton": {
        "type": "JS",
        "name": {
          "de-DE": "JS Beispiel",
          "en-GB": "JS Example"
        },
        "callback": "onExampleButtonClicked",
        "icon": "images/bell-solid.svg",
        "tooltip": {
          "de-DE": "JS Beispiel",
          "en-GB": "JS Example"
        }
      },
      "exampleVBSButton": {
        "type": "VBS",
        "icon": "images/bell-solid.svg",
        "name": {
          "de-DE": "VBS Beispiel",
          "en-GB": "VBS Example"
        },
        "script": "/plugins/vbb/wstest.vbs",
        "requestFromPdm": "currentuser",
        "tooltip": {
          "de-DE": "VBS Beispiel",
          "en-GB": "VBS Example"
        }
      }
    }
  }
}

[Hinweis]Hinweis

Die im Beispiel verwendeten Bilder liegen unter \sitesetup\3df\plugins.

Zurück Nach oben Weiter
5.23.3.1. Sachmerkmalstabelle: Farbliche Markierung von Wertebereichs- und Dokumenten-Spalten Zum Anfang 5.23.3.2.1. Benutzerdefinierter Button in der Hauptleiste