Migrar o Componente da IU de Espaço do agente do ITSM a Espaço de operações de serviços para ITSM

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura

    • Configure o Componente da IU para migrar ações de lista de Espaço do agente do ITSM a Espaço de operações de serviços (SOW) para ITSM.

    Antes de Iniciar

    Ao executar a migração, você precisa ter selecionado a opção Ações de lista nos recursos do Espaço do agente do ITSM. Por exemplo, a opção Ações de lista da Lista. Para informações sobre o processo de migração, consulte Migrar de Espaço do agente do ITSM a Espaço de operações de serviços para ITSM.

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    No final do processo de migração, uma mensagem de confirmação especifica se a migração foi ou não bem-sucedida. Você pode revisar as informações de migração e executar as etapas de ações pós-migração para confirmar se a migração da sua configuração ou personalização foi bem-sucedida.

    Procedimento

    1. Navegar até Tudo > Estrutura do Now Experience > Ações declarativas > Ações de lista.
    2. Filtre os registros com base em Implementado como definido como Componente da IU.
    3. Exiba o log no registro com falha no processo de migração e localize o sys_Id do registro na lista Ações de Lista.
    4. Selecione o registro com falha que tem o sys_id correspondente.
    5. Selecione e segure (ou clique com o botão direito do mouse) no cabeçalho e escolha Inserir e ficar.
    6. Limpe os campos Espaço e Exibir.
    7. Marque a caixa de seleção Experiência restrita.
    8. Atualize o valor do campo Implementado como para Ação do Cliente UXF.
    9. Na lista relacionada Configuração da Ação, selecione Editar e, em seguida, escolha Ações do SOW da lista Coleção para a lista Configurações da ação.
    10. Salve a lista Configurações da Ação selecionando Salvar.
      Nota:

      Adicionar Associador de Vários Registros (MRA) ou Interceptador à lista não é um cenário válido. Se você estiver migrando uma personalização com MRA ou Interceptador, deverá verificar o mapeamento de evento de complemento para os registros do sistema de base. No sistema de base, os mapeamentos de evento de complemento para ações declarativas da lista não são especificados.

    11. Selecione Atualizar.

      O utilitário de migração oferece suporte a ações declarativas de MRA e Interceptador somente do tipo componente da IU.

    12. Para MRA, crie uma carga de ação conforme mencionado no bloco de código, atualize os valores dos atributos de ação com os atributos de componente da ação declarativa do Espaço do agente do ITSM.

      Se nenhum valor for preenchido no registro da ação declarativa do Espaço do agente do ITSM, preencha o valor com {{ key }}. Por exemplo, se a tabela de atributos de componente estiver vazia, então, na carga o valor deverá ser {{table}}.

      { 
"label": "label", 
                "extensionPoint": "extensionPoint", 
                "userGivenTable": "userGivenTable", 
                "hideSelectAll": "hideSelectAll", 
                "parentRecordSysId": "parentRecordSysId", 
                "table": "table", 
                "referencedFieldName": "referencedFieldName", 
                "type": "type", 
                "parentFieldName": "parentFieldName", 
                "columns": "columns", 
                "view": "view", 
                "relatedListName": "relatedListName" 
        }
    13. Para Interceptador, crie uma carga de ação conforme mencionado no bloco de código da tabela Definição de Carga de Ação [sys_declarative_action_payload_definition]. 
      { 
    "table": "target", 
                "sysId": "-1", 
                "parentTable": "{{parentTable}}", 
                "parentSysId": "{{parentRecordSysId}}", 
                "referencedFieldName": "", 
                "pageTitle": "Create " + tableLabel, 
                "pageSubTitle": "Choose one of the following " + tableLabel + " types", 
                "useDomain": false 
}
    14. Adicione um mapeamento de evento de complemento à ação declarativa migrada.

      Encontre a ação declarativa correspondente no SOW e adicione todos os mapeamentos de Evento de Complemento à ação declarativa migrada. Use as seguintes etapas para encontrar a ação declarativa equivalente no SOW.

      1. Navegar até Tudo > sys_ux_addon_event_mapping.list
      2. Filtre a tabela e usando o nome da tabela migrada e o mapeamento de carga de destino contém mra ou rota do interceptador.
      3. Se o registro for encontrado, retorne o sys_id da Ação Declarativa.

        Itere todos os mapeamentos de evento de complemento para as ações declarativas filtradas e adicione-os às ações declarativas migradas.

      4. Se o registro não for encontrado na tabela, remova o filtro de tabela e pesquise por targetPayload contém rota=mra ou interceptador.
        Para o decorador de Lista e Campo, você deve adicionar os mapeamentos de evento do complemento de Interceptador e MRA manualmente. Para obter mais informações, consulte Create a UX add-on event mapping.
      Nota:

      O registro de Interceptador da Solicitação de Mudança [change_request] em Espaço do agente do ITSM existe no SOW.

      Os seletores de tipo de registro do espaço de migração para o tipo Interceptador da ação declarativa são:
      • Tabela do Espaço do agente do ITSM: seletor de tipos de registro do espaço [aw_record_type_selector]
      • Tabela do SOW: seletor de tipo de registro [sn_sow_interceptor_record_type_selector]

      Para uma tabela de Solicitação de Mudança [change_request] que tem um valor como padrão, Ativo é definido como Falso ao migrar os registros do Espaço do agente do ITSM para o SOW.