Dynamische Eingaben

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 5 Minuten Lesedauer

    • Generieren Sie jedes Mal, wenn jemand die Aktion in einem Flow konfiguriert, eine Liste von Aktionseingaben oder Eingabewerten. Dynamische Eingaben können eine Liste zugehöriger Aktionseingaben, eine Liste von Feldern aus einem Datensatz oder eine Liste von Optionen anzeigen, die in einer Auswahlliste verfügbar sind.

    Hinweis:
    Dynamische Eingaben sind im Basissystem nicht verfügbar. Zur Verwendung dynamischer Eingaben in Workflow-Studio, Müssen Sie Fordern Sie an IntegrationHub Pluginan. Dynamische Eingaben sind Teil des Plugins „ServiceNow Flow Designer – Introspektion“ [com.Glide.Hub.Flow_Designer_introspektion].
    Während des Flow-Designs rufen dynamische Eingaben Werte ab und zeigen sie dynamisch als Eingaben innerhalb einer Aktion an. Diese Typen dynamischer Eingaben sind für Aktionsautoren verfügbar.
    Dynamische Auswahl
    Die Eingabe „dynamischer Auswahltyp“ erfasst eine Liste der anzuzeigenden Auswahlwerte. Weitere Informationen zum Erstellen einer dynamischen Auswahl finden Sie unter Erstellen Sie eine Datenerfassungsaktion für eine dynamische Auswahl .
    Dynamische Eingaben
    Die Eingabe vom Typ „dynamische Eingaben“ erfasst eine Liste zusätzlicher Aktionseingaben, die angezeigt werden sollen. Verwenden Sie dynamische Eingaben, um einer Aktion beliebige Eingaben hinzuzufügen. Weitere Informationen zum Erstellen dynamischer Eingaben finden Sie unter Erstellen Sie eine Datenerfassungsaktion für eine Eingabe vom Typ „dynamische Eingaben“.
    Dynamische Vorlage
    Die Eingabe „dynamischer Vorlagentyp“ erfasst eine Liste von Feldern aus einem dynamisch ausgewählten Datensatztyp. Flow-Autoren können dann auswählen, welche Felder in ihren Flow aufgenommen werden sollen. Da die Liste der Felder dynamisch generiert wird, müssen Sie die Aktion nicht ändern, wenn Felder der Quelltabelle hinzugefügt oder entfernt werden. Weitere Informationen zum Erstellen einer dynamischen Vorlage finden Sie unter Erstellen Sie eine Datenerfassungsaktion für eine dynamische Vorlage .
    Es gibt drei allgemeine Schritte zur Verwendung dynamischer Eingaben.
    1. Ein Aktionsautor erstellt eine Datenerfassungsaktion, um dynamische Daten zu generieren.
    2. Ein Aktionsautor erstellt eine Aktion mit einer dynamischen Eingabe und konfiguriert die dynamische Eingabe so, dass die Datenerfassungsaktion aufgerufen wird.
    3. Ein Flow-Autor fügt die Aktion einem Flow hinzu und konfiguriert die Aktion mit dynamisch erfassten Daten.

    Datenerfassungsaktionen

    Eine Datenerfassungsaktion erfasst Daten, die von anderen Aktionen verwendet werden sollen. Datenerfassungsaktionen sollen aus dynamischen Eingaben aufgerufen werden, anstatt direkt einem Flow hinzugefügt zu werden. Datenerfassungsaktionen erfassen normalerweise Daten aus Drittparteisystemen mithilfe eines REST-Aufrufs. Alle Datenerfassungsaktionen müssen diese Anforderungen und Einschränkungen erfüllen.
    • Die Aktion hat einen Skriptschritt Die eine Ausgabevariable vom Typ JSON enthält.
    • Die Aktion hat eine Ausgabe mit dem Namen outputVom Typ JSON, dessen Wert von der JSON-Ausgabevariable des Skriptschritts abgeleitet wird.
      Hinweis:
      Die Aktion kann mehrere Ausgaben haben, aber nur eine vom Typ „JSON“.
    • Der Skriptschritt formatiert die JSON-Ausgabe so, dass sie eine Eigenschaft mit dem Namen hat Daten .
    • Die JSON-Ausgabe darf nicht mehr als 5000 Auswahloptionen, Feldvorlagenwerte oder Array-Elementelemente zurückgeben, wenn die Daten für eine dynamische Auswahl oder eine dynamische Vorlageneingabe vorgesehen sind.
      Hinweis:
      Dynamische Auswahl und dynamische Vorlageneingaben können nur bis zu 5000 Auswahloptionen oder 5000 Vorlagenwerte aus der JSON-Ausgabe anzeigen.
    • Die Aktion wartet bis zu 300 Sekunden (5 Minuten), um Daten zu erfassen, bevor eine Zeitüberschreitung auftritt.
      Hinweis:
      Um den Zeitüberschreitungszeitraum für alle Aktionen zu ändern, ändern Sie den Wert von sn_flow_designer.sync_action_execution_timeout_in_secondsSystemeigenschaft.

    Unterstützte dynamische Eingabedatentypen

    Dynamische Eingaben unterstützen eine begrenzte Anzahl von ServiceNow AI Platform Datentypen. Sie können das Beispiel-JSON verwenden, um eigene dynamische Eingaben zu erstellen. Sie können die Werte der Bezeichnungs- und Namenseigenschaften entsprechend Ihren Anforderungen ändern. Die Typeigenschaft muss einen angeben ServiceNow AI Platform Datentypname. Weitere Informationen zu finden ServiceNow AI Platform Felddatentypen und ihre Konfiguration finden Sie unter Field types reference.

    Tabelle : 1. Dynamische Eingabedatentypen werden unterstützt
    Eingabedatentyp Beispiel-JSON
    Auswahl 
    { 
    data: [{
      label: 'Choice type input',
      name: 'choicetype',
      defaultValue: 'choice_1',
      type: 'choice',
      choices: [
          { label: 'Choice 1', value: 'choice_1' },
          { label: 'Choice 2', value: 'choice_2' }
      ]
    }]
  }
    Datetime 
    { 
    data: [{
      label: 'Datetime type input',
      name: 'datetimetype',
      type: 'datetime',
    }]
  }
    Dezimal 
    { 
    data: [{
      label: 'Decimal type input',
      name: 'decimaltype',
      type: 'decimal',
    }]
  }
    E-Mail 
    { 
    data: [{
      label: 'Email type input',
      name: 'emailtype',
      type: 'email',
    }]
  }
    HTML 
    { 
    data: [{
      label: 'HTML type input',
      name: 'htmltype',
      type: 'html',
    }]
  }
    Ganzzahl 
    { 
    data: [{
      label: 'Integer type input',
      name: 'integertype',
      type: 'integer',
    }]
  }
    Passwort 2 
    { 
    data: [{
      label: 'Password2 type input',
      name: 'password2type',
      type: 'password2',
    }]
  }
    Referenz 
    { 
    data: [{
      label: 'Reference type input',
      name: 'referencetype',
      reference: 'sys_user',
      type: 'reference',
    }]
  }
    Zeichenfolge 
    { 
    data: [{
      label: 'String type input',
      name: 'stringtype',
      defaultValue: 'abcdef',
      type: 'string',
      mandatory: true
    }]
  }

    Allgemeine Leitlinien

    Berücksichtigen Sie dynamische Eingaben für Integrationen von Drittparteien
    Mit dynamischen Eingaben können Sie Flows erstellen, die dynamisch Daten aus externen Quellen abrufen. In Drittpartei-Integrationen können dynamische Eingaben Datenwerte bereitstellen, die sich auf einen bestimmten Endpunkt beziehen. Weitere Informationen zum Einrichten von Drittpartei-Integrationen mit finden Sie Workflow-Studio, Siehe IntegrationHub .
    Beachten Sie die Zeit, die zum Abrufen großer Datenmengen erforderlich ist
    Standardmäßig haben dynamische Eingaben bis zu 300 Sekunden Zeit, um Daten zu erfassen, bevor sie eine Zeitüberschreitung aufweisen. Wenn Ihre Datenerfassungsaktion mehr Zeit zum Sammeln von Daten benötigt, legen Sie fest sn_flow_designer.sync_action_execution_timeout_in_secondsSystemeigenschaft auf einen höheren Wert. Verwenden Sie jedoch keine langen Zeitüberschreitungswerte für interaktive Flows, bei denen ein Endanwender einen Wert eingeben oder auswählen muss.
    Achten Sie auf Skriptfehler
    Da alle Datenerfassungsaktionen einen Skriptschritt verwenden, können beim Skripting potenzielle Fehler auftreten. Wenn Sie Skripts zur Ausgabe von JSON-Variablen für Ihre dynamischen Eingaben verwenden, können Fehler auftreten, die verhindern, dass Eingaben die benötigten JSON-Werte erhalten. Wenn ein dynamischer Eingabeskripting-Fehler auftritt, wird möglicherweise die folgende Warnmeldung angezeigt.
    Abbildung : 1. Meldung, die für Skriptfehler angezeigt wird
    Fehlermeldung für dynamische Aktion
    Beschränken Sie Eingaben vom Typ „dynamische Eingaben“ auf 40 Eingabewerte
    Eine Eingabe vom Typ „dynamische Eingaben“ kann nur eine bestimmte Anzahl von Eingaben rendern, bevor das JSON-Objekt zu groß wird, um es im Arbeitsspeicher zu speichern. Wenn Sie Ihre dynamischen Eingaben auf 40 Eingabewerte beschränken, wird die Wahrscheinlichkeit minimiert, dass der Arbeitsspeicher ausgeht und unerwartetes Verhalten wie Renderingfehler oder Datenkürzung auftritt.
    Beschränken Sie die JSON-Ausgabe auf 5000 Array-Elemente für dynamische Vorlagen und dynamische Auswahlmöglichkeiten
    Dynamische Auswahl und dynamische Vorlageneingaben können nur bis zu 5000 Array-Elemente anzeigen. Eine dynamische Auswahl kann nur bis zu 5000 Auswahllistenoptionen anzeigen, und eine dynamische Vorlage kann nur bis zu 5000 Feldvorlagenwerte anzeigen. Wenn Ihre Datenerfassungsaktion Daten für eine dynamische Vorlage oder eine dynamische Auswahl erfasst, beschränken Sie die maximale Anzahl von Array-Elementen, die zurückgegeben werden, auf 5000. Der Grenzwert für 5000 Array-Elemente verhindert, dass die Instanz beim Rendern der Auswahlmöglichkeiten oder Feldwerte Leistungsprobleme aufweist.