KeyValuePair connector methods

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 5 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of KeyValuePair connector methods Creating integrations with applications

    The KeyValuePair connector methods enable you to manipulate key-value pairs within automation flows in ServiceNow. These methods can be integrated with other components to perform a variety of actions such as adding, retrieving, updating, and deleting key-value pairs. Before using these methods, they must be exposed within your automation flow.

    Show full answer Show less

    Key Features

    • Add: Inserts a key-value pair. You can choose to ignore duplicates.
    • Clear: Removes all key-value pairs.
    • ContainsKey: Checks if a specified key exists.
    • ContainsValue: Checks if a specified value exists for a key.
    • Count: Returns the total number of key-value pairs.
    • Delete: Removes a specific key.
    • GetItem: Retrieves the value associated with a specified key.
    • GetItems: Fetches values for multiple configured keys.
    • ParseFromText: Converts specified text into key-value pairs, with options for separators and clearing existing pairs.
    • SetItem: Updates the value of a specific key.
    • ToJSON: Converts key-value pairs to JSON format.
    • ToText: Converts key-value pairs to text format, with an option to render only values.

    Key Outcomes

    By utilizing these methods, ServiceNow customers can efficiently manage data within automation processes, ensuring that key-value pairs are easily manipulated and maintained. This functionality supports data integrity and enhances the overall effectiveness of automated tasks by allowing for dynamic data handling and retrieval. Expect streamlined operations and improved data management capabilities as a result of implementing these KeyValuePair methods in your integrations.

    The Keyvalue pair connector methods perform various actions on key value pairs. In an automation flow, the methods are connected with other methods and components. To use the methods, you must first expose them.

    Add

    Adds a keyvalue pair.

    To provide inputs to the parameters, see Configure port properties.

    Table 1. Add method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    Key Name of the key. Data in String None Yes
    Value Value of the key. Data in Object None Yes
    IgnoreDuplicates If the value is True, the method ignores a duplicate key. Else, if the value is False, the method returns an error message. Data in Boolean None No

    Clear

    Clears all keyvalue pairs.

    ContainsKey

    Returns True if the specified key exists, else, returns False.

    To provide inputs to the parameters, see Configure port properties.

    Table 2. ContainsKey method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    Key Name of the key. Data in String None Yes
    Return Returns True if the specified key exists, else, returns False. Data out Boolean Not applicable Not applicable

    ContainsValue

    Returns True if the specified key value exists, else, returns False.

    To provide inputs to the parameters, see Configure port properties.

    Table 3. ContainsValue method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    Value Name of the key value. Data in String None Yes
    Return Returns True if the specified key value exists, else, returns False. Data out Boolean Not applicable Not applicable

    Count

    Returns the total count of keyvalue pairs.

    Table 4. Count method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    Return Returns the total count of keyvalue pairs. Data out Integer Not applicable Not applicable

    Delete

    Removes the specified key.

    To provide inputs to the parameters, see Configure port properties.

    Table 5. Delete method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    Key Name of the key. Data in String None Yes

    GetItem

    Returns the value of the specified key.

    To provide inputs to the parameters, see Configure port properties.

    Table 6. GetItem method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    Key Name of the key. Data in String None Yes
    Return Returns the value of the key. Data out Object Not applicable Not applicable

    GetItems

    Returns the values of multiple keys. You must first configure the keys in the method.

    To configure, do the following steps.
    1. Click the method settings icon (Method settings icon.).
    2. Click the add keys icon (Add keys icon.).
    3. Enter the key name.
    4. Update the key data type from the list.
    5. Repeat the steps to set multiple key names.
    6. Click OK.

      A Data out port is created with each key name you set.

    Table 7. GetItems method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    Key Returns the value of the key. Data out Object Not applicable Not applicable

    GetItemsByIndex

    Returns the key values based on their index. You must first configure the indexes in the method.

    To configure, do the following steps.
    1. Click the method settings icon (Method settings icon.).
    2. Click the add indexes icon (Add keys icon.).
    3. Enter the key index.
    4. Update the key data type from the list.
    5. Repeat the steps to set multiple key indexes.
    6. Click OK.

      A Data out port is created with each key index you set.

    Table 8. GetItemsByIndex method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    Key index Returns the value of the key. Data out Object Not applicable Not applicable

    ParseFromText

    Parses the specified text into key value pairs. It can create multiple keyvalue pairs.

    To provide inputs to the parameters, see Configure port properties.

    Table 9. ParseFromText method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    Text Text comprising the keys and values that the method parses. Data in String None Yes
    ItemSeparator Separator between two keyvalue pairs. Data in String None Yes
    KeyValueSeparator Separator between the key and its value. Data in String None Yes
    ClearBeforeParse If True, clears any existing keyvalue pair before parsing. Data in Boolean None No

    Reverse

    Reverses the key indexes.
    Tip:
    After executing the method, you can see the output by executing the GetItemsByIndex method.

    SetData

    Need information.

    SetItem

    Updates the value of a key.

    To provide inputs to the parameters, see Configure port properties.

    Table 10. SetItem method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    Key Name of the key. Data in String None Yes
    Value Updated value of the key. Data in Object None Yes
    Tip:
    Test the updated value by executing the GetItemsByIndex method.

    SetItems

    Updates the values of the specified keys. You must first configure the keys in the method.

    To configure the keys, do the following steps.
    1. Click the method settings icon (Method settings icon.).
    2. Click the add keys icon (Add keys icon.).
    3. Enter the key name.
    4. Update the key data type from the list.
    5. Repeat the steps to set multiple key names.
    6. Click OK.

      A Data in port is created with each key name you set.

    To provide inputs to the parameters, see Configure port properties.

    Table 11. SetItems method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    Key Updated value of the key. Data in Object None Yes
    Tip:
    Test the updated value by executing the GetItemsByIndex method.

    SetItemsByIndex

    Updates the values of the keys based on the specified indexes. You must first configure the indexes in the method.

    To configure the indexes, do the following steps.
    1. Click the method settings icon (Method settings icon.).
    2. Click the add indexes icon (Add keys icon.).
    3. Enter the key index.
    4. Update the key data type from the list.
    5. Repeat the steps to set multiple key indexes.
    6. Click OK.

      A Data in port is created with each key index you set.

    Table 12. SetItemsByIndex method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    Key Index Index of the key. Data in Object None Yes
    Tip:
    Test the updated value by executing the GetItemsByIndex method.

    ToJSON

    Renders the keyvalue pairs to the JSON format.

    ToText

    Renders the keyvalue pairs to the text format.

    To provide inputs to the parameters, see Configure port properties.

    Table 13. ToText method parameters
    Parameter Description Data port type Data type Default value Mandatory? Notes
    ValuesOnly If True, the method renders only the values of the keys, else, renders the keyvalue pair. Data in Boolean None No
    Return Returns the keyvalue pair to the text format. Data out String Not applicable Not applicable