VIO.Matrix Support - Effizienz für Entwickler

multiselect.dll - Listen erstellen und verwalten (erweitert)

Betrifft: V5.5.20

Mit Hilfe der DLL multiselect.dll kann gleichzeitig auf die Daten eines oder mehrerer Ordner und/oder Elemente zugegriffen werden. Diese DLL kann man als eine Erweiterung der vio_eingabe.dll verstehen. Die multiselect.dll bietet jedoch eine große Menge weiterer Möglichkeiten.

Anlegen:
Über den Formular-Designer im Administrator kann der DLL-Button auf einem beliebigen Formular hinzugefügt werden

Integration:
Der Aufruf des Formularvariablennamens (z.B. #INSERT_OR_VAR_multi! ) gibt die Ordner- und/oder Elementenamen der im Manager ausgewählten Ordner/Elemente in dem im Manager festgelegten Format aus. Der Aufbau der auf diesem Weg ausgegebenen Daten ist dabei abhängig von den Einstellungen der DLL im Manager.

Alternativ kann auch auf die IDs der ausgewählten Ordner oder Elemente (nicht "und"!) zugegriffen werden. Mit #INSERT_OR_VAR_multi*id! erhält man eine Liste der IDs in einem vorgegebenen XML-Format (Beispielausgabe für eine Liste von OrdnerIDs: <itemlist><orid>2</orid><orid>7</orid></itemlist>, bei Elementen steht analog <elid> statt <orid> etc.). Diese Art der Ausgabe lässt nur einen Typen zur Auswahl im DLL-Button zu (entweder Ordner oder Elemente), ist allerdings was die Zugriffe auf Daten der gelisteten Ordner oder Elemente angeht deutlich performanter. Die Konfiguration der multiselect.dll erfolgt im Contentmanager.

Um die Liste des XML-Formats in eine Ausgabe umzuwandeln benötigt man #SPLIT.

Manager:
Vor Benutzung des DLL-Buttons im Manager und Nutzung der dort gespeicherten Daten auf der Webseite, muss der DLL-Button konfiguriert werden (Rechtsklick auf Button -> Einstellungen). Hierbei gibt es folgende Einstellmöglichkeiten:

• "Ordnerauswahl zulassen": lässt die Auswahl von Ordnern zu
• "Elementeauswahl zulassen": lässt die Auswahl von Elementen zu
• "Startordner": Auswahl des Ordners von dem aus der Ordner- und Elementebaum in der multiselect.dll-Ansicht aufgebaut werden soll
• "Nur sichtbare Ordner und Elemente anzeigen": im Ordner- und Elementebaum werden nur sichtbare Ordner und Elemente angezeigt
• "Nur 1. Ebene unter dem Startordner anzeigen": es werden nur die direkt im Startordner liegenden Ordner und Elemente, nicht aber deren Unterordner oder enthaltenen Elemente angezeigt
• "Ordner und Elemente sortieren": sortiert Ordner und Elemente nach deren Namen
• "Nur Ordner ohne weitere Unterordner anzeigen": zeigt nur Ordner an, die keine Unterordner enthalten
• "Reihenfolge von Ordner und Elementen änderbar": die Reihenfolge der Ordner und Elemente im Auswahlfeld kann beeinflusst werden. Dadurch kann auf einer Webseite z.B. die Reihenfolge einer auf diesen Daten aufbauenden Ansicht bestimmt werden
• "Ordner und Elemente mehrfach auswählen": Ordner und Elemente können mehr als 1 Mal ausgewählt werden
• "Ordner und Elemente ohne Name ausblenden": namenlose Ordner und Elemente werden nicht in der Baumstruktur angezeigt
• "Ornderspezifische Wahl des Startordners": wird der Ordner, der ein Ordner oder Element enthält auf denen ein multiselect.dll-Button liegt, welcher den erstgenannten Ordner als Startordner festlegt, kopiert, wird in dem kopierten Ordner die Kopie als neuer Startordner eingetragen
• "Einträge minimal" und "maximal": beschränken der Anzahl Einträge (Ordner und Elemente), die in der multiselect.dll ausgewählt werden können
• "Vortext": Zeichenfolge, welche bei der Ausgabe vor dem ersten Ordner oder Element ausgegeben wird, z.B. <itemlist><item>
• "Nachtext": Zeichenfolge, welche bei der Ausgabe nach dem letzten Ordner oder Element ausgegeben wird, z.B. </item></itemlist>
• "Trenntext": Zeichenfolge, welche 2 Einträge in der Ausgabe trennt, z.B. </item><item>
• "Leertext": Zeichenfolge, welche für leere Einträge eingesetzt wird

Vortext, Nachtext und Trenntext sind ebenso wie die Angabe eines Startordners und die Auswahl, ob Ordner oder Elemente ausgewählt werden sollen, Pflichtfelder!

Beispielintegration:
In der Ordner-Variable "multi" sind multiselect.dll-Daten gespeichert.

#SPLIT
split_id = "1"
splittext = "</orid><orid>"
splitcontent = "#INSERT_OR_VAR_multi*id!"
pretext = "<idlist><orid>"
posttext = "</orid></idlist>"
emptytext = ""
#ENDSPLIT
Anzeige der Liste:<br />
#INSERT_ST_#1_ZEILE

Detailzeile:
Ich habe die ID #INSERT_ST_NAME und heiße #INSERT_OR_#{#INSERT_ST_NAME}_NAME.<br />

Ausgabe:
Anzeige der Liste:
Ich habe die ID 2 und heiße Birne.
Ich habe die ID 7 und heiße Apfel.