{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":12944,"path":"employee-service-management/proactive-prompts/proactive-prompts-signal-datasource-form.md","title":"Signal data source form","bundle":null,"doc_type":null,"release":"australia","body":"\n# Signal data source form\n\nForm to create a data source for the signal.\n\n\n
\n\nFields\n\n\n\nDescription\n\n
\n\nName\n\n\n\nName of the signal data source.\n\n
\n\nDescription\n\n\n\nBrief description of the signal data source.\n\n
\n\nType\n\n\n\nThe type of data source that you want to create. The available values are:- Simple\n- Aggregated\n- Scripted\n- Indicator \\(Performance Analytics Indicator\\)\n- Subflow\n\nFor more information, see [Types of data sources in Proactive Prompts](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/employee-service-management/proactive-prompts/proactive-prompts-data-source.md).\n\n
\n\nScript\n\n\n\nThe script to retrieve the data source. Follow the example script provided in the field for successful execution of the script.**Note:** This field is available only when the Scripted option is selected in the **Type** field.\n\n
\n\nSubflow\n\n\n\nAny published subflow created using Workflow Studio as the data source.\n\n
\n\nIndicator\n\n\n\nThe type of performance measurement for the Indicator data source type.**Note:** Only automated indicators that are published on the Analytics hub are supported.\n\n
\n\nBreakdown\n\n\n\nThe field to group or filter indicator scores by a qualitative attribute such as Priority, Category, or Assignment Group.**Note:** Only breakdowns whose breakdown source field is available in the User \\[sys\\_user\\] table can be selected.\n\n
\n\nTable\n\n\n\nThe table used as the source to obtain the data.\n\n
\n\nCondition\n\n\n\nCriteria that must be met to retrieve the data from the table. For example, the condition **\\[Available balance\\]\\[Greater than\\]\\[10\\]** would retrieve an unused PTO balance of more than 10 days.\n\n
\n\nUser field\n\n\n\nThe field from the data table used to group the data source records.\n\n
\n\nApplies to\n\n\n\nThe user configuration to filter the data in the **User** field.\n\n
\n\nCan be evaluated for a single user\n\n\n\nEnables the source to be supported for a single user execution. By selecting this option, the prompt is generated for the current logged-in user at run time.**Note:** For Script and Subflow data source types, an additional parameter is added to handle the user.\n\n
\n\nCan be evaluated for a given date\n\n\n\nEnables the source to be executed for the selected date. By selecting this option, the prompt is generated on the selected date.**Note:** For Script and Subflow data source types, an additional parameter is added to handle the date.\n\n
\n\nCollect records\n\n\n\nOption to get record details when delivering the prompt message.**Note:**\n\n- If Indicator is selected as the data source type, then the **Collect records** option must also be set to true on the selected indicator record.\n- Selecting this option stores the display field value in the Prompt details \\[sn\\_pp\\_prompt\\_details\\] table.\n- Selecting this option influences the View details action.\n- If the **Include zero records** field is selected, the **Collect records** option cannot be used.\n\n
\n\nDisplay field\n\n\n\nA field from the source table that is displayed in the View details action and in the prompt message to represent a record from the table. For example, in the HR Case \\[sn\\_hr\\_core\\_case\\] table, an HR case can be represented with a case number, a short description, or any other field in the table.**Note:**\n\n- This field is displayed only when the **Collect records** field is selected.\n- The item token contains the value of this field.\n\n
\n\nThreshold Condition\n\n
\n\nAggregate\n\n\n\nAggregate type. This field is available only when the selected data source is Aggregate.\n\n
\n\nCondition\n\n\n\nCondition for the threshold value. The available values are:- Less than\n- Less than or is\n- Is\n- Greater than or is\n- Greater than\n\n
\n\nValue\n\n\n\nA value for the condition provided in the **Condition** field. For example, to find the count of more than five overdue tasks, the **Value** number would be 5, and the full condition would be **\\[Overdue tasks\\]\\[Greater than\\]\\[5\\]**.\n\n
\n\nScore field\n\n\n\nThe field used for score evaluation.**Note:** This field is available only when the selected data source type is Aggregated and the **Aggregate** field value is None. Only the fields that have numerical values can be selected.\n\n
\n\nUse percentile\n\n\n\nOption to use relative comparison instead of static comparison against a fixed number.\n\n
\n\nPercentile value\n\n\n\nPercentile value for the threshold condition. This field appears only when the **Use percentile** field is selected. The available values are:- Lower outliers\n- 25 percentile\n- Median\n- 75 percentile\n- Higher outliers\n\n
\n\nInclude zero records\n\n\n\nOption to include users without any records in the table. For example, select this option to send a prompt to the employees who have no PTO balance.**Note:** You can narrow down the users with zero records by selecting a user configuration in the **Applies to** field. For example, you can send prompts to employees in the HR department with no records in the selected table.\n\n
**Parent Topic:**[Reference for Proactive Prompts](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/employee-service-management/proactive-prompts/proactive-prompts-reference.md)\n\n**Related topics** \n\n\n[Components installed with Proactive Prompts]()\n\n[Tokens in Proactive Prompts]()\n\n[Types of data sources in Proactive Prompts]()\n\n[Actions and action groups in Proactive Prompts]()\n\n[Signal configuration form]()\n\n"}}