Eingabeformular-Bildschirmattribute für Eingaben

Zur Verwendung in Eingabeformular-Bildschirmen sind verschiedene Arten von Eingaben verfügbar, und Sie können verschiedene Attribute verwenden, um die Eingaben zu konfigurieren.

Verwenden Sie Eingabeattribute, um das Erscheinungsbild festzulegen und Beschränkungen für Eingaben festzulegen. Beispiele hierfür sind das Festlegen von Mindest- und Höchstwerten oder die Anzeige eines Eingabewerts als Prozentsatz.

Hinweis:

Bei allen Attributen wird zwischen Groß- und Kleinschreibung unterschieden.

Allgemeines Attribut

Sie können dieses Attribut unabhängig vom Eingabetyp mit jedem Eingabeformularbildschirm verwenden.

Attribut	Beschreibung
DescriptionRenderType	Definieren Sie einen Renderer-Typ für die Eingabebeschreibung. html: Ermöglicht die Formatierung von Text im Eingabefeld Beschreibung mithilfe von HTML-Tags.

Eingabe von Anhängen

Durch die Eingabe von Anhängen können Benutzer in einem Eingabeformular-Bildschirm Dateien anhängen. Für die Eingabe von Anhängen sind ein geskriptetes Aktionselement und ein actionResult-Objekt zum Hochladen von Dateien erforderlich. Hinweis: Die Eingabe von Anhängen wird nur für Skriptaktionen unterstützt.

Nachstehend finden Sie Beispielcode mit der Eingabe von Anhängen.

(function WriteBackAction(parm_input, parm_variable, actionResult) {

  //other write-back inputs and variables here

    actionResult.addAttachment("attach", "incident", gr.getUniqueValue()); //where "attach" is the input name from above screenshot, and “incident” is the table name

})(parm_input, parm_variable, actionResult); 

Barcode-Eingaben

Verwenden Sie Barcodeeingaben, um einen oder mehrere Barcodes zu scannen. Strichcodes sind maschinenlesbare Codes in Form von Zahlen und einem Muster aus parallelen Linien unterschiedlicher Breite. Diese Codes werden verwendet, um Artikel wie Produkte, Teile oder Assets zu identifizieren. Sie können diesen Eingabetyp verwenden, um mithilfe Ihrer mobilen App Informationen zu Elementen in Ihre Instanz ServiceNow einzugeben.

• Strichcodeeingaben können für Einzelscans, Mehrfachscans oder Gruppenscans konfiguriert werden. Einzelscans ermöglichen es dem Benutzer, nur einmal zu scannen. In diesem Fall muss der Anwender erneut scannen, indem er auf das Scan-Symbol tippt, wodurch der Scan-Wert gelöscht wird. Sie müssen kein Attribut für eine einzelne Scan-Barcode-Eingabe konfigurieren.
• Multi-Scan-Eingaben können mit dem Attribut MaxEntries konfiguriert werden. Wenn die Barcode-Eingabe im Eingabeformularbildschirm mit dem Attribut MaxEntries konfiguriert ist, können Anwender schnell mehrere Barcodes nacheinander scannen, ohne die Scan-Schnittstelle zu verlassen.
• Gruppierte Scans können so konfiguriert werden, dass mehrere Barcodes gescannt werden, die einem Asset zugeordnet sind, das in einem Satz gruppiert werden muss. Um eine gruppierte Barcode-Eingabe zu konfigurieren, müssen Sie im Eingabeformular-Bildschirm einen Barcode-Abschnitt erstellen, der nur Barcode-Eingaben enthält. Dann muss das Abschnittsattribut MaxEntries für den Abschnitt mit den gruppierten Barcodes konfiguriert werden, damit Benutzer mehrere Gruppen von Barcodes scannen können.

Abbildung : 1. Barcode-Scans in einer mobilen App

Sie können dieses Attribut mit Barcode-Eingaben verwenden.

Attribut

Beschreibung

MaxEntries

Wird nur zum Konfigurieren des Mehrfachscannens und mehrerer Gruppen von Barcodes verwendet. Legt die maximale Anzahl der Barcodes fest, die ein Benutzer gleichzeitig scannen kann. Sie können den Wert beispielsweise auf 5 festlegen, damit Anwender fünfmal erneut scannen können. Hinweis: Verwenden Sie dieses Attribut nur für Mehrfachscan-Barcodeeingaben. Wenn Ihre Barcode-Eingabe für einzelne Scans vorgesehen ist, ist kein Attribut erforderlich.

