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 mit jedem Eingabeformular-Bildschirm verwenden, unabhängig vom Eingabetyp.

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 Barcode-Eingaben, um einzelne 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 Elemente wie Produkte, Teile oder Assets zu identifizieren. Sie können diesen Eingabetyp verwenden, um Informationen zu Elementen mithilfe Ihrer Mobile-App in Ihre ServiceNow -Instanz einzugeben.

• Barcode-Eingaben können für einzelne Scans, Mehrfach-Scans oder gruppierte Scans konfiguriert werden. Einzelne Scans ermöglichen es dem Benutzer, nur einmal zu scannen. In diesem Fall muss der Benutzer 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 Eingabeformular-Bildschirm mit dem Attribut MaxEntries konfiguriert ist, können Benutzer 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 gruppierten Barcode-Abschnitt konfiguriert werden, damit Benutzer mehrere Barcode-Gruppen scannen können.

Abbildung : 1. Barcode-Scannen in einer Mobile-App

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

Attribut

Beschreibung

MaxEntries

Wird nur zum Konfigurieren von Mehrfachscannen und mehreren Barcodegruppen verwendet. Legt die maximale Anzahl von Barcodes fest, die ein Benutzer gleichzeitig scannen kann. Sie können den Wert beispielsweise auf 5 festlegen, damit Benutzer fünf Mal erneut scannen können. Hinweis: Verwenden Sie dieses Attribut nur für Multi-Scan-Barcode-Eingaben. Wenn die Barcode-Eingabe für einzelne Scans vorgesehen ist, ist kein Attribut erforderlich.

Informationen zum Erstellen eines Eingabeformular-Bildschirms mit Barcode-Eingaben finden Sie unter Konfigurieren Sie Eingabeformular-Bildschirme mit Einzel- und Mehrfachscan-Barcode-Eingaben und Konfigurieren Sie Eingabeformular-Bildschirme 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 Tabelle befinden, die im Attribut Table definiert ist.
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 auch ein parametrisiertes Datenelement mit Abfragebedingungen konfigurieren, die das Sortieren und Filtern der benutzerdefinierten Karteneingabe ermöglichen. Wichtig: Benutzerdefinierte Karteneingaben, die parametrisierte Datenelemente unterstützen, dürfen nur das Attribut ScreenId verwenden. Verwenden Sie keine anderen Attributtypen für benutzerdefinierte Karteneingaben, die parametrisierte Datenelemente unterstützen. Wenn Sie eine vorhandene benutzerdefinierte 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 benutzerdefinierten Karteneingaben verwendet wird. Wichtig: Dieses Attribut kann nicht mit anderen benutzerdefinierten Karteneingabeattributen verwendet werden. Wenn Sie das Attribut ScreenId mit einer benutzerdefinierten Karteneingabe verwenden, verwenden Sie keine anderen Attribute mit der Eingabe.
TargetTable	Auf sn_wsd_core_space festgelegt.

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 Zeitzoneninformationen des Geräts zusammen mit dem Datum und der Uhrzeit im folgenden Format an die Back-End-Instanz: JJJJ-MM-TTThh:mm:ss.sssTZD Hinweis: Die Zeitzone des Geräts unterscheidet sich von der Zeitzone des Benutzerprofils, die auf der Plattform konfiguriert ist. Wenn dieses Attribut nicht konfiguriert ist, enthält der mobile Client keine Gerätezeitzoneninformationen in den Datums-/Uhrzeit-Eingabewerten. Dieses Verhalten ist der Standardwert. Die Datums-/Uhrzeit-Eingabewerte liegen im folgenden Format vor: 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. Weitere 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 Benutzer keine zukünftigen Datumsangaben auswählen, sondern sind auf aktuelle oder vergangene Datumsangaben 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 Benutzer vergangene Daten nicht auswählen, und sie auf aktuelle oder zukünftige Daten beschränken. 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 Benutzer keine zukünftigen Daten und Uhrzeiten auswählen, sondern sind auf aktuelle oder vergangene Daten und Uhrzeiten beschränkt. Hinweis: MaxRangeHours kann zusammen mit MaxRangeDays, MinRangeDaysund MinRangeHoursverwendet werden.
MinRangeHours	Optionales Attribut, das bestimmt, ob vergangene 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 MinRangeHours auf 0 festgelegt wird, können Benutzer vergangene Daten und Uhrzeiten nicht auswählen, und sie auf aktuelle oder zukünftige Daten und Uhrzeiten beschränken. 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 Darstellungstyp 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 anderen Attribute für die Rangfolge von Eingaben als die in diesem Thema aufgeführten allgemeinen Attribute.

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 verwenden 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) zur Verwendung für Referenzlistenelemente​.
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 starts_with standardmäßig in der Anzeigebezeichnungsspalte.

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, wird 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 in einem Eingabeformular-Bildschirm zu erfassen. Signatureingaben können in Abschnitte oder Seiten von Eingabeformular-Bildschirmen eingefügt werden.

Abbildung : 4. Signatureingaben in einem Eingabeformular-Bildschirm 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. Mit dem Wert true wird die Signatur so konfiguriert, 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 Eingabeformular-Bildschirms 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 Schaltfläche zum Löschen, wenn Text im Eingabefeld vorhanden ist. Dieser Wert muss true oder falsesein und ist standardmäßig auf false festgelegt.
ConfirmDeletion	Option, um dem Anwender eine Bestätigungsmeldung anzuzeigen, bevor Text gelöscht wird, wenn ShowDeleteAllverwendet wird. Der Wert muss true oder falsesein 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.