Ressourcensteuerung
Diese Funktionalität ist nur in der PRO-Edition verfügbar.
Eine komplexe Steuerung, die verwendet wird, um mehreren Ressourcen und deren Menge einer Aufgabe zuzuweisen (Link: assigningresources).
gantt.config.lightbox.sections = [
{ name: "description", height: 38, map_to: "text", type: "textarea", focus: true},
{ name: "owner", height: 60, type: "resources", default_value: 8}, /*!*/
{ name: "time", type: "duration", map_to: "auto"}
];
oder
gantt.config.lightbox.sections = [
{ name: "description", height: 38, map_to:"text", type: "textarea", focus: true },
{ name: "time", type: "duration", map_to: "auto" },
{ name: "rooms", type: "resources", map_to: "rooms", options: [ /*!*/
{ key: 1, label: "room 1", unit: "hours" }, /*!*/
{ key: 2, label: "room 2", unit: "hours" }, /*!*/
{ key: 3, label: "room 3", unit: "hours" } /*!*/
] /*!*/
} /*!*/
];
gantt.locale.labels.section_rooms = "Rooms";
Sie können auch eine benutzerdefinierte Steuerung erstellen, um einer Aufgabe mehrere Ressourcen zuzuweisen (Link: guides/custom-editor.md#customthirdpartyeditor).
Initialization
Um die Ressourcen-Steuerung dem Lightbox hinzuzufügen, befolgen Sie die folgenden Schritte:
- Fügen Sie eine Sektion zur Lightbox-Konfiguration hinzu:
gantt.config.lightbox.sections = [
{ name: "description", height: 38, map_to: "text", type: "textarea", focus: true },
{ name: "time", type: "duration", map_to: "auto" },
{ name: "rooms", type:"resources" } /*!*/
];
- Legen Sie ein Label für den Abschnitt fest:
gantt.locale.labels.section_resources = "Rooms";
Eigenschaften
Die folgenden Eigenschaften sind größtenteils wichtig und werden häufig für die Ressourcen-Steuerung festgelegt (siehe die vollständige Liste hier):
- name - (string) der Abschnittsname
- map_to - (string) der Name einer Daten-Eigenschaft, die dem Abschnitt zugeordnet wird
- type - (string) der Typ der Abschnittskontrolle
- options - (array) ein Array von Objekten. Definiert Auswahloptionen der Steuerung (verwendet für die select, checkbox,radio und resources Steuerelemente).
Jedes Objekt im Array spezifiziert eine einzelne Option und enthält die folgenden Eigenschaften:
- key - (string) die Options-ID. Dieses Attribut wird mit der Task-Daten-Eigenschaft verglichen, um Optionen Tasks zuzuweisen
- label - (string) die Optionsbeschriftung
- unit - (number) die Einheit der Messung der Ressource
- focus - (boolean) wird auf true gesetzt, erhält der Abschnitt beim Öffnen des Lightbox den Fokus
- default_value - (any) der Standardwert des Abschnitts-Steuerelements. Wird angewendet, wenn der Wert der Ressource undefiniert ist. Jeder Eintrag aus dem options-Array kann seinen eigenen Standardwert haben.
Standardmäßig ist die Ressourcen-Steuerung dem in der resource_property Konfiguration angegebenen Eigenschaft zugeordnet, sodass die map_to-Option entfallen kann.
Standardmäßig wird die Ressourcen-Steuerung automatisch aus dem Resource-Datenspeicher über die gantt.serverList("resourceOptions") Collection befüllt. Man muss die Optionsliste nur manuell angeben, wenn man das Standardverhalten ändern möchte.
Populate-Steuerung mit Daten
Ab Version 8.0 bezieht die Ressourcen-Steuerung standardmäßig Optionen aus dem Resource-Datenspeicher.
Verwendest du den Standard-Resource-Datenspeicher, der von Gantt erzeugt wird, und die Ressourcensteuerung wird ohne den Parameter options initialisiert, wird sie mit der gantt.serverList("resourceOptions")-Sammlung verbunden. Diese Sammlung wird mit den Ressourcen aus dem Resource-Datenspeicher befüllt. Du kannst Optionen per Code abrufen:
const options = gantt.serverList("resourceOptions");
Hinweis: Das Options-Array bleibt leer, bevor die Ressourcen in den Datenspeicher geladen werden.
Du kannst diese Sammlung auch mit benutzerdefinierter Optionsliste aktualisieren:
gantt.updateCollection("resourceOptions", [...]);
Hinweis: Falls du Ressourcen danach in den Gantt lädst, wird diese Sammlung aktualisiert und deine Änderungen überschrieben.
Wenn du festlegen möchtest, welche Ressourcen in das Lightbox-Fenster gelangen, kannst du die Konfiguration von gantt.config.resources.lightbox_resources neu definieren:
gantt.config.resources = {
lightbox_resources: function selectResourceControlOptions(resources){
const lightboxOptions = [];
resources.forEach(function(res) {
if (!gantt.$resourcesStore.hasChild(res.id)) {
const copy = gantt.copy(res);
copy.key = res.id;
copy.label = res.text;
lightboxOptions.push(copy);
}
});
return lightboxOptions;
}
};
Wenn du den Resource-Datenspeicher manuell erstellst, musst du die Ressourcensteuerung mit den Optionen selbst befüllen.
Generell gilt: Um Werte für die resources-Steuerung festzulegen, verwende den options-Parameter:
gantt.config.lightbox.sections = [
{ name:"rooms",type:"resources",map_to:"rooms",
options:[
{ key: 1, label: "room 1", unit: "hours" },
{ key: 2, label: "room 2", unit: "hours" },
{ key: 3, label: "room 3", unit: "hours" }
]
}
];
Elemente im options-Parameter haben 3 verpflichtende Eigenschaften:
- key - die Options-ID
- label - die Options-Beschriftung
- unit - die Einheit der Messung der Ressource
Populate-Steuerung mit Daten vom Server
Um die Steuerung vom Server aus zu befüllen, setzen Sie die options-Option auf den von der serverList Methode zurückgegebenen Wert:
gantt.config.lightbox.sections = [
{name: "description", height: 38, map_to: "text", type: "textarea", focus: true},
{name: "resources", type: "resources", map_to: "owner_id", default_value:8,
options: gantt.serverList("resourceOptions")},
{name: "time", type: "duration", map_to: "auto"}
];
gantt.init("gantt_here");
gantt.load("/data");
Der Inhalt von gantt.serverList("resourceOptions") kann definiert werden, wenn die Optionen verfügbar werden, mittels der updateCollection-Methode:
gantt.updateCollection("resourceOptions", [
{ key: 1, label: "room 1", unit: "hours" },
{ key: 2, label: "room 2", unit: "hours" },
{ key: 3, label: "room 3", unit: "hours" }
])