agorum.composite.form.element.objectPicker

Dieses Element stellt ein Text-Eingabefeld mit einer Schaltfläche zur Auswahl eines agorum core-Objekts dar. Sie können dabei entweder eine Ordnerauswahl oder die Suche verwenden. Der Benutzer kann ein Objekt durch Doppelklick oder durch Markieren und Klicken auf OK auswählen. 

agorum.composite.form.element.objectPicker erbt alle Grundeigenschaften von element.

Beispiel

---

Skript zur Oberfläche

let aguila = require('common/aguila');

let form = aguila.create({
  width: 500,
  height: 300,
  type: 'agorum.composite.form.basic',
  elements: [
    {
      type: 'agorum.composite.form.element.objectPicker',
      // value: '/agorum/roi/Files/Demo',
      name: 'picker1',
      label: 'Objektauswahl',
      // displayProperty: 'anyFolderPath',  // UUID, name, ID, anyFolderPath
      // valueProperty: 'ID',               // UUID, name, ID, anyFolderPath
      pickerType: 'search',                 // search, folder
      // baseFolder: '/agorum',             // start folder
      // searchParameters: {}               // parameters for search
      pickerWidth: 1000,                    // width of picker window
      pickerHeight: 1000                    // height of picker window
    }
  ]
});
form;

Parameter

---

Alle Parameter in element gelten. Zusätzlich gelten die folgenden Parameter.

pickerType

Wert	Beschreibung
folder	Öffnet eine Ordnerübersicht zur Auswahl.
search	Öffnet die Suche zur Auswahl.

Beispiel

form.down('picker1').pickerType = 'search';

• Sie können diesen Parameter nachträglich ändern.
• Das System übernimmt bei pickerType=folder den Wert aus dem Eingabefeld und versucht, den Ordner an dieser Stelle zu öffnen.

pickerWidth, pickerHeight

Definiert optional die Breite und Höhe des Explorer-/Suchfensters, wenn ein Benutzer auf die Schaltfläche zum Auswählen klickt.

• Das System definiert die optimale Breite und Höhe automatisch, wenn Sie diesen Parameter nicht angeben.
• Sie können diesen Parameter nachträglich ändern.

Beispiel

form.down('picker1').pickerWidth = 800;
form.down('picker1').pickerHeight = 600;

valueProperty

Definiert das Attribut, das das System zurückgibt, wenn ein Benutzer ein Objekt wählt.

• Der Wert steht als value des Elements zur Verfügung.
• Sie können diesen Parameter nachträglich ändern.
• Sie können alle agorum core- Attribute verwenden.

Beispiele

• name
• UUID (Standard)
• ID
• anyFolderPath
• description

form.down('picker1').valueProperty = 'UUID';

displayProperty

Definiert das Attribut, das das System zur Anzeige verwendet.

• Sie können diesen Parameter nachträglich ändern.
• Sie können alle agorum core-Attribute verwenden.

Beispiele

• name
• UUID
• ID
• anyFolderPath (Standard)
• description

form.down('picker1').displayProperty = 'anyFolderPath';

Wenn displayProperty kein ID-Attribut ist, deaktiviert sich die Eingabe des Felds. Der Benutzer kann dann nur noch über den Picker ein Objekt wählen.

ID-Attribute sind:

• ID
• UUID
• anyFolderPath

Die Anzeige bei anyFolderPath ist abhängig von der Einstellung baseFolder.

baseFolder

Definiert optional den Startordner, ab dem der Baum der Ordnerauswahl erscheint.

• Die Startordner der aktiven agorum core smart assistant-Konfiguration gelten, wenn Sie nichts angegeben.
• Der Parameter beeinflusst den Startordner bei pickerType='folder' und die Suche bei pickerType='search'.
• Bei 'folder' erscheint der Verzeichnisbaum erst ab diesem Ordner.
• Bei der Suche sucht das System nur Objekte unterhalb dieses Ordners.
• Die Angabe von baseFolder hat Einfluss auf die Anzeige, wenn Sie displayProperty='anyFolderPath' verwenden.
• Das System wählt bei Auswahl eines Objekts den bestmöglichen Startordner und übersetzt diesen. Die interne Ordnerangabe /agorum/roi/Files/Demo führt etwa zu Dateien/Demo.
• Das System beachtet bei der Eingabe in das Feld die baseFolder-Einstellungen. Der Benutzer kann nur das eingeben, was laut Anzeige funktioniert. Intern legt das System dabei value stets korrekt gemäß valueProperty ab (im Standard als UUID).
• Eingaben, die nicht korrekt sind, invalidieren das Eingabefeld mit dem Text Objekt nicht gefunden.
• Sie können diesen Parameter nachträglich ändern.

Beispiel

form.down('picker1').baseFolder = '/agorum/roi/workspace';

searchParameters

Definiert optional und nur bei pickerType=search die komplette Konfiguration der Suche und gibt sie mit, um die Suche zu steuern.

• Sie können diesen Parameter nachträglich ändern.
• Alle Einstellungen von agorum.composite.acic und agorum.composite.search.filterResultDetails gelten.

Beispiel

form.down('picker1').searchParameters = {
  query: 'hallo',
  additionalBaseQuery: 'isfolder:true',
  filterCollapsed: true,
  settingName: 'inbox-all',
  detailsWidget:  {
    type: 'agorum.composite.details',
    width: 600
  }
};

• Das System lädt im Standard für die Suche das Widget agorum.composite.acic.
• Sie können der Suche hier keine eigene Filterkonfiguration mitgeben, jedoch den widget-type.

Eigenen Filter mitgeben

form.down('picker1').searchParameters = {
  type: 'agorum.composite.search.filterResultDetails',
  filter: [ ... jetzt kann ein Filter definiert werden ... ],
  // ... weitere Parameter für filterResultDetails
};

selectors

Definiert Selektoren, die prüfen, ob das gewählte Objekt mit dem definierten Selektor übereinstimmt.

Die Schaltfläche Ok zur Übernahme des Objekts aktiviert sich erst, wenn einer der Selektoren greift (Beispiele für Selektoren siehe Selektoren).

Beispiel

// Entweder es ist ein Ordner oder der Name lautet Demo:
form.down('picker1').selectors = [
  '[isFolder=true]',
  '[name=Demo]'
];

Events

---

Alle Events in element gelten.