Thank you for your feedback.
Form temporarily unavailable. Please try again or contact docfeedback@servicenow.com to submit your comments.
Versions
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store
Close

Create or schedule a data collection job

Create or schedule a data collection job

Schedule a data collection job to regularly collect scores.

Before you begin

Before defining data collection jobs, make sure that indicator sources, breakdown sources, and indicators have been defined. Otherwise, jobs cannot return any results.

Roles required: pa_data_collector or admin

About this task

The important items to know when you configure a data collection job are:
  • Collection period
  • Collection timezone
  • Collected scores domain, if domains are used.
  • The collection job runs without any restrictions. It does not use the permissions of the user who runs it.

Data collection jobs run different steps to collect scores and to collect text analytics data. By default, jobs collect both types of data. To improve performance, you can instead schedule separate jobs for scores and for text analytics data.

Procedure

  1. Navigate to Performance Analytics > Data Collector > Jobs and click New.
    You can instead edit an existing data collection job, for example to change the schedule of when the job runs. In this case, navigate to Performance Analytics > Data Collector > Jobs and click the job name.
  2. In the Name field, give the job a meaningful name.
    Follow a standard format for naming data collector jobs, such as [PA Indicator] Daily Data Collection, [PA Indicator] Historic Data Collection...
  3. In the Operator field, select whether to collect data for an absolute or a relative time period.
    Operator valueDescription
    Fixed Collects data for an absolute time period.
    Relative Collect data for a period of time that is relative to the time when the job is run.
  4. If you selected Fixed as the operator, select the Fixed start date and the Fixed end date.
  5. If you selected Relative as the operator, specify the intervals prior to the run time to collect data from.
    If you set relative start 1 and relative end 1 and intervals of "days ago," you collect data only for yesterday.
    1. In the fields Relative start and Relative start interval, set the number and the length, respectively, of time periods in the past to begin to collect data from.
    2. In the fields Relative end and Relative end interval, set the number and the length, respectively, of the last period in the past to collect data from.
      For example, you want to collect scores for a set of several indicators with a daily frequency, all using the same indicator source. First you create a historical data collection job that collects data from two months ago up to the day before yesterday. For this job, enter 60 in Relative start and days ago in Relative start interval. Enter 2 in Relative end and days ago in Relative end interval. Set the Run field to On Demand. Click Execute now and run this job once, to collect the initial scores.

      Create a second job with relative start and end of 1 day ago and set the Run field to Daily. Activate this job to collect the scores for yesterday and all future scores for the day before the job is run.

  6. Fill in the Job parameters, as appropriate.
    Job parameter Description
    Run as Select the user that runs this scheduled job. The data collection job does not use the permissions of this user. Any user can run the job. However, if you have enabled domain support but do not configure domains for this job, the records retrieved from the indicator source respect the domain of this user.
    Run as tz Select the time zone that the queries use when they are executed from the job. By default the System time zone is used.
    Active If selected, as it is by default, the data collection occurs at the scheduled date and time.
    Run Select the schedule for collecting the data. Choices are:
    • Daily
    • Weekly
    • Monthly
    • Periodically
    • Once
    • On demand

    If you are creating a historical data collection job, schedule the job to run On demand.

    Day
    • If Run is Weekly, specify the day of the week.
    • If Run is Monthly, specify the day of the month.
    Repeat Interval If Run is Periodically, specify the amount of time between scheduled data collections, in days and hours.
    Starting If Run is Periodically or Once, specify the date and time of the first scheduled data collection.
    Time If Run is Weekly or Monthly, the time of day, on a 24-hour clock.
    Collect Data collection jobs have separate steps for collecting scores and for collecting text analytics. Select one of:
    • Scores only
    • Text analytics only
    • Both scores and text analytics (default)

    For more information, see Set up text analytics.

    Conditional If checked, the data collection occurs only if certain conditions are met.
    Conditions If Conditional is selected, write a script that specifies under what conditions the job is run.
  7. Right-click the form header and select Save.
  8. In the Indicators related list, click Edit and select the indicators that this job collects data for.
    Important: At least one indicator must be included for the job. Otherwise, the job cannot return any results.
  9. Click Submit.

What to do next

  • By default, for each job indicator, data is collected for all breakdowns and the indicator itself. To change this configuration for an indicator, see Configure a job indicator.
  • If you have enabled domain support, you have a related list named Domain configuration. In this tab, click Edit to relate an existing domain configuration with this job or click New to create a new domain configuration. For more information, see Create a domain configuration.
    Warning: Data collection from a non-separated table with a domain configuration is not supported.