---
sourceDocument: Yokohama Mobile-Konfiguration und -Navigation
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/mobile

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama Mobile-Konfiguration und -Navigation

ft:clusterId :

    - mobile

bundleId :

    - mobile

workflow :

    - Platform


---

# Beispiele für Datenquellenskript

# Beispiele für Datenquellenskript {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 5. März 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer

Verwenden Sie Datenquellskripts, um Eingabewerte, beschreibende Elemente und Eingabeaktionen zuzuordnen. Erstellen Sie alternativ eine dedizierte Datenquelle für jedes dieser Elemente.
Das Datenquellskript akzeptiert zwei Parameter: <var class="keyword varname">Wertzuordnung </var>Und <var class="keyword varname">Kontext </var>. Der Kontextparameter bezieht sich auf das Eingabeformular, mit dem der Anwender interagiert. Die <var class="keyword varname">Wertzuordnung </var>Der Parameter ist für die Verknüpfung von Elementbezeichnern mit bestimmten Tabellenspalten über verantwortlich <var class="keyword varname">AddRecordMapping </var>Methode. Der Methodenaufruf könnte beispielsweise folgendermaßen aussehen:

    valuesMapper.addRecordMapping(UNIQUE_ELEMENT_IDENTIFIER, GLIDE_RECORD_INSTANCE, COLUMN_NAME);

