StandaloneClientMethods

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer
  • Eigenständige Client-Methoden sind Methoden, die Sie in Ihren Client-JavaScripts verwenden können, z. B. „reflistOpen“, sind jedoch nicht Teil einer Klasse oder API.

    Sie können direkt in einem Client-Skript auf diese Methoden zugreifen, ohne dass ein Konstruktor oder eine andere Art der Instanziierung verwendet wird.

    Eigenständig – reflistOpen (Zeichenfolgenziel, ZeichenfolgenelementName, ZeichenfolgenrefTableName, Zeichenfolgenabhängig, ZeichenfolgenuseQBE, Zeichenfolge refQualElements, Zeichenfolge additionalQual, Zeichenfolge parentid, Zeichenfolge forceReference, Zeichenfolge 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:

    Referenzdaten im Popup-Fenster

    Ebenso können Sie diese Methode verwenden, um ein Suchformular anzuzeigen, mit dem der Anwender seine eigenen Abfragekriterien für die Auswahl der anzuzeigenden Referenzfelddaten eingeben kann.

    Suchen Sie im Popup-Fenster

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

    „sys_user_list.do?sysparm_Tiny=7ea02c4ff8a8b510f877c74d78b60460“ .

    Hinweis:

    ReflistOpen() Wird im Arbeitsbereich-Client-Skript nicht unterstützt. Verwenden Sie G_modal.showFrame() Stattdessen Methode.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    target Zeichenfolge Referenzfeld-ID des Formularziels.

    Zum Beispiel die Anrufer_ID Die Zielreferenzfeld-ID des Parameters ist incident.caller_id .

    Elementname Zeichenfolge Name des Formularreferenzfeldelements.

    Beispiel: Anrufer_ID

    refTableName Zeichenfolge Referenztabelle, die dem Formularreferenzfeld zugeordnet werden soll.

    Beispiel: Für das Referenzfeld Anrufer_ID , Sys_user ist die Referenztabelle. In diesem Fall übergeben Sie den Wert sys_user .

    dependent Zeichenfolge Konfiguriertes abhängiges Feld für den angegebenen targetElement.

    Weitere Informationen finden Sie unter Make a field dependent.

    UseQBE Zeichenfolge Kennzeichnung, die die Art der Informationen angibt, die im Popup-Fenster zurückgegeben werden sollen.
    Gültige Werte:
    • Wahr: Zeigt ein Abfrageformular mit einer Suchschaltfläche an.
    • Falsch: Zeigt die Abfrageergebnisse an.

    Standardwert: false

    RefQualElements Zeichenfolge Konfigurierter Referenzqualifizierer für den angegebenen targetElement. 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 einschließen möchten, übergeben Sie eine leere Zeichenfolge.

    Weitere Informationen zu Referenzqualifizierern finden Sie unter Reference qualifiers.

    AdditionalQual Zeichenfolge Optional. Zusätzliche Qualifiziererabfrage, die zum Filtern der Ergebnisse verwendet werden soll, die im Popup-Fenster angezeigt werden.

    Beispiel: Für Anrufer_ID Referenzfeld in einem Incident können Sie die sys_ID des Anwenders übergeben sys_ID=62826bf0371020004e0bfc8bcbe5df1 .

    Die Funktion filtert die Anwendertabelle [sys_user] und zeigt die gefilterten Ergebnisse im Popup-Fenster an.
    Übergeordnete ID Zeichenfolge Optional. Derzeit nur ein interner Parameter, es muss kein Wert übergeben werden.
    ForceReference Zeichenfolge Optional. Derzeit nur ein interner Parameter, es muss kein Wert übergeben werden.
    IgnoreTargetValue Zeichenfolge Optional. Derzeit nur ein interner Parameter, es muss kein Wert übergeben werden.
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    Popup-Fenster Zeigt die zurückgegebenen Referenzfelddaten in einem Standard-Popup-Fenster an.

    Das folgende Beispiel zeigt, wie Sie diese Methode aufrufen, um die Felddaten des Anrufers im Popup-Fenster für die Incident-Tabelle anzuzeigen (erstes Bild 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, aber mit UseQBE = wahr , Das eine Suchschaltfläche und zugehörige Suchkriterien im Popup-Fenster (zweites Bild oben) anzeigt.

    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', '');
    }