Informationen zum Erstellen eines Eingabeformularbildschirms mit Barcodeeingaben finden Sie unter Konfigurieren Sie Eingabeformularbildschirme mit Einzel- und Mehrfachscan-Barcodeeingaben und Konfigurieren Sie Eingabeformularbildschirme mit gruppierten Scan-Barcode-Eingaben.

Boolesche Eingaben

Verwenden Sie boolesche Eingaben für Eingaben mit „true“- oder „false“-Werten. Sie können boolesche Eingaben so konfigurieren, dass sie entweder als Kontrollkästchen oder als Umschalter angezeigt werden.

Für boolesche Eingaben können Sie die folgenden Attribute verwenden.

Attribut	Beschreibung
RenderType	Dient zur Eingabe eines Rendertyps für die boolesche Eingabe. Checkbox Zeigt die Eingabe als Kontrollkästchen an. Umschalter Zeigt die Eingabe als Umschalter an.

Auswahleingaben

Mithilfe von Auswahleingaben können Sie Benutzern Auswahlmöglichkeiten bieten. Sie können diese Auswahlmöglichkeiten manuell erstellen oder Auswahlmöglichkeiten aus einer bereits vorhandenen Tabelle bzw. einem bereits vorhandenen Feld verwenden. Auswahleingaben können als Text oder als Bilder angezeigt werden. Sie können eine Auswahleingabe so konfigurieren, dass Benutzer eine einzelne Auswahlmöglichkeit haben oder sich zwischen mehreren Auswahlmöglichkeiten entscheiden können.

Für Auswahleingaben können Sie die folgenden Attribute verwenden.

Attribut	Beschreibung
MultiSelect	Option, mit der Benutzer mehrere Auswahlmöglichkeiten für die Eingabe auswählen können. Der Wert muss true oder false sein.
Table	Tabelle, in der sich das Auswahlfeld befindet. Hinweis: Verwenden Sie diese Option, wenn Sie die Auswahlmöglichkeiten in einer bereits vorhandenen Tabelle bzw. einem bereits vorhandenen Feld verwenden möchten, anstatt Auswahlmöglichkeiten manuell zu erstellen. Sie müssen ein Feld in dieser Tabelle mit dem Attribut Field auswählen.
Field	Feld, das Ihre Auswahlmöglichkeiten enthält. Hinweis: Verwenden Sie diese Option, wenn Sie die Auswahlmöglichkeiten in einer bereits vorhandenen Tabelle bzw. einem bereits vorhandenen Feld verwenden möchten, anstatt Auswahlmöglichkeiten manuell zu erstellen. Das in diesem Attribut definierte Feld muss sich in der im Attribut Table definierten Tabelle befinden.
RenderType	Option zum Rendern der Auswahloptionen als Bild für die Auswahleingabe. Der Wert muss „ image“ sein.

Benutzerdefinierte Karteneingaben

Verwenden Sie benutzerdefinierte Karteneingaben, um einen Link zu einer Innenbereichskarte in Ihrer Mobile-App hinzuzufügen. Benutzer können diese Karten verwenden, um Wegbeschreibungen zu erhalten und Ressourcen wie Schreibtische, Besprechungsräume oder Schließfächer zu reservieren. Administratoren können ein parametrisiertes Datenelement auch mit Abfragebedingungen konfigurieren, die das Sortieren und Filtern der anwenderdefinierten Zuordnungseingabe ermöglichen. Wichtig: Anwenderdefinierte Zuordnungseingaben, die parametrisierte Datenelemente unterstützen, dürfen nur das Attribut ScreenId verwenden. Verwenden Sie keine anderen Attributtypen für anwenderdefinierte Zuordnungseingaben, die parametrisierte Datenelemente unterstützen. Wenn Sie eine vorhandene anwenderdefinierte Karteneingabe ändern, die den erweiterten Referenzqualifizierer verwendet, um ein parametrisiertes Datenelement zu verwenden, verwenden Sie nur das Attribut ScreenId, und entfernen Sie alle anderen Attribute.

Für benutzerdefinierte Karteneingaben können Sie die folgenden Attribute verwenden.

Hinweis:

Mithilfe von Mobile App Builder können Sie der Mobile-App den Eingabetyp „Benutzerdefinierte Karten“ hinzufügen, die Konfiguration der Attribute erfolgt aber in der Web-UI der Plattform Ihrer Instanz.