Hinweis:  
Alle in diesem Thema aufgeführten Skripts werden im Datenquellendatensatz konfiguriert. Weitere Informationen finden Sie unter [Konfigurieren Sie Datenquellen](https://servicenow-prod.fluidtopics.net/~aTzwEDv0uY~lLDAscTvdQ "Konfigurieren Sie Datenquellen, um UI-Elemente mithilfe von Elementbezeichnern bestimmten Datenbankfeldern zuzuordnen, um den Abruf und die Anzeige von Daten auf Eingabeformularbildschirmen zu ermöglichen. Diese Zuordnung verifiziert, dass jedes UI-Element das entsprechende Datenfeld in einem Datensatz genau wiedergibt.").

## Standardmäßiges Beispielskript {#data-source-script-examples__section_g31_xvm_p2c}

Im Folgenden finden Sie das Beispielskript, das im Mobile App Builder bereitgestellt wird. Das Skript bietet eine Vorlage, die zeigt, wie eine vorhandene Tabelle gefiltert und bestimmte Felder UI-Elementen zugeordnet werden.

    (function DataSource(valuesMapper, context) {
    var gr = new GlideRecord(TABLE_NAME); // Could be any table within the Instance, including custom tables
    gr.addQuery('sys_id',context.getUniqueValue());
    gr.query();
    if (gr.next()) { // Could also be itetaring muliple records from the same table using the 'while' iterator

        valuesMapper.addRecordMapping('short_description',gr,'short_description'); // Map the field short_description to a UI element that has element identifier of "short_description". The element identifier could be any String, it's easier to map the column's name as the element identifer.

        valuesMapper.addRecordMapping('priority',gr,'priority'); // Map the field priority to a UI element that has element identifier of "priority". The element identifier could be any String, it's easier to map the column's name as the element identifier.

    }
    })(valuesMapper, context);

Dieses Beispielskript enthält:

* Die folgenden Parameter, die die Datenquelle definieren:
  * <var class="keyword varname">Wertzuordnung </var>: Dieser Parameter wird verwendet, um die Werte aus der Datenquelle den UI-Elementen zuzuordnen.
  * <var class="keyword varname">Kontext </var>: Dieser Parameter gibt den Kontext an, in dem die Datenquelle verwendet wird, z. B. ein Incident, eine Change-Anforderung oder eine andere Tabelle.
  {#data-source-script-examples__ul_mjx_cwm_p2c}
* Die <var class="keyword varname">AddRecordMapping </var>Die Methode wird zum Zuordnen der Felder verwendet und besteht aus den folgenden Parametern:
  * Elementbezeichner: Der eindeutige Name, den Sie für das Feld definiert haben, das Sie zuordnen. Im Beispiel ist dies `<short description> `Und `<priority> `.
  * Glide-Datensatz `<gr> `: Wird verwendet, um auf eine Tabelle in der Instanz zu verweisen, einschließlich anwenderdefinierter Tabellen.
  * Feldname: Dies ist der Name des Felds im Glide-Datensatz. Im Beispiel ist dies `<short description> `Und `<priority> `.  
    Hinweis:  
    Eine allgemeine Richtlinie besteht darin, den Elementbezeichner mit dem Feldnamen zu benennen, um den Code leichter zu verwalten und zu verstehen.
  {#data-source-script-examples__ul_lcm_3wm_p2c}
{#data-source-script-examples__ul_wpq_bwm_p2c}

## Skript zum Zuordnen von Eingaben, die im Eingabeformular konfiguriert sind {#data-source-script-examples__section_cny_nwm_p2c}

Im Folgenden finden Sie ein Beispielskript, das demonstriert, wie <var class="keyword varname">Elementbezeichner </var>Attribut von Eingaben, die in der Attributtabelle \[sys_sg_input_attribute\] konfiguriert sind, wird verarbeitet. Das Skript enthält Beispiele für die Zuordnung eines Eingabewerts zu einer Spalte in der Incident-Tabelle mit fünf Eingaben mit dem Namen <var class="keyword varname">Input_1 </var>, <var class="keyword varname">Input_2 </var>, <var class="keyword varname">Input_3 </var>, <var class="keyword varname">Input_4 </var>, <var class="keyword varname">Input_5 </var>.

    (function DataSource(valuesMapper, context) {
    var gr = new GlideRecord('incident');
    gr.addQuery('sys_id',context.getUniqueValue());
    gr.query();
    if (gr.next()) {
    // Map the column short_description from the incident table to the elementIdentifier "input_1_short_description".
    valuesMapper.addRecordMapping('input_1_short_description', gr,'short_description'); 

    // Map the column start_time from the incident table to the elementIdentifier "input_2_start_time".
    valuesMapper.addRecordMapping('input_2_start_time',gr,'start_time'); 

    // Map the column score from the incident table to the elementIdentifier "input_3_score".
    valuesMapper.addRecordMapping('input_3_score', gr,'score'); 

    // Map the column assigned_to from the incident table to the elementIdentifier "input_4_assigned_to".
    valuesMapper.addRecordMapping('input_4_assigned_to',gr,'assigned_to');

    // Map the attachment from the record in the incident table to the elementIdentifier "input_5_attachment_1" (The column name must be "sys_id").
    valuesMapper.addRecordMapping('input_5_attachment_1',gr,'sys_id');

     }
    })(valuesMapper, context);

Dieser Code definiert die Funktion <var class="keyword varname">Datenquelle </var>Das bestimmte Spalten aus dem Tabellendatensatz für Incidents \[Incident\] den entsprechenden Elementbezeichnern zuordnet. Der folgende Prozess findet statt:

* Erstellt <var class="keyword varname">GlideRecord </var>Objekt für die Tabelle „Incident \[Incident\]".
* Fragt die Tabelle nach einem Datensatz mit einem bestimmten ab <var class="keyword varname">sys_ID </var>Mit einem eindeutigen Wert aus <var class="keyword varname">Kontext </var>.
* Wenn ein Datensatz gefunden wird, werden die folgenden Spalten ihrem entsprechenden eindeutigen Elementbezeichner zugeordnet:
  * <var class="keyword varname">Short_description </var>Bis <var class="keyword varname">input_1_short_description </var>
  * <var class="keyword varname">Start_time </var>Bis <var class="keyword varname">input_2_start_time </var>
  * <var class="keyword varname">Punktzahl </var>Bis <var class="keyword varname">Input_3_Punktzahl </var>
  * <var class="keyword varname">Assigned_to </var>Bis <var class="keyword varname">input_4_assigned_to </var>
  * <var class="keyword varname">sys_ID </var>Bis <var class="keyword varname">input_5_attachment_1 </var>
  {#data-source-script-examples__ul_v3n_dxm_p2c}
{#data-source-script-examples__ul_bn5_zwm_p2c}

## Skript zum Zuordnen beschreibender Elemente, die Eingaben oder Eingabeabschnitten im Eingabeformular zugeordnet sind {#data-source-script-examples__section_u2s_hxm_p2c}

Im Folgenden finden Sie ein Beispielskript, das demonstriert, wie Sie mit umgehen <var class="keyword varname">Elementbezeichner </var>Attribut eines beschreibenden Elements, konfiguriert in der Tabelle des beschreibenden Elements \[ sys_sg_descriptive_element\].

    (function DataSource (valuesMapper, context) {
    var gr = new GlideRecord('incident');
    gr.addQuery('sys_id',context.getUniqueValue());
    gr.query();
    if (gr.next()) {
    // Handle descriptive element of type Rich Text. Map to a column named "rich_text_1_col" in the incident table to the elementIdentifier "input_1_rich_text_descriptive_element_id". The col type in the "incident" should be "HTML"
    valuesMapper.addRecordMapping('input_1_rich_text_descriptive_element_id',gr,'rich_text_1_col'); 

    // Handle descriptive element of type Text. Map to a column named "plain_text_1_col" in the incident table to the elementIdentifier "input_1_text_descriptive_element_id". The col type in the "incident" should be "String"/"String (Full UTF-8)"
    valuesMapper.addRecordMapping('input_1_text_descriptive_element_id',gr,'plain_text_1_col'); 

    // Handle descriptive element of type Image. Map to a column named "image_1_col" in the incident table to the elementIdentifier "input_1_image_descriptive_element_id". The col type in the "incident" should be "Image"
    valuesMapper.addRecordMapping('input_1_image_descriptive_element_id',gr,'image_1_col'); 
    }
    })(valuesMapper, context);

Dieser Code definiert die Funktion <var class="keyword varname">Datenquelle </var>Das bestimmte Spalten aus dem Tabellendatensatz für Incidents \[Incident\] den entsprechenden Elementbezeichnern zuordnet. Der folgende Prozess findet statt:

* Erstellt <var class="keyword varname">GlideRecord </var>Objekt für die Tabelle „Incident \[Incident\]".
* Fragt die Tabelle nach einem Datensatz mit einem bestimmten ab <var class="keyword varname">sys_ID </var>Mit einem eindeutigen Wert aus <var class="keyword varname">Kontext </var>.
* Wenn ein Datensatz gefunden wird, werden die folgenden Spalten ihrem entsprechenden eindeutigen Elementbezeichner zugeordnet:
  * <var class="keyword varname">rich_text_1_col </var>(HTML-Typ) bis <var class="keyword varname">input_1_rich_text_descriptive_element_id </var>
  * <var class="keyword varname">plain_text_1_col </var>(Zeichenfolgentyp) bis <var class="keyword varname">input_1_text_descriptive_element_id </var>
  * <var class="keyword varname">Image_1_Col </var>(Bildtyp) bis <var class="keyword varname">input_1_image_descriptive_element_id </var>
  {#data-source-script-examples__ul_y2x_vxm_p2c}
{#data-source-script-examples__ul_sbf_txm_p2c}

## Skript zum Zuordnen von Eingabeaktionen, die Eingaben im Eingabeformular zugeordnet sind {#data-source-script-examples__section_bjw_cym_p2c}

Im Folgenden finden Sie ein Beispielskript, das demonstriert, wie Sie mit umgehen <var class="keyword varname">Elementbezeichner </var>Attribut der Eingabeaktionen, die in der Tabelle „Eingabeformularaktion" \[sys_sg_parameter_action\] konfiguriert sind.

    (function DataSource(valuesMapper, context) {
    var gr = new GlideRecord('incident');
    gr.addQuery('sys_id',context.getUniqueValue());
    gr.query();
    if (gr.next()) {
    // Handle an attachment type input action. Map the elementIdentifier "input_1_action_attachments" to a record in the incident table by specifying the sys_id as the column in the table.
    valuesMapper.addRecordMapping('input_1_action_attachments',gr,'sys_id'); 

    // Handle a comment type input action. Map the elementIdentifier "input_1_action_comment" to a column in the incident table where the comment is stored. In this example, the comment is stored in the //"comment_by_agent" column.
    valuesMapper.addRecordMapping('input_1_action_comment',gr,'comment_by_agent'); 

    //Handle a navigation type input action with a record context.
    Map the elementIdentifier "input_1_navigation" to a record in the incident table by specifying the sys_id as the column in the table.
    valuesMapper.addRecordMapping('input_1_navigation',gr,'sys_id'); 
    }
    })(valuesMapper, context);

Dieser Code definiert die Funktion <var class="keyword varname">Datenquelle </var>Das bestimmte Spalten aus einem Incident-Tabellendatensatz \[Incident\] den entsprechenden Elementbezeichnern zuordnet. Der folgende Prozess findet statt:

* Erstellt ein GlideRecord-Objekt für die Tabelle „Incident".
* Fragt die Tabelle nach einem Datensatz mit einem bestimmten ab <var class="keyword varname">sys_ID </var>Mit einem eindeutigen Wert aus <var class="keyword varname">Kontext </var>.
* Wenn ein Datensatz gefunden wird, werden die folgenden Spalten ihrem entsprechenden eindeutigen Elementbezeichner zugeordnet:
  * <var class="keyword varname">sys_ID </var>Bis <var class="keyword varname">input_1_action_attachments </var>Zur Verarbeitung von Eingabeaktionen vom Typ „Anhang".
  * <var class="keyword varname">Comment_by_Agent </var>Bis <var class="keyword varname">input_1_action_comment </var>Zur Verarbeitung von Eingabeaktionen vom Typ „Kommentar".
  * <var class="keyword varname">sys_ID </var>Bis <var class="keyword varname">Input_1_Navigation </var>Für die Verarbeitung von Eingabeaktionen des Navigationstyps mit einem Datensatzkontext.
  {#data-source-script-examples__ul_qvf_mzm_p2c}
{#data-source-script-examples__ul_dwj_kzm_p2c}