...
| Info |
|---|
Eine Property einer Entitiy, welche durch dieses Plugin verwaltet wird, enthält entweder einen Integer oder ein Integer-Array und muss auch mit den gleichen Datentypen befüllt werden. |
Verwendung
Verwendung bei einem Feld der Modelling
Folgende Mindestkonfiguration muss als Feldkonfiguration hinterlegt werden:
| Codeblock | ||||
|---|---|---|---|---|
| ||||
feature{ "source": "inputInput/foreignKeyForeignKey.[single|multiple|editable]" inputForeignKeyEditExternal: [false|true] foreignKeyCriteria "foreignKeyCriteria": [Zusätzliche Suchkriterien] "relation": { "repository": "[Tabellenidentifikator]" "column": "[Spaltenidentifikator]", "datapool": "[Datenpoolidentifikator]" } } |
Verwendung bei einem Feld des Datenbankwidgets
...
| Codeblock | ||||
|---|---|---|---|---|
| ||||
{
// [...],
"formType": "featureSelect",
"featuresource": "inputInput/foreignKeyForeignKey.[single|multiple|editable]",
"configuration": {
// [...],
"foreignKeyCriteria": [Zusätzliche Suchkriterien]
"inputForeignKeyEditExternal": [false|true],
"relation": {
"repository": "[Tabellenidentifikator]",
"column": "[Spaltenidentifikator]",
"datapool": "[Datenpoolidentifikator]"
}
}
// [...]
} |
...
| Bezeichnung | Mögliche Werte | Beschreibung | |||
|---|---|---|---|---|---|
featuresource | inputInput/foreignKeyForeignKey.singleinput
| Legt den FeatureSource-Aufruf für brandbox fest.
| |||
foreignKeyCriteria | Ein oder mehrere Einträge. Schlüssel des Eintrags entspricht einem eindeutigen Feldidentifikator und der Wert einem erwarten Wert im angegebenen Feld. Der Platzhalter | Legt ein oder mehrere zusätzliche Suchkriterien für mögliche Datensätze fest. Gemeinsam mit einem durch den Benutzer definierten Suchfilter werden alle Kriterien mit einer UND-Verknüpfung verbunden und damit die entsprechende Datenbanktabelle durchsucht. | inputForeignKeyEditExternal|||
true oder false | Legt fest, dass man direkt in einen ausgewählten Datensatz springen kann ohne die aktuellen Änderungen zu speichern. Hierzu wird bei aktiver Einstellung ein zusätzlicher Button neben dem Eingabefeld angezeigt.
repository | Eindeutiger Identifikator einer Datentabelle | Aus der hier angegebenen Tabelle werden die auswählbaren Datensätze ausgelesen. | ||
column | Eindeutiger Identifikator eines Feldes | Werden auswählbare Datensätze zur Auswahl präsentiert oder durchsucht wird dieses Feld genutzt. | |||
datapool | Eindeutiger Identifikator eines Datenpools | Diese Eigenschaft ist gilt ausschließlich für Tabellen welche über die Tabellenstrukturen definiert wurden. Hier muss ein entsprechender Identifikator hinterlegt werden.
|
...
Wert in feature | Beschreibung |
|---|---|
inputInput/foreignKeyForeignKey.single | Einfaches Auswahlfeld ohne erweiterte Funktionen |
inputInput/foreignKeyForeignKey.multiple | Feld mit Mehrfachauswahl von einem oder mehreren Datensätzen. Keine Bearbeiten- und Anlegen-Funktion. |
inputInput/foreignKeyForeignKey.editable | Einfach-Auswahlfeld für einen Datensatz mit Buttons für die Bearbeitung und das Anlegen eines neuen Datensatzes. Wurde die Option inputForeignKeyEditExternal auf true gesetzt wird hier zusätzlich ein Button angezeigt welches direkt zu dem ausgewählten Datensatz führt. |
Events
| Methode | Eingabe | Rückgabe | Beschreibung |
|---|---|---|---|
getCriteria |
| array | This event can be subscribed to when it is neccessary to manipulate the possible entries of a foreign key input field. The subscribers are expected to manipulate the array of criteria that is processed when a foreign key input field is searching for its possible entries. |
getParameter |
| array | This event can be subscribed to when it is neccessary to manipulate the array of parameters that are provided to the search function of a foreign key input field when it searches for its entries. |
getQueryBuilderCriteria |
| array | This event can be subscribed to when it is neccessary to manipulate the possible results when searching for a foreign key value by using the search filter in uiBase. The subscribers are expected to manipulate the array of criteria that is processed when "component/querybuilder" build the search query. |
save |
| void | This event can be subscribed to when it is neccessary to mainpulate the save proccess when creating a new dataset via the "Create dataset"-button of the foreign key input field. |
onPopulateButton |
| void | This event can be subscribed to when it is neccessary to add or remove buttons from the foreign key input field. |