Collect Spotlight scores

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read
  • To collect Spotlight scores, schedule score collection and activate the Spotlight group. You can also collect scores manually for an active Spotlight group.

    Before you begin

    1. Create a Spotlight group
    2. Create Spotlight criteria

    Role required: pa_spotlight or admin

    About this task

    When Spotlight collects scores, Spotlight also deletes all older Spotlight records for the associated Spotlight group, without exception.

    Procedure

    1. Open the Spotlight group that you want to collect scores for.
    2. If it is not already selected, select Active in the check box and save the Spotlight group form.
      New Spotlight groups are active by default.
      You can now execute the Spotlight job using the Execute Now button. Execute Now button on an active Spotlight group form
    3. To collect scores immediately, click Execute Now.
    4. Go to the Schedule section and in the Run field, select the frequency at which to collect Spotlight scores.
    5. Fill in any specific information about when the Spotlight scores will be collected.
      The required information depends on the period you choose in the Run field. For example, if you choose to run Daily, you have to fill in the time of day to run. If you choose Monthly, you have to fill in the day of the month and the time of day to run.
    6. If you are using domain separation, specify a user in the Run as field.

      If you do not specify a Run As user, scores are evaluated for the Global domain. In this case, Spotlight scoring is performed for all matching records in all domains.

      For more information, see Domain separation with Spotlight.

    Result

    Spotlight starts collecting scores according to the schedule you set. You can also collect scores manually at any time by clicking Execute Now. Administrators who need to troubleshoot scheduling can read Schedule Item [sys_trigger] records for Spotlight.

    What to do next

    You can see the details of the criteria that contribute to a Spotlight score. For more information, read See Spotlight score details. You can also see and share an interactive analysis of the results.