---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# PADomainUtils - Global

# PADomainUtils - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

A API PADomainUtils permite que você copie Performance Analytics registros entre diferentes domínios na mesma instância.

Use esta API em scripts de servidor para copiar Performance Analytics registros, como indicadores, detalhamentos e painéis, para diferentes domínios. Esta API permite criar um registro Performance Analytics em um domínio e copiar esse registro para qualquer número de domínios adicionais.  
Nota:  
Esta API não pode copiar registros para o domínio global.  
Aviso:  
Quando os registros de configuração forem movidos para outro domínio, as pontuações não estarão acessíveis.  
Para usar PADomainUtils, você deve atender a estes requisitos:

* Performance Analytics deve ser habilitado.
* O usuário que executa o script deve ter a função de administrador.
* A instância deve usar o Domain Separation.
* O script deve ser executado a partir do domínio global.
* Ao mover ou copiar registros, os domínios de origem e de destino devem ser diferentes.
{#c_PADomainUtils__ul_fyh_sjs_ht}

## PADomainUtils - PADomainUtils() {#ariaid-title2}

Instancia um novo objeto PADomainUtils para mover ou copiar Performance Analytics registros do domínio global.
Em vez disso, use o construtor PADomainUtils(String domainFrom) ao mover ou copiar registros de um domínio diferente do domínio global.
{#r_PADU-PADomainUtils__table_tm5_rmy_2t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

{#r_PADU-PADomainUtils__table_tm5_rmy_2t}  

    // PADomainUtils initialized with the global domain
    var globalUtils = new SNC.PADomainUtils();

## PADomainUtils - PADomainUtils(cadeia de caracteres domainFrom) {#ariaid-title3}

Instancia um novo objeto PADomainUtils para mover ou copiar Performance Analytics registros do domínio especificado.
Em vez disso, use o construtor PADomainUtils() ao mover ou copiar do domínio global.
{#r_PADU-PADomainUtils_String__table_ly4_5my_2t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| domainFrom | Cadeia de caracteres | O domínio do qual os registros serão copiados. |
[Tabela 2. Parâmetros]

{#r_PADU-PADomainUtils_String__table_ly4_5my_2t}  

    // c90d4b084a362312013398f051272c0d is the sys id of the ACME domain
    var acmeUtils = new SNC.PADomainUtils('c90d4b084a362312013398f051272c0d');

## PADomainUtils - cópia (cadeia de caracteres runAs) {#ariaid-title4}

Copia Performance Analytics registros para um domínio diferente.
Para copiar painéis ou trabalhos agendados, consulte [copyDashboard](https://servicenow-prod.fluidtopics.net/vFzPoTiOPbgNBu0qnXcvDA#PADU-copyDashboard_S_S "Copie um painel para outro domínio.") e [copyJob](https://servicenow-prod.fluidtopics.net/vFzPoTiOPbgNBu0qnXcvDA#r_PADU-copyJob_String_String "Copia um registro de trabalho de coleta de dados programado Performance Analytics para outro domínio.").
{#r_PADU-copy_String__table_n55_zky_2t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| executarAs | Cadeia de caracteres | Usuário cujo domínio você deseja copiar registros. |
[Tabela 3. Parâmetros]

{#r_PADU-copy_String__table_n55_zky_2t} {#r_PADU-copy_String__table_o55_zky_2t__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 4. Retorna]

{#r_PADU-copy_String__table_o55_zky_2t}  

    // copy all the Performance Analytics records from global to user's domain
    var pa = new SNC.PADomainUtils();
    pa.copy('09ff3d105f231000b12e3572f2b4775d');

## PADomainUtils - copyDashboard(cadeia de caracteres dashboardId, cadeia de caracteres runAs) {#ariaid-title5}

Copie um painel para outro domínio.
{#PADU-copyDashboard_S_S__table_yds_v55_yw__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dashboardId | Cadeia de caracteres | Sys_id do painel a ser copiado. |
| executarAs | Cadeia de caracteres | Usuário cujo domínio você deseja copiar o painel. |
[Tabela 5. Parâmetros]

{#PADU-copyDashboard_S_S__table_yds_v55_yw} {#PADU-copyDashboard_S_S__table_zds_v55_yw__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 6. Retorna]

{#PADU-copyDashboard_S_S__table_zds_v55_yw}  

    //Copy Incident Management dashboard from global to user's domain
    var pa = new SNC.PADomainUtils();
    pa.copyDashboard('a64b7031d7201100b96d45a3ce610335','09ff3d105f231000b12e3572f2b4775d');

## PADomainUtils - copyJob(cadeia de caracteres paJob, cadeia de caracteres runAs) {#ariaid-title6}

Copia um registro de trabalho de coleta de dados programado Performance Analytics para outro domínio.
{#r_PADU-copyJob_String_String__table_gvt_vky_2t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| paJob | Cadeia de caracteres | O sys_id de um Performance Analytics registro de trabalho de coleta de dados programado \[sysauto_pa\]. |
| executarAs | Cadeia de caracteres | O usuário cujo domínio você deseja copiar o trabalho. |
[Tabela 7. Parâmetros]

{#r_PADU-copyJob_String_String__table_gvt_vky_2t} {#r_PADU-copyJob_String_String__table_hvt_vky_2t__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Uma mensagem de erro se ocorrer um erro ou uma cadeia de caracteres vazia se não houver erro. |
[Tabela 8. Retorna]

{#r_PADU-copyJob_String_String__table_hvt_vky_2t}  

    // No source domain needs to be set
    var pa = new SNC.PADomainUtils();
    // copy the '[PA Incident] Daily Data Collection job'
    // set the 'run as' of the new record to be the 'acme.itil' user
    // first argument is the sys_id of the sysauto_pa record
    // the second is the sys_id of the acme.itil user record
    pa.copyJob('82ba2023d7101100b96d45a3ce6103cd','797d14341f1310005a3637b8ec8b7010');

## PADomainUtils - isWriteable (tabela de cadeia de caracteres, ID de cadeia de caracteres) {#ariaid-title7}

Avalie se você pode gravar em um registro específico identificado pela tabela e sys_id.
{#r_PADU-isWriteable_String_String__table_vqc_gly_2t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tabela | Cadeia de caracteres | O nome da tabela que contém o registro a ser consultado, como pa_indicators. |
| ID | Cadeia de caracteres | O sys_id do registro a ser consultado. |
[Tabela 9. Parâmetros]

{#r_PADU-isWriteable_String_String__table_vqc_gly_2t} {#r_PADU-isWriteable_String_String__table_wqc_gly_2t__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Indica que você pode gravar no registro especificado. Retorna verdadeiro se o registro existir no domínio do usuário atual. Retorna falso se o registro não existir ou estiver em um domínio diferente. |
[Tabela 10. Retorna]

{#r_PADU-isWriteable_String_String__table_wqc_gly_2t}  

    var pa = new SNC.PADomainUtils();
    pa.isWriteable('pa_incidents','cd8125b5140012007665a83e633b028d');

## PADomainUtils - move(cadeia de caracteres runAs) {#ariaid-title8}

Move Performance Analytics registros para um domínio diferente.
{#r_PADU-move_String__table_plw_bly_2t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| executarAs | Cadeia de caracteres | O usuário cujo domínio você deseja copiar registros. |
[Tabela 11. Parâmetros]

{#r_PADU-move_String__table_plw_bly_2t} {#r_PADU-move_String__table_qlw_bly_2t__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 12. Retorna]

{#r_PADU-move_String__table_qlw_bly_2t}  

    // move all the Performance Analytics records from the global to the customers domain
    var pa = new SNC.PADomainUtils();
    pa.move('774190f01f1310005a3637b8ec8b70ef')

## PADomainUtils - setFoundation (base booliana) {#ariaid-title9}

Use este método para mover ou copiar somente registros básicos em uma configuração de domínio híbrido.
Você pode implementar uma abordagem híbrida mantendo alguns tipos de registro em um domínio primário e alguns tipos em domínios secundários. Geralmente, o domínio primário contém registros básicos e o domínio secundário contém registros de nível superior, como widgets. Os seguintes tipos de registro são considerados registros básicos.

* Grupos de Buckets
* Buckets
* Scripts
* Fontes de detalhamento
* Fontes do indicador
* Filtros
* Detalhamentos
* Origens gerenciadas
* Detalhamentos manuais
* Mapeamentos de detalhamento
* Relações de detalhamento

{#r_PADU-setFoundation_boolean__ul_ygw_ycf_ht}Outros registros Performance Analytics, como widgets e indicadores, não são registros básicos. Defina este método como falso para mover ou copiar esses registros adicionais também.
{#r_PADU-setFoundation_boolean__table_tzb_nky_2t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| fundação | Booliano | Indica se somente registros básicos devem ser copiados ou movidos por este objeto PADomainUtils. |
[Tabela 13. Parâmetros]

{#r_PADU-setFoundation_boolean__table_tzb_nky_2t} {#r_PADU-setFoundation_boolean__table_uzb_nky_2t__entry__2}

| Tipo | Descrição |
|-|-|
| PADomainUtils | O objeto que chama esta função. |
[Tabela 14. Retorna]

{#r_PADU-setFoundation_boolean__table_uzb_nky_2t}  

    var pa = new SNC.PADomainUtils().setFoundation(true);
    pa.copy('bb6b58b01f1310005a3637b8ec8b70dd');

## PADomainUtils - setOverrides (substituições boolianas) {#ariaid-title10}

Use este método antes de copiar registros para definir o valor sys_override do novo registro para o registro primário original.
O uso deste método permite substituir automaticamente os registros em um domínio primário. Ao substituir os registros primários, os registros primários não afetam o domínio secundário. Se o domínio de origem não for o primário do domínio de destino ao copiar registros, definir o valor de sys_override não terá nenhum impacto no comportamento. Você pode especificar uma substituição somente ao copiar registros, não ao mover registros.
{#r_PADU-setOverrides_boolean__table_hsj_qky_2t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| substitui | Booliano | Indica que os registros copiados em um domínio secundário devem substituir o registro de origem no domínio primário. Este valor é verdadeiro por padrão. |
[Tabela 15. Parâmetros]

{#r_PADU-setOverrides_boolean__table_hsj_qky_2t} {#r_PADU-setOverrides_boolean__table_isj_qky_2t__entry__2}

| Tipo | Descrição |
|-|-|
| PADomainUtils | O objeto que chama esta função. |
[Tabela 16. Retorna]

{#r_PADU-setOverrides_boolean__table_isj_qky_2t}  

    var pa = new SNC.PADomainUtils('c90d4b084a362312013398f051272c0d');
    pa.setOverrides(false);
    pa.copy('bb6b58b01f1310005a3637b8ec8b70dd');