PADomainUtils - Global

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.

PADomainUtils - PADomainUtils()

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.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

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

PADomainUtils - PADomainUtils(cadeia de caracteres domainFrom)

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.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
domainFrom	Cadeia de caracteres	O domínio do qual os registros serão copiados.

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

PADomainUtils - cópia (cadeia de caracteres runAs)

Copia Performance Analytics registros para um domínio diferente.

Para copiar painéis ou trabalhos agendados, consulte copyDashboard e copyJob.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
executarAs	Cadeia de caracteres	Usuário cujo domínio você deseja copiar registros.

Tabela 4. Retorna

Tipo	Descrição
vazio

// 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)

Copie um painel para outro domínio.

Tabela 5. Parâmetros

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 6. Retorna

Tipo	Descrição
vazio

//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)

Copia um registro de trabalho de coleta de dados programado Performance Analytics para outro domínio.

Tabela 7. Parâmetros

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 8. Retorna

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.

// 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)

Avalie se você pode gravar em um registro específico identificado pela tabela e sys_id.

Tabela 9. Parâmetros

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 10. Retorna

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.

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

PADomainUtils - move(cadeia de caracteres runAs)

Move Performance Analytics registros para um domínio diferente.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
executarAs	Cadeia de caracteres	O usuário cujo domínio você deseja copiar registros.

Tabela 12. Retorna

Tipo	Descrição
vazio

// 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)

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

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.

Tabela 13. Parâmetros

Nome	Tipo	Descrição
fundação	Booliano	Indica se somente registros básicos devem ser copiados ou movidos por este objeto PADomainUtils.

Tabela 14. Retorna

Tipo	Descrição
PADomainUtils	O objeto que chama esta função.

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

PADomainUtils - setOverrides (substituições boolianas)

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.

Tabela 15. Parâmetros

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 16. Retorna

Tipo	Descrição
PADomainUtils	O objeto que chama esta função.

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