agorum.composite.form.metadataEdit

Dieses Widget:

• bietet eine Bearbeitungsmaske für Metadaten
• kümmert sich um das Validieren, Speichern und Laden der Daten
• bietet Schaltflächen zum Bearbeiten, Speichern und Abbrechen, um etwa Aktendeckel umzusetzen

Verhalten

---

Eine Oberfläche mit den definierten Metadaten erscheint. Abhängig davon, ob die Oberfläche im Bearbeitungs- oder Ansichtsmodus ist (über den Parameter readOnly), steuert eine Toolbar die Zustände der Schaltflächen:

Zustand	Beschreibung
Bearbeiten	Aktiv, wenn die Oberfläche im Ansichtsmodus ist und der Benutzer Schreibrechte auf das Objekt besitzt.
Speichern	Aktiv, wenn die Oberfläche im Bearbeitungsmodus ist.
Abbrechen	Aktiv, wenn die Oberfläche im Bearbeitungsmodus ist.

Ändern sich Daten und klickt ein Benutzer auf Abbrechen, so weist das System den Benutzer darauf hin, dass sich Daten geändert haben und fragt, ob er sicher ist, abzubrechen. (Voraussetzung: Die verwendeten Elemente müssen als Metadaten definiert sein.)

Beispiel

---

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

let form = aguila.create({
  type: 'agorum.composite.form.metadataEdit',
  width: 500,
  height: 500,
  toolbar: 'top', 
  buttonsAlignment: 'end',
  readOnly: true,
  elements: [
    {
      name: 'ag_tags'
    },
    {
      name: 'user_ag_tags'
    }        
  ]
});

// test
setImmediate(() => {
  form.id = objects.find('/agorum/roi/Files/Demo').ID;
});

form;

Dieses Beispiel lädt eine Oberfläche zur Bearbeitung der Metadaten ag_tags und user_ag_tags auf dem Ordner /agorum/roi/Files/Demo (Dateien/Demo).

Parameter

---

Alle Parameter in agorum.composite.form - metadata-basic gelten. Zusätzlichen gelten die folgenden Parameter.

type

Der type ist immer agorum.composite.form.metadataEdit.

toolbar

Definiert, wo die Toolbar mit den Schaltflächen für Bearbeiten, Speichern und Abbrechen erscheint.

Sie können den Parameter nachträglich nicht ändern, er löst somit kein changed-Event aus.

Wert	Beschreibung
top (Standard)	Oben am Fenster
bottom	Unten am Fenster
left	Linker Rand
right	Rechter Rand

buttonsAlignment

Definiert, wie die Schaltflächen in der Toolbar ausgerichtet sind.

Sie können den Parameter nachträglich nicht ändern, er löst somit kein changed-Event aus.

Wert	Beschreibung
start	Toolbar ist oben / unten = Schaltflächen links angeordnet Toolbar rechts / links = Schaltflächen oben angeordnet
end	Toolbar ist oben / unten = Schaltflächen rechts angeordnet Toolbar rechts / links = Schaltflächen unten angeordnet

id

Definiert die ID des Objekts, von dem das System die Metadaten lädt oder speichert.

elements

Definiert ein Array von Elementen, die das System in dieser form verwendet.

Beispiel

form.elements = [
  {       
    name: 'ag_tags'
  }
];

readOnly

Wert	Beschreibung
true	Aktiviert den Ansichtsmodus.
false (Standard)	Aktiviert den Bearbeitungsmodus.

Beispiel

form.readOnly = true;

Sie können den Parameter nachträglich ändern.

Events

---

Alle Events in agorum.composite.form - metadata-basic gelten.