---
sourceDocument: Australia ServiceNow AI Platform Capabilities
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/servicenow-platform

 Release :

    - australia

ft:locale :

    - de-DE

ft:publication_title :

    - Australia ServiceNow AI Platform Capabilities

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Create data collector

# Create a data collector for a policy version {#ariaid-title1}

* Freigeben Version: Australia
* 
* Aktualisiert 12. März 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Create a data collector for a policy version in the Define Variables section of the Policy Builder.

## Vorbereitungen

Role required: maintsn_pace.code_editor

## Prozedur

1. Navigate to AllVariable DefinitionData Collectors.
2. Select New.
3. On the form, fill in the fields as needed.  
   {#pace-create-data-collector__table_fhn_ktq_ryb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Name of the data collector. |
   | Category | Category of the data collector. See [Managing categories in PaCE](https://servicenow-prod.fluidtopics.net/8aNcY7I0OJ1yOY8y_0qjOw "Use the Categories option to group your PaCE policies more efficiently. As the policy administrator, you can create and edit any number of categories.") for details. |
   | Description | Additional details of the data collector. |
   | Created | Date and time when the data collector was created. |
   | Created by | Name of the user who created the data collector. |
   | Updated | Date and time when the data collector was updated. |
   | Updated by | Name of the user who updated the data collector. |
   [Tabelle : 1. Create New Data Collector]

   {#pace-create-data-collector__table_fhn_ktq_ryb}
4. Click Save.

## Nächste Maßnahme

* [Activate and build data collectors](https://servicenow-prod.fluidtopics.net/DDtC730Rjei8bRbQo5EgZQ "Activate and build data collectors to add to a policy.")
* [Test a data collector for a policy version](https://servicenow-prod.fluidtopics.net/KvpX7ieLSU0P~W3kxAVG7Q "Test a data collector for a policy version in the Test Playground.")
* [Add data collectors to a policy version](https://servicenow-prod.fluidtopics.net/rWQZUIHA8xOUPurm2zbezQ "After testing the activated data collectors, add them to a policy in the Policy Builder.")

{#pace-create-data-collector__ul_fsx_bqp_vbc}  
Activate and build your data collector to add it in the policy builder.

1. Select the Versions tab, then the data collector draft name.
2. Select the Build tab.
3. In the Data sourcesDefine Variables section, select the variable tab you want to define.
   1. Click Add.  

   2. On the Add new input form, fill in the fields.{#pace-create-data-collector__table_qfx_djh_czb__entry__2}

      | Field | Description |
      |-|-|
      | Label | (Optional) Label of the input or output. |
      | Name | Enter a name of the input or output. |
      | Type | Select the type of the input or output. |
      | Mandatory | Select this check box if the input is mandatory. |
      | Description | Description of the input or output. |
      | Default value | Specify a default value. |
      [Tabelle : 2. Add new input]

      {#pace-create-data-collector__table_qfx_djh_czb}  
      Hinweis:  
      Inputs are used as parameters that help collect the correct data to be used in the policy. Outputs are used to specify output variables that can be used in the policy logic.
   3. Click Save.
   4. Repeat the steps to create the inputs and outputs as needed.
   {#pace-create-data-collector__ol_sxs_43h_czb}
4. Enter your inputs or outputs and write your code in the Data collector script, as needed.
5. Add an exception error in your data collector by entering the following script: <kbd class="ph userinput">throw new PaCEExecutionError</kbd>.

   When you execute the policy with the data collector
   exception, the error message will appear under the Output tab in the Execution errors section.
6. Click Save.
7. When you're finished, select Publish.
8. In the Publish draft window, select the Activate this data collector check box, then Publish.
{#pace-create-data-collector__ol_ims_bwq_ryb}  
Add your data collectors in the Policy Builderinto the Policy Builder from the Data Collectors tab.

1. In the Policy Builder tab, select the version of the policy you want to add the new data collector to, then the Data sources icon ![Data source icon]().
2. Navigate to the policy you want to add the data collector to, then under the Define Variables section, click New.
3. Select the data collector from the list of possible data collectors in the system, then click Next.
4. In the Add data collector page in the Details tab, give the data collector a label and variable name.  
   Hinweis:  
   If you're using the same data collector multiple times, it should have a different variable name.
5. In the Inputs tab, provide inputs to complete the configuration of the data collector. The input can be user-specified or selected from the data picker icon.
6. When you're finished, click Save. After the data collector is added and configured, you can access the data collector in the script editor using the data picker in low-code.

{#pace-create-data-collector__ol_qd4_1th_czb} Additionally, you can delete a data collector by selecting it and selecting the Delete button.