Criar ações declarativas para assistentes do Catálogo de serviços

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura

    • Crie e configure ações declarativas para permitir que os administradores configurem botões (ações do assistente) em assistentes do Catálogo de serviços.

    Antes de Iniciar

    Existem dois tipos de ações declarativas para assistentes de catálogo:

    • Ação do cliente UXF: crie ações declarativas e mapeie uma ação para um manipulador de eventos no nível da página UIB. Use-a se você precisar manipular eventos no nível do UIB, como abrir uma caixa de diálogo ou abrir outro assistente de catálogo e assim por diante.
    • Client script: use um client script executado com um clique do botão. Use-o se você precisar manipular campos g_form do produtor de registros compostos vinculados ao assistente de catálogo.

    Assistente de catálogo é o modelo de ação declarativa do assistente de catálogo que tem os campos de modelo que definem as propriedades do assistente. Use esses campos para definir o que a carga útil pode conter (para tipo de ação do cliente UXF) ou defina condições para exibição do botão no assistente. Cada assistente deve usar o modelo Assistente de catálogo para criar ações declarativas.

    Função necessária: wizard_admin, admin

    Procedimento

    1. Navegar até Assistentes do Catálogo de serviços > Ações declarativas do assistente de catálogo.
      Importante:
      Use esse caminho de navegação somente para criar ações declarativas. Esse caminho define os campos corretamente quando o formulário de ação declarativa é carregado.
    2. Clique em Novo para criar uma nova ação declarativa.
    3. Especifique Campos do modelo de ação do Assistente de catálogo para criar cargas úteis.
      Os campos do modelo de ação estão disponíveis por padrão para ações declarativas do assistente de catálogo e aparecem na guia Campos do modelo de ação no formulário Atribuição de ação. Campos do Modelo de Ação
      Tabela 1. Guia Campos do modelo de ação
      Campo Descrição
      Ordem de etapas atual Ordem da etapa selecionada no momento.
      Tabela de destino Tabela de destino do produtor de registro ou do produtor de registros compostos usado pelo assistente.
      Produtor de registro Sys_id do produtor de registro ou do produtor de registros compostos usado pelo assistente.
      ID do assistente Sys_id do assistente.
      Habilitar salvamento Valor do campo Habilitar gravação no registro do assistente.
      Variáveis Objeto que contém nome e valor para variáveis do produtor de registros compostos associadas ao assistente.
      É novo registro O valor é Verdadeiro ao criar um novo registro usando o assistente.
      ID do modelo Sys_id do modelo aplicado no assistente.
      Tem etapa de revisão O valor do campo Tem etapa de revisão no registro do assistente.
      É a última etapa Indica se é a última etapa do assistente. A última etapa não depende da ordem e pode mudar dinamicamente com base no script do cliente ou nas políticas de IU do assistente.
      Sujeira no formulário O valor será Verdadeiro se o assistente tiver mudanças não salvas.
      Enviando O valor será Verdadeiro se um envio do assistente estiver em andamento.
      Modo Modo no qual o assistente está operando (modo Modelo ou Normal).
      Dados de registro de destino Não aplicável (este campo não é usado).
      ID do Registro Sys_id do registro criado ou editado pelo assistente.
    4. Clique no link Rótulo da ação para uma ação (como Inserir ou Excluir). Criando uma ação declarativa
      Tabela 2. Formulário Atribuição de ação
      Campo Descrição
      Rótulo da ação Exiba o rótulo do botão no assistente.
      Nome da ação Identificador da ação.
      Implementados como Ação do cliente UXF ou client script para ações declarativas do assistente.
      Especificar ação do cliente A definição de carga, se implementada como, será a Ação do cliente UXF.
      Client Script Se o valor do campo Implementado como for client script, esse valor deverá ser especificado.
      Importante:
      Você só pode usar as variáveis no CRP vinculadas ao assistente.
      Dica da ferramenta Dica de ferramenta do botão.
      Tipo de botão Os valores possíveis são Primário ou Secundário.
      Ordem Sequência em que o botão aparece.
      Agrupar por Opção que deverá ser selecionada se o botão fizer parte de um grupo.
      Grupo O grupo ao qual o botão pertence, para a opção Agrupar por. Botões agrupados são exibidos como um botão de divisão no assistente.
      Condições do cliente com script As condições a serem avaliadas durante a exibição do botão. Por exemplo: mode==‘template’&&variables.var==‘xxxx’.
      Nota:
      Este campo não aparece no formulário por padrão.
    5. Clique em Enviar para criar a ação do Assistente.
    6. Navegar até Assistentes do Catálogo de serviços > Configurações das ações do assistente do catálogo e clique em Novo.
      Crie um registro de configuração de ação do assistente para que você possa usar a ação declarativa em um assistente. Insira os campos a seguir no formulário.
      Tabela 3. Registro de configuração da ação do assistente
      Campo Descrição
      Nome Identificador do registro de configuração da ação do assistente.
      Ação declarativa Selecione uma ação declarativa que foi criada usando o modelo Assistente do catálogo.
      Aplica-se a O modo do assistente no qual esta ação deve aparecer. Os valores são Modo normal, Modo modelo ou Todos (ambos os modelos).
      Global Esta configuração de ação se aplica a todos os assistentes, independentemente de estar mapeada para um assistente específico ou não.
      Nota:
      As ações globais Salvar e Enviar estão disponíveis por padrão.
      Estouro O botão é exibido como parte do menu de estouro.
      Forçar gravação Salvará o assistente se algum valor de campo tiver sido atualizado no assistente antes do disparo da ação.
      Substituição de rótulo Insira um rótulo para substituir o rótulo especificado na ação declarativa.
      Substituição do tipo de botão O tipo de botão especificado pela ação declarativa é substituído.
    7. Navegar até Assistente de catálogo > Assistentes de manutenção.

      Para exibir uma ação declarativa como um botão no assistente, mapeie a Configuração de Ação do Assistente com o Assistente de Catálogo.

      Abra o assistente ao qual você deseja adicionar a ação declarativa. Use a lista relacionada Configurações de ações do assistente para criar um registro de mapeamento entre o assistente e a configuração de ação do assistente.
      1. Clique em Novo para criar diretamente uma nova configuração.
      2. Clique em Editar para anexar uma configuração existente a fim de criar um registro de mapeamento entre o assistente e a configuração. O registro de mapeamento também tem uma alternância para ocultar uma ação específica.
      3. Alterne o campo Ocultar ação para Verdadeiro a fim de ocultar uma ação específica.
        Dica:
        Botões com configurações globais estão disponíveis no assistente por padrão. Para ocultar uma ação global em um assistente, mapeie a configuração global para o assistente e defina Ocultar ação como verdadeiro.

      Para obter mais informações sobre assistentes de catálogo, consulte Criando um assistente do Catálogo de serviços.

    8. Use a ação Configurar mapeamentos de evento de ações declarativas na guia Configuração do Construtor de IU.
      Configure mapeamentos de evento de ações declarativas é aplicável somente ao tipo de ação do cliente UXF de ação declarativa. Crie um manipulador de eventos de nível de página e, em seguida, mapeie a ação declarativa para o manipulador de eventos do nível de página e especifique a carga útil. Para obter mais informações sobre como vincular eventos a ações declarativas no Construtor de IU, consulte Vinculação de um evento a uma ação declarativa.