EigenständigeClient-Methoden

Eigenständige Client-Methoden sind Methoden, die Sie in Ihren Client-Javascripts verwenden können, z. B. reflistOpen, aber nicht Teil einer Klasse oder API sind.

Sie können direkt in einem Client-Skript ohne Konstruktor oder andere Instanziierung vor der Verwendung auf diese Methoden zugreifen.

Standalone – reflistOpen (String target, String elementName, String refTableName, String Abhängig, String useQBE, String refQualElements, String additionalQual, String parentID, StringforceReference, String ignoreTargetValue)

Zeigt die Referenzfelddaten in einem Standard-Popup-Fenster an. Diese Methode wird häufig verwendet, wenn in UI 16-Formularen neben einem Referenzfeld ein Lupensymbol ausgewählt wird.

Mit dieser Methode können Sie beispielsweise Referenzfelddaten für einen bestimmten Satz von Abfragekriterien anzeigen:

Ebenso können Sie diese Methode verwenden, um ein Suchformular anzuzeigen, in dem der Benutzer eigene Abfragekriterien für die Auswahl der anzuzeigenden Referenzfelddaten eingeben kann.

Wenn die URL beim Öffnen der URL im Standard-Popup-Fenster größer als TinyURL ist (standardmäßig 1024), wird die URL in TinyURL konvertiert, z. B.:

„sys_user_list.do?sysparm_tiny=7ea02c4ff8a8b510f877c74d78b60460“.

Hinweis:

reflistOpen() wird in Workspace-Client-Skripts nicht unterstützt. Verwenden Sie stattdessen die Methode g_modal.showFrame().

Tabelle : 1. Parameter

Name	Typ	Beschreibung
target	Zeichenfolge	Referenzfeld-ID des Formularziels. Zum Beispiel lautet die Zielreferenzfeld -ID des Parameters caller_id incident.caller_id.
elementName	Zeichenfolge	Name des Formularreferenzfeldelements. Beispiel: caller_id
refTableName	Zeichenfolge	Referenztabelle, die dem Formularreferenzfeld zugeordnet werden soll. Beispiel: Für das Referenzfeld caller_idist sys_user die Referenztabelle. In diesem Fall würden Sie den Wert sys_user übergeben.
dependent	Zeichenfolge	Konfiguriertes abhängiges Feld für das angegebene Element target. Weitere Informationen finden Sie unter Make a field dependent.
verwendenQBE	Zeichenfolge	Kennzeichnung, die die Art der Informationen angibt, die im Popup-Fenster zurückgegeben werden sollen. Gültige Werte: true: Zeigt ein Abfrageformular mit einer Suchschaltfläche an. false: Abfrageergebnisse anzeigen. Standardwert: false
refQualElemente	Zeichenfolge	Konfigurierter Referenzqualifizierer für das angegebene Element target. Die Funktion hängt die angegebenen Referenzqualifizierer an die URL an und zeigt nur die gefilterten Ergebnisse im Popup-Fenster an. Wenn Sie keinen Referenzqualifizierer einbeziehen möchten, übergeben Sie eine leere Zeichenfolge. Weitere Informationen zu Referenzqualifizierern finden Sie unter Reference qualifiers.
zusätzlicheQual	Zeichenfolge	Optional. Zusätzliche Qualifiziererabfrage, die zum Filtern der im Popup-Fenster angezeigten Ergebnisse verwendet werden soll. Zum Beispiel könnten Sie für ein Referenzfeld caller_id in einem Incident die sys_id des Benutzers sys_id=62826bf03710200044e0bfc8bcbe5df1 übergeben. Die Funktion filtert die Benutzertabelle [sys_user] und zeigt die gefilterten Ergebnisse im Popup-Fenster an.
parentID	Zeichenfolge	Optional. Derzeit nur ein interner Parameter, kein Wert muss übergeben werden.
kraftReferenz	Zeichenfolge	Optional. Derzeit nur ein interner Parameter, kein Wert muss übergeben werden.
ignoreTargetValue	Zeichenfolge	Optional. Derzeit nur ein interner Parameter, kein Wert muss übergeben werden.

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Popup-Fenster	Zeigt die zurückgegebenen Referenzfelddaten in einem Standard-Popup-Fenster an.

Das folgende Beispiel zeigt, wie diese Methode aufgerufen wird, um die Anruferfelddaten im Popup-Fenster für die Incident-Tabelle anzuzeigen (erste Abbildung oben).

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
   if (isLoading || newValue === '') {
      return;
   }

   reflistOpen('incident.caller_id', 'caller_id', 'sys_user','company', 'false', '');
}

Das folgende Beispiel zeigt, wie dasselbe Client-Skript aufgerufen wird, jedoch mit useQBE = true, wodurch eine Suchschaltfläche und zugehörige Suchkriterien im Popup-Fenster angezeigt werden (zweite Abbildung oben).

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
   if (isLoading || newValue === '') {
      return;
   }

   //  Type appropriate comment here, and begin script below
   reflistOpen('incident.caller_id', 'caller_id', 'sys_user','company', 'true', '');
}