Personalizar operações padrão

  • Versão de lançamento: Washingtondc
  • Atualizado 10 de jan. de 2026
  • 3 min. de leitura

    • Como parte da criação ou modificação de um padrão de descoberta, modifique as operações personalizadas existentes que vêm como parte do sistema de base ou adicione novas.

    Antes de Iniciar

    Função necessária: pd_admin

    É necessário conhecimento prático de Java script.

    Por Que e Quando Desempenhar Esta Tarefa

    Para operações de padrão convencionais, é possível definir somente parâmetros de entrada. No entanto, existem operações personalizadas para as quais é possível definir a lógica de negócios e o mecanismo da própria operação, além dos parâmetros de entrada. Por exemplo, é possível tornar um parâmetro obrigatório ou definir quais parâmetros de entrada usar.

    As seguintes operações personalizadas estão disponíveis:
    Chamada REST em nuvem
    Extrai informações de itens de configuração do tipo PaaS (Platform-as-a-Service), como Microsoft Azure ou Amazon Web Services. Esta operação personalizada baseada em Java faz parte do sistema de base.
    HTTP Get Call
    Extrai informações de itens de configuração (ICs), que usam o protocolo HTTP. Esta operação personalizada faz parte do sistema de base.
    Consulta REST em nuvem
    Extrai informações de itens de configuração do tipo PaaS (Platform-as-a-Service), como Microsoft Azure ou Amazon Web Services. Esta operação personalizada baseada em Java script está disponível somente após o download de padrões versão 1.0.24 ou posterior da ServiceNow Store. Use esta operação em vez da operação de Chamada REST em nuvem.

    Além dessas operações personalizadas, é possível criar suas próprias operações para atender às necessidades do seu processo de descoberta. As operações personalizadas criadas por você aparecem na lista de operações junto com as operações que fazem parte do sistema de base.

    Procedimento

    1. Navegar até Todos > Designer de padrões > Operações Personalizadas.
    2. Para adicionar uma operação personalizada, clique em Novo.
      Ou
    3. Para modificar uma operação personalizada existente, clique em seu nome na tabela.
    4. Para a nova operação personalizada, insira um nome que descreva a nova operação no campo Nome.
      Por exemplo, se o objetivo desta operação é extrair informações usando um determinado protocolo, você pode nomeá-la como Consulta de protocolo NetApp.
    5. Insira ou modifique a finalidade ou a descrição da operação no campo Descrição.
    6. Escreva o script Java no painel Script para definir a lógica de negócios da operação.
      O script deve estar em conformidade com as seguintes diretrizes:
      • Crie variáveis para parâmetros de operação usando o cifrão na frente do nome da variável, por exemplo, $fileName.
      • CTX é um objeto que contém todas as informações resultantes de uma execução de padrão.
      • Use rtrn para indicar a cadeia de caracteres, que é o resultado da operação personalizada.
      Por exemplo: 
      ms.info('message from Custom operation MIDLogWrite ' + $logMessage);

      Onde ms.info é o log do MID Server. A variável $ logMessage se refere à mensagem criada dentro deste log do MID Server.

    7. Na lista relacionada Parâmetros de operação personalizada, defina os parâmetros de entrada usados no script Java.

      Por exemplo, se você usou uma variável para o arquivo de mensagem de log no script Java, também deve definir o parâmetro para esta variável:


      Defina parâmetros para variáveis usadas no script.
      Campo Descrição
      Rótulo Insira um rótulo curto e descritivo para o parâmetro. O rótulo é exibido na tabela. Por exemplo, netapp_query.
      Nome Insira um nome curto e claro para o parâmetro sem espaços, por exemplo, NetAppquery. Este nome aparece na lista de operações na página de etapa do padrão.
      Valor padrão Se relevante, insira o valor padrão. Por exemplo, POST.
      Obrigatório Defina como verdadeiro se este parâmetro for obrigatório para esta operação.

      Caso contrário, defina como falso.
      Ordem Defina a ordem em que os parâmetros aparecem na página de operação. Use números naturais, onde 1 significa que este parâmetro aparece na parte superior da página de operação.
      Domínio Para ambientes separados por domínio, especifique o nome do domínio para o qual este parâmetro é relevante.
      Regex de Validação Especifique uma expressão regular Java para validar o parâmetro. Durante o processo de descoberta, o MID Server valida o resultado da operação. O módulo Designer de padrões também executa a validação ao clicar em Testar na página da etapa do padrão.