cell/POPUPLINK

Der cell/POPUPLINK wird benutzt, um in einer driver/edit-Maske oder einer driver/editlinks-Maske ein 1-n-Link-Feld mit einem Wert zu befüllen. Dazu öffnet die easydb in einem separaten Fenster einen Editor oder eine Suche und der Benutzer legt ein neues Link-Objekt an oder sucht ein existierendes.

cell/POPUPLINKs funktionieren im Prinzip wie cell/SINGLELINKs, sind aber flexibler:

sie können direkt einen Editor öffnen
sie können einen beliegen cell/REPORT rendern, um Informationen zum Link-Objekt anzuzeigen

Verfügbarkeit

Dieser Content-Driver ist in den folgenden Drivern verfügbar:

Parameter

Field	Die Spalte in der aktuellen Tabelle in der die ID des Link-Objektes gespeichert wird.
Linktable	Die Tabelle mit den Link-Objekten.
Require Content	Wenn auf yes gesetzt, wird beim Speichern überprüft, ob dieses Feld korrekt ausgefüllt ist. Für Text-Felder reicht es ein Zeichen einzugeben. Die Fehlermeldung, nutzt den Screen-Name aus dem Creator-Database zur Benennung des Feldes. Für Felder, für die die Option Not Null gesetzt ist, wird automatisch ein Check durchgeführt, es sei denn dieser Parameter ist auf skip gesetzt. Seit Version 4.0.199.
Mode	Der Modus in dem der POPUPLINK betrieben wird: search zeigt ein S für das Aufrufen der Suche (HTML-title kann über Stringtool l10n.popuplink.tooltip.Search angepasst werden). remove zeigt ein X zum Entfernen der Verlinkung (HTML-title kann über Stringtool l10n.popuplink.tooltip.Remove angepasst werden). edit zeigt ein E zum Editieren des aktuellen Link-Objektes (HTML-title kann über Stringtool l10n.popuplink.tooltip.Edit angepasst werden). new zeigt ein + um ein Link-Objekt neu anzulegen und sofort zu Verlinken (HTML-title kann über Stringtool l10n.popuplink.tooltip.New angepasst werden). Wenn Sie hier einen Editor mit Asset-Management angeben und der Benutzer mehr als ein Asset hochlädt, so wird je Asset ein editlink erstellt, sofern sich dieser cell/POPUPLINK in einem driver/editlinks-Maske befindet. none zeigt keine Buttons, wird verwendet mit grid/LINK-editlinks/add connect_popuplink_mode.
Search Mask	Die driver/search-Maske, die benutzt wird.
Force Search	Wenn gesetzt, wird die Suche im Fenster neu geladen, sonst zeigt sie die letzte Ansicht. Die Suche wird dabei bei jeden Aufruf geleert (automatischer "formreset"). Seit Version 4.0.199..
Edit Mask	Die driver/edit-Maske, die benutzt wird. Wird nur benötigt, wenn Mode edit oder new beinhaltet.
Window Open Parameters	Der 3. Parameter für die Javascript window.open Funktion, die zum Öffnen des separaten Fensters benutzt wird. Beispiel: width=550,height=600,resizable=yes,scrollbars=yes
Refresh Report Gcell ID	GCELL-ID eines cell/REPORT welcher aktualisiert wird, sobald sich der verlinkte Wert ändert. Der cell/REPORT muss über dasselbe Field in dieselbe Link-Tabelle verknüpfen.
Empty Grid Mask	driver/grids-Maske die an Stelle der Refresh Report Gcell ID gerendert wird, wenn noch kein Link-Objekt ausgewählt und verknüpft ist. Nur, wenn Refresh Report Gcell ID gesetzt ist.
Div Class	DOM class der DIV, die den POPUPLINK umschließt. Default: popuplinks.
Callback	PHP-Funktion welche bei jeder Popuplink-Aktion mit einigen Laufzeit-Informationen aufgerufen wird.

POPUPLINKS / SINGLELINKS in der Suche markieren

POPUPLINKS

Wichtig ist, dass die Popuplinks eine Report Gcell Id benutzen ( ist im Standard der Fall ).
Standardmäßig wird die Key_Id, die in diesem Report gerendert wird, an die Suche weitergegeben
Die Suche empfängt diese ID in "db_id" im Request und im "report_key_id" im Request
Eine abweichende "db_id" kann gesetzt werden, in dem in dem Report ein DOM-Element ( z.B. eine ) mit dem Attribute "popuplink_id" eingebettet wird. Der Wert dieses Attributes bestimmt die "db_id". Die kann verwendet werden, wenn die Suche der verlinkten Objekte nicht über dieselbe Tabelle läüft wie die Verlinkung ( z.B. Person / Person-Namensvariante )

SINGLELINKS

Eine Suche der markierten Singlelinks findet automatisch statt. Es gibt keine Einflussmöglichkeit im Creator.

Markierung POPUPLINKS / SINGLELINKS

Die Suche versucht die "db_id" im aktuellen Suchergebnis zu finden und dort hinzuspringen.
Wenn die Suche das Objekt nicht findet, wird eine Search-Message gesetzt, welche mit cell/FUNCTION/search_search_message ausgegeben werden muss.
Diese Message benutzt 2 Stringtool-Variablen:
- l10n.search.error.EditedObjectNotSelectable: Das neue Objekt ist in der aktuellen Suche nicht findbar.
- l10n.search.EditedObjectShow: Objekt anzeigen.
In der Suche wird der "link_insert" des Results mit der "report_key_id" markiert ( class=marked ), bei SINGLELINK ist das immer gleich der "db_id", bei POPUPLINK kann es abweichen.