Attribut	Beschreibung
CustomMapConfigId	sys_id der Tabelle „sys_sg_custom_map_config“.
CustomMapDefaultProviderId	sys_id des Anbieterdatensatzes in der Tabelle „sys_sg_custom_map_provider“.
CustomMapInputs	sys_id des Stockwerks in der Tabelle „sys_sg_input“. Dieser Wert muss als JSON-Array eingegeben werden.
ScreenId	Die sys_id eines parametrisierten Datenelements, das zum Sortieren und Filtern von anwenderdefinierten Karteneingaben verwendet wird. Wichtig: Dieses Attribut kann nicht mit einem anderen anwenderdefinierten Karteneingabeattribut verwendet werden. Wenn Sie das Attribut ScreenId mit einer anwenderdefinierten Karteneingabe verwenden, verwenden Sie keine anderen Attribute mit der Eingabe.
TargetTable	Auf sn_wsd_core_space festlegen.

Datums-/Uhrzeiteingaben

Mit Datums-/Uhrzeiteingaben können Sie Benutzern die Eingabe von Datums- und Uhrzeitwerten ermöglichen. Sie können die Eingabe so konfigurieren, dass entweder Datum und Uhrzeit oder nur das Datum eingegeben werden können.

Für Datums-/Uhrzeiteingaben können Sie die folgenden Attribute verwenden.

Attribut	Beschreibung
RenderType	Dient zur Eingabe eines Rendertyps für die Datums-/Uhrzeiteingabe. date-time Zeigt Datum und Uhrzeit an. Wenn kein Renderer-Typ festgelegt wurde, ist diese Option die Standardeinstellung. date Zeigt nur das Datum an.
IncludeTimezone	Die Zeitzone des Mobilgeräts, dem die Eingabe hinzugefügt wird. Der Wert muss true oder false sein. Bei Festlegung auf truesendet der mobile Client die Gerätezeitzoneninformationen zusammen mit dem Datums- und Uhrzeitwert im folgenden Format an die Back-End-Instanz: JJJJ-MM-DDThh:mm:ss.sssTZD Hinweis: Die Zeitzone des Geräts unterscheidet sich von der Zeitzone des Anwenderprofils, die auf der Plattform konfiguriert ist. Wenn dieses Attribut nicht konfiguriert ist, berücksichtigt der Mobile Client keine Gerätezeitzonen-Informationen in den Datums-/Uhrzeit-Eingabewerten. Dieses Verhalten ist der Standard. Die Datums-/Uhrzeiteingabewerte haben das folgende Format: JJJJ-MM-TT hh:mm:ss Informationen zum Einrichten des Attributs IncludeTimezone von Datums-/Uhrzeiteingaben für verschiedene Aktionstypen finden Sie unter Setup der Datums-/Uhrzeiteingabe für verschiedene Aktionselementtypen. Informationen zu Aktionselementtypen finden Sie unter Aktionselement konfigurieren.
MaxRangeDays	Optionales Attribut, das bestimmt, ob zukünftige Daten ausgewählt werden können, wenn eine Datums-/Uhrzeiteingabe hinzugefügt wird. Dieses Attribut unterstützt sowohl positive als auch negative ganzzahlige Werte. Wenn MaxRangeDays auf 0 festgelegt wird, können Anwender keine zukünftigen Daten auswählen, und sind auf aktuelle oder vergangene Daten beschränkt. Hinweis: MaxRangeDays kann zusammen mit MinRangeDays, MaxRangeHoursund MinRangeHoursverwendet werden.
MinRangeDays	Optionales Attribut, das bestimmt, ob vergangene Daten ausgewählt werden können, wenn eine Datums-/Uhrzeiteingabe hinzugefügt wird. Dieses Attribut unterstützt sowohl positive als auch negative ganzzahlige Werte. Wenn MinRangeDays auf 0 festgelegt wird, können Anwender keine vergangenen Daten auswählen, und werden auf aktuelle oder zukünftige Daten beschränkt. Hinweis: MinRangeDays kann zusammen mit MaxRangeDays, MaxRangeHoursund MinRangeHoursverwendet werden.
MaxRangeHours	Optionales Attribut, das bestimmt, ob zukünftige Stunden ausgewählt werden können, wenn eine Datums-/Uhrzeiteingabe hinzugefügt wird. Dieses Attribut unterstützt sowohl positive als auch negative ganzzahlige Werte. Wenn MaxRangeHours auf 0 festgelegt wird, können Anwender keine zukünftigen Datums-/Uhrzeiten auswählen, und sind auf aktuelle oder vergangene Datums-/Uhrzeiten beschränkt. Hinweis: MaxRangeHours kann zusammen mit MaxRangeDays, MinRangeDaysund MinRangeHoursverwendet werden.
MinRangeHours	Optionales Attribut, das bestimmt, ob die letzten Stunden ausgewählt werden können, wenn eine Datums-/Uhrzeiteingabe hinzugefügt wird. Dieses Attribut unterstützt sowohl positive als auch negative ganzzahlige Werte. Durch das Festlegen von MinRangeHours auf 0 wird verhindert, dass Anwender vergangene Datums-/Uhrzeiten auswählen, und wird auf aktuelle oder zukünftige Datums-/Uhrzeiten beschränkt. Hinweis: MinRangeHours kann zusammen mit MaxRangeDays, MinRangeDaysund MaxRangeHoursverwendet werden.

