Copy a Spotlight group to domains

You can copy a Spotlight group to other domains, saving the effort of reproducing the group manually for each domain.

Before you begin

Finish configuring the Spotlight group that you want to copy.

Role required: admin, pa_spotlight_copy_domain

About this task

When you first create a Spotlight group, it is created in the domain that you are logged in to. To create identical Spotlight groups in other domains, use the copying function. The copying function follows the ServiceNow AI Platform® domain separation.

Procedure

1. Locate and open the Spotlight group record from the Spotlight Groups list.
2. Click Copy to Domain.
3. In the Copy Spotlight Group dialog, select a value for Name Preference.

   Value	Description
   Do not change the name	All copies will have the same name as the original Spotlight group.
   Change the name	Manually write a new name that will be given to all copies of the Spotlight group.
   Add domain name to new name as prefix	For each copy of the Spotlight group, the domain name is added to the beginning of the Spotlight group name. You can keep the base name from the original Spotlight group or specify a new one. The New Name field does not show these prefixes.
   Add domain name to new name as suffix	For each copy of the Spotlight group, the domain name is added to the end of the Spotlight group name. You can keep the base name from the original Spotlight group or specify a new one. The New Name field does not show these suffixes.

4. Fill out the remaining fields of the Copy Spotlight Group dialog as follows:

   Field	Description
   New Name	Editable field showing the name of the Spotlight group copies you are creating. This field appears if you select any value for Name Preference other than Do not change the name. All copies have the same name unless you select Add domain name to new name as prefix or Add domain name to new name as suffix. The domain name prefixes or suffixes do not appear in this field.
   Domain	Select any number of domains. The choices include the parent domain and all subdomains. A copy of the Spotlight group is made for each selected domain.

5. Click OK.
   The Spotlight group is copied. If copying is successful, a list of the Spotlight groups that you have just created opens. If any error messages or warnings appeared during the copying process, read the Spotlight group copy logs.
6. Open each of the Spotlight groups you have just created and perform the following steps:
   1. Verify that the Run as user has access to the domain of the Spotlight group and change this user if necessary.
   2. Review the Spotlight job schedule and adjust as necessary.
   3. Activate the Spotlight group.

Copying a Spotlight group to multiple domains

In this example, the ACME - Incident Spotlight group, which was created in the ACME domain, is copied to the subdomains for the ACME company product divisions.

1. Open the Spotlight Groups list and click ACME - Incident Spotlight..

   

2. The Incident Spotlight group record opens, and you click Copy to domain.
3. In the Copy Spotlight Group dialog, you select the ACME - Metallurgy and ACME - Rocketry subdomains. Only ACME and ACME subdomains are available because the original Spotlight group was created in the ACME domain. You want the domain names to appear at the beginning of the group names, so you also select Add domain name to new name as prefix.
4. Because the domain names that will be added as prefixes begin with ACME, you do not need ACME in the base name of the group. Therefore, you remove it.
5. You click OK, and you are taken to a list showing you the Spotlight groups that you have just created. Note that both have the base name Incident Spotlight, as shown in the New Name field of the Copy Spotlight Group dialog, with the domain name added as a prefix.
6. In the Run as field, you browse for a user in the ACME - Metallurgy domain and select Wiley C. Latrans. Only global users and users in the domain of the Spotlight group are available. Spotlight jobs run more efficiently with a Run as user in the same domain as the Spotlight group, because only the records visible to this domain are evaluated.

   

7. Review the Spotlight job run schedule, and activate the Spotlight group.

   

8. You verify the schedule for the ACME - Rocketry - Incident Spotlight group and activate the group.

What to do next

If any error messages or warnings appeared during the copying process, read the Spotlight group copy logs.