PADomainUtils - Global

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura
  • A API PADomainUtils permite copiar 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. Essa 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 poderão ser acessadas.
    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 a separação de domínio.
    • 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 - copy(cadeia de caracteres "runAs")

    Copia Performance Analytics registros para um domínio diferente.

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

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    executar como Cadeia de caracteres Usuário para o qual os registros serão copiados no domínio.
    Tabela 2. 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 3. Parâmetros
    Nome Tipo Descrição
    ID do painel Cadeia de caracteres Sys_id do painel a ser copiado.
    executar como Cadeia de caracteres Usuário para o qual você deseja copiar o painel.
    Tabela 4. 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 5. Parâmetros
    Nome Tipo Descrição
    paTrabalho Cadeia de caracteres O sys_id de um Performance Analytics registro de trabalho de coleta de dados programado [sysauto_pa].
    executar como Cadeia de caracteres O usuário para o qual você deseja copiar o trabalho.
    Tabela 6. 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(cadeia de caracteres tabela, cadeia de caracteres id)

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

    Tabela 7. 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 8. 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 registros Performance Analytics para um domínio diferente.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    executar como Cadeia de caracteres O usuário para o qual você deseja copiar registros.
    Tabela 10. 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 - PADomainUtils()

    Instancia um novo objeto PADomainUtils para mover ou copiar Performance Analytics registros do domínio global.

    Use o construtor PADomainUtils(String domainFrom) ao mover ou copiar registros de um domínio diferente do domínio global.

    Tabela 11. 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.

    Use o construtor PADomainUtils() ao mover ou copiar do domínio global.

    Tabela 12. 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 - setFoundation(booliano)

    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 de sys_override do novo registro como o registro primário original.

    O uso deste método permite que você substitua automaticamente os registros em um domínio primário. Ao substituir os registros primários, eles 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 afetará o 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');