Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • Now Platform capabilities
Table of Contents
Choose your release version
    Home Orlando Now Platform Capabilities Now Platform capabilities Flow Designer Action Designer Action input and output data types

    Action input and output data types

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    Action input and output data types

    Action inputs and outputs are data variables that store data of a particular data type.

    Flow Designer supports action inputs and outputs with these data types:
    • Array
      • Array.Boolean
      • Array.Choice
      • Array.Datetime
      • Array.Integer
      • Array.Object
      • Array.String
    • Audio
    • Choice
    • Color
    • Condition String
    • Conditions – Reference table required
    • Currency
    • Data Structure
    • Date
    • Date/Time
    • Document ID – Reference table required
    • Due Date
    • Duration
    • Dynamic Choice
    • Dynamic Template
    • Encrypted Text
    • Field Name
    • Floating Point Number
    • HTML
    • IP Address (Validated IPV4, IPV6)
    • Icon
    • Image
    • Integer
    • Journal
    • Journal Input
    • Journal List
    • List
    • Long
    • Name-Value Pairs
    • Password (1 Way Encrypted)
    • Password (2 Way Encrypted)
    • Percent Complete
    • Phone Number (E164)
    • Price
    • Records – Reference table required
    • Reference – Reference table required
    • Script
    • Script (Plain)
    • String
    • String (Full UTF-8)
    • Table Name
    • Template Value – Reference table required
    • Time
    • Translated HTML
    • Translated Text
    • True/False
    • URL
    • Video
    • Wiki
    • Workflow

    Advanced options for action inputs

    Use advanced options to further configure your inputs.

    All

    The following options are available for all advanced inputs.

    Option Description
    Name The name that identifies the array in script calls.
    Hint Text to display to flow designers so they know what information the array contains.
    Default Value The value used when an input value is not provided. For example, the default selection of a choice field or a default string in a string field.
    Mandatory The input requires a value.

    Some action inputs have additional options. The details of these options are listed below.

    Array

    Option Description
    Max Rows The maximum number of rows you want to display in the user interface. This does not set a limit on the maximum number of rows in the array object.

    Array.Choice

    Option Description
    Max length The maximum length the system stores for an input choice value. Use this option to restrict the length of input values stored during action design.
    Choice Select from:
    • Dropdown with --None--
    • Dropdown without --None--
    Choice list Select from:
    • Create New Choice list to manually create choices. Use the add button (Add button) to create a choice with Name, Value, and Order values.
    • Reference existing choice list on a table to select a choice list from and field on an existing table using the Choice Table and Choice field buttons.

    Array.Object

    Option Description
    Structure Select from:
    • Create Structure Manually
    • Start from Template
    Template Select a template to use for this array.
    Save as Template Save the current array as a template.

    Array.String

    Option Description
    Max Length The maximum length the system stores for an input string value. Use this option to restrict the length of input values stored during action design.

    Password (2 Way Encrypted) design considerations

    Follow these guidelines when designing flows containing Password (2 Way Encrypted) data.

    • To specify the encryption algorithm and the roles allowed to access encrypted data, see Setup encryption contexts.
    • Flow Designer prevents manual entries in Password (2 Way Encrypted) values in flow inputs.
    • Fields containing Password 2 data cannot be used in conditions.
    • To assign a value to a password2 field, drag an existing password2 data pill. Dragging values from other field types is not supported. Flow Designer presents a warning message when password2 data is required.
      The warning message displayed when dragging a non-password2 data pill onto a password2 field.
    • Flow Designer prevents dragging Password2 data pills into other field types, and presents a warning message when the field is incompatible type.
      The warning shown when dragging a password2 field to a disallowed field.
    • Flow Designer only allows Password2 data pills to be dragged into the following field types.
      • Email body fields
      • HTML fields
      • Password 2 Fields
      • PowerShell Input Variables
      • REST fields
        • Variables
        • REST payload body
        • Query parameters
        • Headers
        • REST multi-part form values
        • Form URL-encoded values
      • SOAP fields
        • Headers
        • Envelope

    Flow Designer performs a validation check when a user saves, publishes, or tests actions and flows. This check shows an alert for any data pills dropped in restricted field types and prevents the action or flow from executing. Update the action or flow to remove the invalid data pill and then retry the action.

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      Action input and output data types

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      Action input and output data types

      Action inputs and outputs are data variables that store data of a particular data type.

      Flow Designer supports action inputs and outputs with these data types:
      • Array
        • Array.Boolean
        • Array.Choice
        • Array.Datetime
        • Array.Integer
        • Array.Object
        • Array.String
      • Audio
      • Choice
      • Color
      • Condition String
      • Conditions – Reference table required
      • Currency
      • Data Structure
      • Date
      • Date/Time
      • Document ID – Reference table required
      • Due Date
      • Duration
      • Dynamic Choice
      • Dynamic Template
      • Encrypted Text
      • Field Name
      • Floating Point Number
      • HTML
      • IP Address (Validated IPV4, IPV6)
      • Icon
      • Image
      • Integer
      • Journal
      • Journal Input
      • Journal List
      • List
      • Long
      • Name-Value Pairs
      • Password (1 Way Encrypted)
      • Password (2 Way Encrypted)
      • Percent Complete
      • Phone Number (E164)
      • Price
      • Records – Reference table required
      • Reference – Reference table required
      • Script
      • Script (Plain)
      • String
      • String (Full UTF-8)
      • Table Name
      • Template Value – Reference table required
      • Time
      • Translated HTML
      • Translated Text
      • True/False
      • URL
      • Video
      • Wiki
      • Workflow

      Advanced options for action inputs

      Use advanced options to further configure your inputs.

      All

      The following options are available for all advanced inputs.

      Option Description
      Name The name that identifies the array in script calls.
      Hint Text to display to flow designers so they know what information the array contains.
      Default Value The value used when an input value is not provided. For example, the default selection of a choice field or a default string in a string field.
      Mandatory The input requires a value.

      Some action inputs have additional options. The details of these options are listed below.

      Array

      Option Description
      Max Rows The maximum number of rows you want to display in the user interface. This does not set a limit on the maximum number of rows in the array object.

      Array.Choice

      Option Description
      Max length The maximum length the system stores for an input choice value. Use this option to restrict the length of input values stored during action design.
      Choice Select from:
      • Dropdown with --None--
      • Dropdown without --None--
      Choice list Select from:
      • Create New Choice list to manually create choices. Use the add button (Add button) to create a choice with Name, Value, and Order values.
      • Reference existing choice list on a table to select a choice list from and field on an existing table using the Choice Table and Choice field buttons.

      Array.Object

      Option Description
      Structure Select from:
      • Create Structure Manually
      • Start from Template
      Template Select a template to use for this array.
      Save as Template Save the current array as a template.

      Array.String

      Option Description
      Max Length The maximum length the system stores for an input string value. Use this option to restrict the length of input values stored during action design.

      Password (2 Way Encrypted) design considerations

      Follow these guidelines when designing flows containing Password (2 Way Encrypted) data.

      • To specify the encryption algorithm and the roles allowed to access encrypted data, see Setup encryption contexts.
      • Flow Designer prevents manual entries in Password (2 Way Encrypted) values in flow inputs.
      • Fields containing Password 2 data cannot be used in conditions.
      • To assign a value to a password2 field, drag an existing password2 data pill. Dragging values from other field types is not supported. Flow Designer presents a warning message when password2 data is required.
        The warning message displayed when dragging a non-password2 data pill onto a password2 field.
      • Flow Designer prevents dragging Password2 data pills into other field types, and presents a warning message when the field is incompatible type.
        The warning shown when dragging a password2 field to a disallowed field.
      • Flow Designer only allows Password2 data pills to be dragged into the following field types.
        • Email body fields
        • HTML fields
        • Password 2 Fields
        • PowerShell Input Variables
        • REST fields
          • Variables
          • REST payload body
          • Query parameters
          • Headers
          • REST multi-part form values
          • Form URL-encoded values
        • SOAP fields
          • Headers
          • Envelope

      Flow Designer performs a validation check when a user saves, publishes, or tests actions and flows. This check shows an alert for any data pills dropped in restricted field types and prevents the action or flow from executing. Update the action or flow to remove the invalid data pill and then retry the action.

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login