EigenständigeClient-Methoden

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 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 in einem Client-Skript ohne Konstruktor oder andere Art der Instanziierung direkt auf diese Methoden zugreifen, bevor Sie sie verwenden.

    Eigenständig – reflistOpen (Zeichenfolgenziel, Zeichenfolgen-elementName, Zeichenfolgen-refTableName, Zeichenfolgenabhängig, Zeichenfolgen-useQBE, Zeichenfolgen-referenzQualElements, Zeichenfolge zusätzlicheQual, Zeichenfolgen-parentID, Zeichenfolgen-forceReference, Zeichenfolgen-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 der folgenden 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, in das der Benutzer eigene Abfragekriterien eingeben kann, um die anzuzeigenden Referenzfelddaten auszuwählen.

    In Popup-Fenster suchen

    Wenn die URL im Standard-Popup geöffnet wird und die URL-Länge größer als TinyURL-Länge ist (standardmäßig 1024), 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 stattdessen die Methode g_modal.showFrame().

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    target Zeichenfolge ID des Formularzielreferenzfelds.

    Die Zielreferenzfeld -ID des Parameters „caller_id“ lautet beispielsweise incident.caller_id.

    elementName Zeichenfolge Name des Formularreferenzfeldelements.

    Beispiel: caller_id

    refTableName Zeichenfolge Referenztabelle, die dem Formularreferenzfeld zugeordnet werden soll.

    Für das Referenzfeld caller_idist beispielsweise 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 target -Element.

    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:
    • wahr: Zeigt ein Abfrageformular mit einer Suchschaltfläche an.
    • „falsch“: Zeigt die Abfrageergebnisse an.

    Standardwert: false

    RefQualElements Zeichenfolge Konfigurierter Referenzqualifizierer für das angegebene target -Element. 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.

    zusätzlicheQual Zeichenfolge Optional. Zusätzliche Qualifiziererabfrage zum Filtern der Ergebnisse, die im Popup-Fenster angezeigt werden.

    Beispielsweise können Sie für das Referenzfeld caller_id in einem Incident die sys_id sys_id=62826bf03710200044e0bfc8bcbe5df1des Benutzers ü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, für den kein Wert übergeben werden muss.
    Kraftreferenz Zeichenfolge Optional. Derzeit nur ein interner Parameter, für den kein Wert übergeben werden muss.
    ignorierenZielwert Zeichenfolge Optional. Derzeit nur ein interner Parameter, für den kein Wert übergeben werden muss.
    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 Daten des Anruferfelds 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, 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', '');
    }