Zahleneingaben

Mit Zahleneingaben können Sie Ihren Benutzern die Eingabe numerischer Werte ermöglichen. Durch die optionale Festlegung von Mindest- und Höchstwerten können Sie einen Zahlenbereich für die Eingabe festlegen. Optional können Sie eine Zahleneingabe konfigurieren, die als Prozentsatz angezeigt wird. Standardmäßig unterstützen Zahleneingaben Dezimalzahlen.

Für Zahleneingaben können Sie die folgenden Attribute verwenden.

Attribut	Beschreibung
RenderType	Geben Sie einen Rendertyp für die Zahleneingabe an. percentage Zeigt ein Prozentzeichen (%) hinter der eingegebenen Zahl an. line Zeigt die Eingabe als Zeilenfeld an. box Zeigt die Eingabe als Kastenfeld an. ganze Zahl Zeigt ganze Zahlen an, z. B. 3, 1003oder 57. Wenn integer verwendet wird, können Endbenutzer nur ganze Zahlen und keine Dezimalzahlen eingeben.
Max	Geben Sie einen Höchstwert für die Eingabe an.
Min	Geben Sie einen Mindestwert für die Eingabe an.

Rangfolgeeingaben

Mit Rangfolgeeingaben können Ihre Benutzer die verfügbaren Auswahlmöglichkeiten nach ihren Vorlieben und Prioritäten sortieren. Sie tippen die verfügbaren Auswahlmöglichkeiten einfach an und ziehen sie dann an eine andere Position. Die Auswahlmöglichkeiten für Rangfolgeeingaben müssen manuell definiert werden.

Es gibt keine Attribute für die Rangfolgeeingaben außer den allgemeinen Attributen, die in diesem Thema aufgeführt sind.

Referenzeingaben

Referenzeingaben eignen sich für Eingaben, die auf ein Feld in einer Tabelle verweisen. Diese Eingaben funktionieren wie Referenzfelder in den Formularen in Ihrer -Instanz. Sie können Ihre Referenzeingabe mit Bedingungen, Referenzqualifizierern und einer Suchoption konfigurieren, damit Ihre Benutzer schnell finden, was sie benötigen.

Bei der optionalen Suchoption werden Stichwortsuchen „nach Text“ verwendet. Sie unterstützt die Suche nach Elementen in der Mobile-Ansicht.

Für Referenzeingaben können Sie die folgenden Attribute verwenden.

Tabelle : 1. Erforderliche Attribute

Attribut	Beschreibung
SourceTable	Die Quelltabelle für Ihren Referenzqualifizierer.
SourceFieldName	Feldname des Referenzfelds in der Quelltabelle.
TargetTable	Die Tabelle, die Sie für Ihren Referenzqualifizierer als Ziel festlegen möchten.

Die folgenden zusätzlichen Attribute sind optional:

Tabelle : 2. Zusätzliche Attribute

Attribut	Beschreibung
MultiSelect	Option, mit der Benutzer mehrere Auswahlmöglichkeiten für die Eingabe auswählen können. Der Wert muss true oder false sein.
MobileViewId	ID der mobilen Ansicht (Ansichtskonfiguration), die für Referenzlistenelemente verwendet werden soll​.
EnableSearch	Option zum Anzeigen der Suchleiste. Der Wert muss true oder false sein.
SearchPlaceholder	Text, der in einer Suchleiste als Platzhalter angezeigt wird.
Conditions	Geben Sie eine codierte Abfrage ein, um Bedingungen auf Ihre Referenzliste anzuwenden. Weitere Informationen zum Erstellen dieser Abfragen finden Sie unter Codierte Abfragezeichenfolgen.
SearchType	Definiert die für die Suche verwendete Abfrage. Der Wert kann starts_with oder contains sein. Wenn dieses Attribut nicht konfiguriert ist, verwendet die Instanz standardmäßig starts_with für die Spalte mit der Anzeigebezeichnung.

