DomainUtils - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • . DomainUtils A API permite copiar Performance Analytics registros entre domínios diferentes 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 que você crie um Performance Analytics registre em um domínio e copie 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 são movidos para outro domínio, as pontuações não estarão acessíveis.
    Para usar DomainUtils , 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 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 - PADomainUtils()

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

    Use o. DomainUtils(cadeia de caracteres domainFrom) em vez disso, 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.

    Use o. DomainUtils() em vez disso, ao mover ou copiar do domínio global.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    DomainDe Cadeia de caracteres O domínio do qual copiar registros.
    // c90d4b084a362312013398f051272c0d is the sys id of the ACME domain
    var acmeUtils = new SNC.PADomainUtils('c90d4b084a362312013398f051272c0d');

    PADomainUtils - copiar(runas de cadeia de caracteres)

    Cópias Performance Analytics registros para um domínio diferente.

    Para copiar painéis ou trabalhos agendados, consulte CopyDashboard e. Trabalho de cópia .

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Runas Cadeia de caracteres Usuário cujo domínio você deseja copiar registros.
    Tabela 4. Retornos
    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 - copyDashDashDashboardId, String 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.
    Runas Cadeia de caracteres Usuário cujo domínio você deseja copiar o painel.
    Tabela 6. Retornos
    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 Performance Analytics registro de trabalho de coleta de dados agendado para outro domínio.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    PaJob Cadeia de caracteres Sys_id de um Performance Analytics registro de trabalho de coleta de dados agendado [sysauto_pa].
    Runas Cadeia de caracteres Usuário cujo domínio você deseja copiar o trabalho.
    Tabela 8. Retornos
    Tipo Descrição
    Cadeia de caracteres 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');

    DomainUtils - iswriteable(tabela de cadeia de caracteres, ID da cadeia de caracteres)

    Avalie se você pode gravar em um registro específico identificado por 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. Retornos
    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 - Mover (runas de cadeia de caracteres)

    Movimentações Performance Analytics registros para um domínio diferente.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Runas Cadeia de caracteres O usuário cujo domínio você deseja copiar registros.
    Tabela 12. Retornos
    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 (fundação 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. Em geral, o domínio primário contém registros fundamentais e o domínio secundário contém registros de nível superior, como widgets. Os seguintes tipos de registro são considerados registros fundamentais.
    • Grupos de Buckets
    • Buckets
    • Scripts
    • Fontes de detalhamento
    • Fontes do indicador
    • Filtros
    • Detalhamentos
    • Origens gerenciadas
    • Detalhamentos manuais
    • Mapeamentos de detalhamento
    • Relações de detalhamento
    Outro Performance Analytics registros como widgets e indicadores não são registros fundamentais. Defina este método como falso para mover ou copiar esses registros adicionais também.
    Tabela 13. Parâmetros
    Nome Tipo Descrição
    base Booliano Indica se somente registros fundamentais devem ser copiados ou movidos por este objeto PADomainUtils.
    Tabela 14. Retornos
    Tipo Descrição
    DomainUtils 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 como o registro primário original.

    O uso deste método permite substituir automaticamente 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 sys_override não terá 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ções 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. Retornos
    Tipo Descrição
    DomainUtils O objeto que chama esta função.
    var pa = new SNC.PADomainUtils('c90d4b084a362312013398f051272c0d');
    pa.setOverrides(false);
    pa.copy('bb6b58b01f1310005a3637b8ec8b70dd');