Migração para ITSM Mobile Agent 5.0.3
A migração para ITSM Mobile Agent 5.0.3 habilita a conformidade de acessibilidade e o tema do Next Experience no ITSM Mobile Agent.
Essa migração inclui as seguintes mudanças de componente:
- Migração de seções de ícone legadas para novas seções de ícone. Inclui melhor agrupamento de seções de ícones para agendamento de plantão e incidentes junto a variáveis de cor para ícones.
- Migração de parâmetros da IU legados para novas telas de formulário de entrada. Simplifica a forma como os parâmetros são definidos, habilita a atribuição de tema na tela do formulário de entrada e oferece suporte a melhorias de acessibilidade pela Plataforma para celular.
- Migração de exibições de cartão legadas para visualizações móveis. Permite o uso de variáveis de cores conforme o tema.
- Todas as mudanças de estilo podem ser feitas por meio de regras de IU em vez de estilos de IU.
- Para botões que executam uma ação positiva, a ênfase do botão foi alterada de primária para positiva.
Quando os clientes migram de qualquer versão anterior para ITSM Mobile Agent 5.0.3, as seguintes etapas são executadas automaticamente:
- Quando o evento plugin.upgraded é acionado para o aplicativo ITSM Mobile Agent (sn_itsm_mobile_agt), a ação de script Run clean upgrade for ITSM Mobile Agent é executada.
- Essa ação de script invoca as seguintes APIs de upgrade:
- Para seções de ícone legado para novas seções de navegação, o método cleanUpgradeIconSections () da inclusão de script sn_itsm_mobile_agt.MobileUtaUpgradeEngine.
- Para parâmetros de IU antigos para a nova tela de formulário de entrada, o método cleanUpgradeButtonInstance () da inclusão de script sn_itsm_mobile_agt.MobileUtahUpgradeEngine.
- Para cartões legados para novas visualizações móveis, o método cleanUpgradeLegacyCards() da inclusão de script sn_itsm_mobile_agt.MobileUtaUpgradeEngine.
- Um mapa com pares de chave-valor, sn_itsm_mobile_agt.MobileIconSectionMigrationConstant, é introduzido no qual a chave é o sys_id da configuração padrão legada e o valor é um objeto com uma lista separada por vírgulas de metadados da nova configuração padrão correspondente que é introduzida no processo de upgrade.
- Depois que a ação de script é executada e todas as ações necessárias são feitas, ele é desativado para que não seja executado novamente em upgrades futuros.
Migração de seções de ícone legadas para novas seções de navegação
Nesse caso, a inclusão de script sn_itsm_mobile_agt.MobileIconSectionMigrationConstants contém os seguintes pares de chave-valor:
- Chave: sys_id do registro padrão legado sys_sg_icon_section.
- Valor: objeto com uma lista separada por vírgulas de sys_ids de registros sys_sg_navigation_section e sys_sg_applet_launcher_m2m_section.
O script de upgrade de ação Executar upgrade limpa do ITSM Mobile Agent é executado para fazer as seguintes etapas para cada chave do mapa:
- Verifica se há personalizações nos registros a seguir.
- Registro padrão de legado sys_sg_icon_section.
- Compara se a seção de ícones padrão legada tem pelo menos um registro sys_sg_applet_launcher_m2m_section novo ou a menos quando comparada com a nova seção de ícones padrão.
- Com base nas personalizações, uma das etapas a seguir é executada.
- Se qualquer um dos registros acima for personalizado, o script desativará o novo registro padrão sys_sg_navigation_section.
- Se nenhum dos registros acima for personalizado, o script desativará o registro padrão legado sys_sg_icon_section.
Nota:
- As seções de ícones personalizados que não estão disponíveis por padrão continuam funcionando, mas podem não ser compatíveis com a conformidade de acessibilidade e o tema do Next Experience. Os clientes devem migrá-las para seções de navegação para oferecer uma melhor experiência.
- Para seções de ícones personalizados que estão disponíveis por padrão, os clientes devem revisar manualmente as seções de ícone padrão legadas que ainda estão ativas e mover suas personalizações para as novas seções de navegação padrão.
- Se as seções de ícones personalizados não forem migradas para as novas seções de navegação, os usuários terão uma experiência mista que pode não ser totalmente compatível com o novo tema do Next Experience e pode levar a problemas de acessibilidade.
Migração de parâmetros da IU para a tela do formulário de entrada
Nesse caso, a inclusão de script sn_itsm_mobile_agt.MobileInputFormScreenMigrationConstants contém os seguintes pares de chave-valor:
- Chave: sys_id do registro padrão legado sys_sg_button_instance.
- Valor: objeto com uma lista separada por vírgulas de sys_ids do novo registro sys_sg_button_instance padrão e outros metadados.
O script de upgrade de ação Executar upgrade limpa para ITSM Mobile Agent é executado para, em seguida, fazer as seguintes etapas para cada chave no mapa:
- Verifica se há personalizações nos registros a seguir.
- Registro padrão de legado sys_sg_button_instance.
- Registro sys_sg_button associado ao registro sys_sg_button_instance.
- Registros sys_sg_ui_parameter e sys_sg_action_param_map associados ao registro sys_sg_button.
- Registro sys_sg_write_back_action_item associado ao registro sys_sg_button.
- Com base nas personalizações, uma das etapas a seguir é executada.
- Se qualquer um dos registros acima for personalizado, o script desativará o novo registro padrão sys_sg_button_instance.
- Se nenhum dos registros acima for personalizado, o script desativará o registro padrão legado sys_sg_button_instance.
Nota:
- Os fluxos de instância de botões personalizados (parâmetros de IU) que não estão disponíveis por padrão continuam funcionando, mas podem não ser compatíveis com a conformidade de acessibilidade e o tema do Next Experience. Os clientes devem migrá-los para telas de formulário de entrada para a melhor experiência.
- Para fluxos de instância de botões personalizados (parâmetros de IU) que estão disponíveis por padrão, os clientes devem revisar manualmente os registros padrão legados sys_sg_button_instance que ainda estão ativos e mover suas personalizações para o novo fluxo sys_sg_button_instance (consulte o mapa sn_itsm_mobile_agt.MobileInputFormScreenMigrationConstants). Para configurar as telas do formulário de entrada em dispositivos móveis, consulte Tela do formulário de entrada.
- Se os parâmetros de IU personalizados não forem migrados para as novas telas do formulário de entrada, os usuários terão uma experiência mista que pode não ser totalmente compatível com o novo tema Next Experience e pode levar a problemas de acessibilidade.
Migração de exibições de itens para novos cartões móveis
Nesse caso, a inclusão de script sn_itsm_mobile_agt.MobileIconSectionMigrationConstants contém os seguintes pares de chave-valor:
- Chave: sys_id do registro padrão legado sys_sg_item_view.
- Valor: objeto com uma lista separada por vírgulas de sys_ids de registros sys_sg_form_screen e sys_sg_master_item em que o cartão legado (ou seja, a exibição de item) é referenciado.
O script de upgrade de ação Executar upgrade limpa do ITSM Mobile Agent é executado para, em seguida, fazer as seguintes etapas para cada chave do mapa:
- Verifica se há personalizações nos registros a seguir.
- Registro padrão de legado sys_sg_item_view.
- Todos os registros sys_sg_ui_style associados ao registro sys_sg_item_view.
- Se qualquer um dos registros mencionados for personalizado, o script reverterá os registros sys_sg_form_screen e sys_sg_master_item para o estado anterior somente se esses registros não forem personalizados.
Nota:
- As exibições de item personalizadas que não estão disponíveis por padrão continuarão funcionando, mas podem não ser compatíveis com o tema Next Experience e a conformidade de acessibilidade. Os clientes devem migrá-las para telas de formulário de entrada para oferecer uma melhor experiência.
- Para seções de ícones personalizados que estão disponíveis por padrão, os clientes devem revisar manualmente fluxos padrão antigos que ainda estão ativos e mover suas personalizações para o novo fluxo. Para obter informações sobre como configurar cartões em dispositivos móveis, consulte Personalizar uma tela usando o Construtor de cartões para Mobile.
- Se as exibições de item personalizadas não forem migradas para novos cartões móveis, os usuários terão uma experiência mista que pode não ser totalmente compatível com o novo tema Next Experience e pode levar a problemas de acessibilidade.