{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":3955,"path":"build-workflows/workflow-studio/array-object-data.md","title":"Array.Object data type","bundle":null,"doc_type":null,"release":"australia","body":"\n# Array.Object data type\n\nStore a sequence of JavaScript objects in an array.\n\n## Basic options\n\n|Option|Description|\n|------|-----------|\n|Label|Displays the label used to identify the data variable in the Workflow Studio interface. The label can consist of any text.|\n|Name|Displays the name used to identify the data variable in script calls. The name can only consist of alphanumeric and underscore characters. The system automatically converts the label into a valid name by removing or replacing any special characters.|\n|Type|Indicates the type of data stored by the data variable.|\n|Mandatory|Indicates whether the data variable must contain a value when configured in an action.|\n\n## Advanced options for Array variables\n\n|Option|Description|\n|------|-----------|\n|Hint|Provides guidance to flow or action designers on how to configure the data.|\n|Max rows|Specifies the maximum number of entries to display in the Workflow Studio interface. The array can store more values than it displays.|\n\n## Advanced options for Object variables\n\n<table id=\"table_vky_jd4_dlb\"><thead><tr><th>\n\nOption\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nStructure\n\n</td><td>\n\nSpecifies how to structure the object hierarchy. Options include: -   Create Structure Manually\n-   Start from Template\n\n **Note:** Creating the structure manually enables the **Save as Template** option. Starting from a template enables the **Template** option\n\n</td></tr><tr><td>\n\nSave as Template\n\n</td><td>\n\nStores a manually created object structure for later reuse.\n\n</td></tr><tr><td>\n\nTemplate\n\n</td><td>\n\nSpecifies the existing object structure to apply to this object.\n\n</td></tr></tbody>\n</table>**Note:** For more information on using complex object variables, see [Complex data](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/build-workflows/workflow-studio/complex-data.md).\n\n## Create a list of contacts from a list of users\n\n\\[Omitted image \"array-objects-execution-details-contacts-array.png\"\\] Alt text: Execution details of a custom action that generates a list of contacts from users in a department.\n\nThis example uses a custom action to generate a list of contacts details from users in a specific department. To create the custom action to generate an array of objects, see [Create a custom action to generate an array of objects from a list of records](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/build-workflows/workflow-studio/create-custom-action-array-objects.md).\n\nIn this example, the contacts array contains three users from the Development department.\n\n```\n{\n    \"contacts\": \n        \"contact\": [\n            {\n                \"email_address\": \"allyson.gillispie@example.com\",\n                \"first_name\": \"Allyson\",\n                \"last_name\": \"Gillispie\"\n            },\n            {\n                \"email_address\": \"alva.pennigton@example.com\",\n                \"first_name\": \"Alva\",\n                \"last_name\": \"Pennigton\"\n            },\n            {\n                \"email_address\": \"andrew.och@example.com\",\n                \"first_name\": \"Andrew\",\n                \"last_name\": \"Och\"\n            }\n        ]\n    }\n}\n\n```\n\n**Parent Topic:**[Workflow Studio input and output data variables](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/build-workflows/workflow-studio/action-inputs-outputs.md)\n\n"}}