Eingaben auf dem Bildschirm erfassen

Um Eingaben mit den intelligenten Lesegeräten von Terminal zu erfassen, rufen Sie collectInputs mit dem Terminal SDK auf. Das SDK kommuniziert mit dem Lesegerät, um eine vorgefertigte Nutzeroberfläche anzuzeigen. Sie können bis zu 5 Eingaben gleichzeitig angeben, die vom Lesegerät der Reihe nach erfasst werden. Nachdem der Kunde/die Kundin seine/ihre Daten eingegeben hat, gibt das SDK die erfassten Daten mit einem Promise zurück.

const collectInputsParameters = {
  inputs: [
    {
      formType: 'signature',
      title: 'Please sign',
      description: 'Please sign if you agree to the terms and conditions',
      skipButtonText: 'skip',
      submitButtonText: 'Submit signature',
    },
    {
      formType: 'selection',
      title: 'Choose an option',
      description: 'Were you happy with our customer service?',
      required: true,
      selectionButtons: [
        {
          style: 'primary',
          text: 'Yes',
        },
        {
          style: 'secondary',
          text: 'No',
        },
      ],
      toggles: [
        {
          title: 'Sign up for promotional emails',
          defaultValue: 'enabled',
        },
      ],
    },
  ],
};

const result = await this.terminal.collectInputs(collectInputsParameters);
if ('error' in result) {
// Placeholder for handling exception
}
// Placeholder for handling collected inputs

Anpassung

Sie können das Erscheinungsbild und das Verhalten aller Eingabetypen anpassen:

• Legen Sie wichtige Eingaben auf required fest, um sicherzustellen, dass sie erfasst werden. Bei Pflichteingaben ist die Schaltfläche Überspringen ausgeblendet.
• Stellen Sie Ihren Kundinnen/Kunden Kontext zur Verfügung, indem Sie mit title und description angeben, welcher Text für jede Eingabe auf dem Lesegerät angezeigt werden soll.

• Verwenden Sie Zeilenumbrüche in Ihrem Text für eine bessere Formatierung.
• Fügen Sie bis zu 4 Umschalter hinzu, die Kundinnen/Kunden für boolesche Optionen, Vereinbarungen oder Anmeldungen (Opt-Ins) aktivieren oder deaktivieren können.

E-Mail und Auswahlformular mit Umschalter

• Bei Eingaben vom Typ selection können Sie choices mithilfe des style-Parameters hervorheben oder in den Hintergrund stellen.

Primäre und sekundäre Auswahlstile für Designs.

Wenn das Lesegerät mit der Erfassung von Eingaben beginnt, zeigt es die erste Eingabe aus der Liste an.

Nachdem der Kunde/die Kundin alle Eingaben abgeschlossen hat, wechselt das Lesegerät für 3 Sekunden in einen Übergangszustand und wartet auf eine nachfolgende Anfrage. Wenn nach 3 Sekunden keine weitere Anfrage erfolgt, wechselt das Lesegerät wieder zum Begrüßungsbildschirm.

Wenn alle Eingaben erfasst oder übersprungen wurden, gibt das Terminal SDK die erfassten Daten zurück.

• Bei Eingaben vom Typ „Signatur“ sind die zurückgegebenen Daten eine Zeichenfolge im SVG-Format.
• Bei Eingaben vom Typ „Auswahl“ werden die Felder text und id der ausgewählten Schaltfläche zurückgegeben.
• Bei Telefon-, E-Mail-, Text- und numerischen Eingaben sind die zurückgegebenen Daten die Zeichenfolge der Kundenantwort.
• Wenn eine optionale Eingabe von der Kundin/dem Kunden übersprungen wird, wird der boolesche Wert skipped auf true gesetzt.
• Für jeden Umschalter wird entsprechend dem Index der Liste der eingegebenen Umschalter enabled, disabled oder skipped zurückgegeben.

Das Terminal SDK gibt im Falle einer abgebrochenen Aktion, einer Zeitüberschreitung bei der Erfassung oder eines anderen Fehlers einen Fehler zurück.

You can test your integration by using the SDK’s simulated reader. Before you can test input collection, you must first connect to a simulated reader.

Das simulierte Lesegerät unterstützt die Simulation der folgenden Szenarien:

• Erfolgreiche Erfassung von Eingaben ohne Überspringen von Eingaben
• Erfolgreiche Erfassung von Eingaben durch Überspringen aller nicht erforderlichen Eingaben
• Die Erfassung der Eingaben ist aufgrund einer Zeitüberschreitung fehlgeschlagen.

Bei der Simulation einer erfolgreichen Eingabeerfassung gibt das SDK für jede Eingabe basierend auf dem Typ einen hartcodierten Wert zurück.

// Simulated internet reader must already be connected
collectInputsResult = {
    resultType: 'succeeded' as SimulatedCollectInputsResultType,
    skipBehavior: 'none' as SimulatedCollectInputsSkipBehavior,
} as ISimulatedCollectInputsResultSucceeded;
this.terminal.setSimulatorConfiguration({ collectInputsResult });
const collectInputsParameters = {
    inputs: // Placeholder for specifying the inputs you want to simulate collecting
};
const result = await this.terminal.collectInputs(collectInputsParameters);
if ('error' in result) {
    // Placeholder for handling exception
} else {
    // Placeholder for handling collected inputs
}