--- sourceDocument: Yokohama Gestão de serviços de TI sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/it-service-management Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Yokohama Gestão de serviços de TI ft:clusterId : - itsm bundleId : - itsm workflow : - Technology --- # Migração para ITSM Mobile Agent 5.0.3 # Migração para ITSM Mobile Agent 5.0.3 {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 min. de leitura 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. {#migrate-itsm-mobile-agent-5.0.3__ul_uxj_mys_fwb} 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. {#migrate-itsm-mobile-agent-5.0.3__ul_jlh_vys_fwb} * 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. {#migrate-itsm-mobile-agent-5.0.3__ul_mzl_rys_fwb} ## Migração de seções de ícone legadas para novas seções de navegação {#migrate-itsm-mobile-agent-5.0.3__section_pb1_xzs_fwb} 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. {#migrate-itsm-mobile-agent-5.0.3__ul_shm_zzs_fwb} 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: 1. 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. {#migrate-itsm-mobile-agent-5.0.3__ul_trd_d1t_fwb} 2. 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. {#migrate-itsm-mobile-agent-5.0.3__ul_wrd_d1t_fwb} {#migrate-itsm-mobile-agent-5.0.3__ol_av1_d1t_fwb} 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. {#migrate-itsm-mobile-agent-5.0.3__ul_y35_31t_fwb} ## Migração de parâmetros da IU para a tela do formulário de entrada {#migrate-itsm-mobile-agent-5.0.3__section_bc2_k1t_fwb} 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. {#migrate-itsm-mobile-agent-5.0.3__ul_cxg_n1t_fwb} 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: 1. 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. {#migrate-itsm-mobile-agent-5.0.3__ul_exg_n1t_fwb} 2. 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. {#migrate-itsm-mobile-agent-5.0.3__ul_hxg_n1t_fwb} {#migrate-itsm-mobile-agent-5.0.3__ol_dxg_n1t_fwb} 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](https://www.servicenow.com/docs/access?context=parameter-input-screen&version=yokohama&pubname=yokohama-mobile&ft:locale=en-US). * 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. {#migrate-itsm-mobile-agent-5.0.3__ul_ixg_n1t_fwb} ## Migração de exibições de itens para novos cartões móveis {#migrate-itsm-mobile-agent-5.0.3__section_w44_y1t_fwb} 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. {#migrate-itsm-mobile-agent-5.0.3__ul_dvy_z1t_fwb} 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: 1. 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. {#migrate-itsm-mobile-agent-5.0.3__ul_fvy_z1t_fwb} 2. 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. {#migrate-itsm-mobile-agent-5.0.3__ol_evy_z1t_fwb} 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](https://www.servicenow.com/docs/access?context=mcb-customize-item-view&version=yokohama&pubname=yokohama-mobile&ft:locale=en-US). * 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. {#migrate-itsm-mobile-agent-5.0.3__ul_hvy_z1t_fwb}