In diesem Beispiel wird eine Eingabe im Eingabeformular-Bildschirm für das Feld Zugewiesen an in einer Tabelle „Incident“ [incident] erstellt. Zum Erstellen dieser Eingabe verwenden Sie die drei erforderlichen Attribute: TargetTable, SourceTable und SourceFieldName.

1. Benutzer wählen aus einer Liste die Benutzer aus, denen der Incident zugewiesen werden soll. Daher setzen Sie das Attribut TargetTable auf sys_user.
2. Da Sie den Benutzer einem Incident-Datensatz hinzufügen, ist das Attribut SourceTable auf incidentfestgelegt.
3. Setzen Sie den SourceFieldName auf assigned_to, sodass der ausgewählte Benutzer dem Feld Zugewiesen zu zugewiesen wird.

Abbildung : 2. Referenzeingabe für das in konfigurierte Feld assigned_to Mobile App Builder

Abbildung : 3. Referenzeingabeattribute für das in konfigurierte Feld assigned_to Mobile App Builder

Signatureingaben

Verwenden Sie Signatureingaben, um E-Signaturen auf einem Eingabeformularbildschirm zu erfassen. Signatureingaben können in Abschnitten oder Seiten des Eingabeformularbildschirms enthalten sein.

Abbildung : 4. Signatureingaben in einem Eingabeformularbildschirm auf einem Mobilgerät

Sie können das optionale Attribut IsOverlay mit Signatureingaben verwenden. Standardmäßig werden Signaturen im vollständigen modalen Fenster gerendert. Wenn der Attributwert IsOverlay auf true festgelegt ist, werden Signaturen in einem halbmodalenFenster gerendert.

Attribut

Beschreibung

IsOverlay

Legt fest, ob die Signatureingabe in einem halbmodalen Fenster geöffnet wird. Sie können den Wert auf true oder falsefestlegen. Der Wert „ true “ konfiguriert die Signatur so, dass sie in einem halbmodalen Fenster geöffnet wird. Hinweis: Wenn die Signatureingabe als einzige Eingabe auf einer Seite konfiguriert ist und das Attribut isOverlay auf truefestgelegt ist, wird das Attribut isOverlay ignoriert und die Signatureingabe wird im Vollbildmodus angezeigt.

Informationen zum Erstellen eines Eingabeformularbildschirms mit Signatureingaben finden Sie unter Konfigurieren Sie Eingabeformular-Bildschirme mit Signatureingaben.

Zeichenfolgeeingaben

Zeichenfolgeeingaben werden zur Texteingabe verwendet. Für diese Eingabe können Sie eine maximale Anzahl von Zeichen festlegen.

Für Zeichenfolgeeingaben können Sie die folgenden Attribute verwenden.

Attribut	Beschreibung
Inline	Option, mit der die Eingabe entweder inline angezeigt oder in einem separaten modalen Fenster geöffnet wird. Der Wert muss true oder false sein.
MaxLength	Maximale Anzahl von Zeichen für den Eingabewert.
ShowDeleteAll	Option zum Anzeigen einer Löschschaltfläche, wenn sich Text im Eingabefeld befindet. Dieser Wert muss „ true “ oder „ false“ sein und ist standardmäßig auf „ false “ festgelegt.
ConfirmDeletion	Option, dem Anwender bei Verwendung von ShowDeleteAlleine Bestätigungsnachricht anzuzeigen, bevor Text gelöscht wird. Der Wert muss „ true “ oder „ false“ sein und ist standardmäßig auf „ true “ festgelegt.

Bildschirmeingaben

Verwenden Sie eine Bildschirmeingabe, um einen Listenbildschirm in eine auswählbare Listeneingabe umzuwandeln. Benutzer können mehrere Listenelemente auswählen und einen Zurückschreibvorgang in den Cache durchführen.

Für Bildschirmeingaben können Sie die folgenden Attribute verwenden.

Attribut	Beschreibung
ScreenId	Konfiguriert den Listenbildschirm, der für die auswählbare Listeneingabe verwendet wird. Der Wert ist die sys_id des Listenbildschirms.
GetDataFromParent	Wandelt einen Listenbildschirm von einem übergeordneten Bildschirm in die auswählbare Listeneingabe um. Die Filter, die auf den übergeordneten Listenbildschirm angewendet werden, werden auf die Bildschirmeingabe übertragen. Geben Sie true ein, um dieses Attribut zu aktivieren. Standardmäßig ist sie in der Instanz deaktiviert.