--- sourceDocument: Xanadu IT Service Management sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/it-service-management Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu IT Service Management ft:clusterId : - itsm bundleId : - itsm workflow : - Technology --- # Migration zu ITSM Mobile Agent 5.0.3 # Migration zu ITSM Mobile Agent 5.0.3 {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer Durch die Migration zu ITSM Mobile Agent 5.0.3 werden in ITSM Mobile Agent das Next Experience-Design und die Compliance mit Barrierefreiheit aktiviert. Diese Migration umfasst die folgenden Komponentenänderungen: * Migration von Legacy-Symbolabschnitten zu neuen Symbolabschnitten. Dazu gehört eine bessere Gruppierung von Symbolabschnitten für Bereitschaftsplanung und Incidents sowie Farbvariablen für Symbole. * Migration von Legacy-UI-Parametern zu neuen Eingabeformular-Bildschirme. Das vereinfacht die Definition von Parametern, ermöglicht die Anwendung von Designs auf dem Bildschirm des Eingabeformulars und unterstützt Erweiterungen der Barrierefreiheit durch Mobile Plattform. * Migration von Legacy-Kartenansichten zu mobilen Ansichten. Ermöglicht die Verwendung von Farbvariablen je nach Design. * Anstatt mit UI-Stilen können alle Stiländerungen durch UI-Regeln vorgenommen werden. * Bei Schaltflächen, die eine positive Aktion ausführen, wurde die Schaltflächengewichtung von primär zu positiv geändert. {#migrate-itsm-mobile-agent-5.0.3__ul_uxj_mys_fwb} Wenn Kunden von einer älteren Version auf ITSM Mobile Agent 5.0.3 migrieren, werden die folgenden Schritte automatisch ausgeführt: * Wenn für die Anwendung ITSM Mobile Agent (sn_itsm_mobile_agt) das plugin.upgraded-Event ausgelöst wird, wird die Skriptaktion Run clean upgrade for ITSM Mobile Agent ausgeführt. * Diese Skriptaktion ruft die folgenden Upgrade-APIs auf: * Für die Migration von Legacy-Symbolabschnitten zu neuen Navigationsabschnitten: Methode cleanUpgradeIconSections() aus der Skripteinbindung sn_itsm_mobile_agt.MobileUtahUpgradeEngine. * Für die Migration von Legacy-UI-Parametern zum neuen Eingabeformular-Bildschirm: Methode cleanUpgradeButtonInstance() aus der Skripteinbindung sn_itsm_mobile_agt.MobileUtahUpgradeEngine. * Für die Migration von Legacy-Karten zu neuen mobilen Ansichten: Methode cleanUpgradeLegacyCards() aus der Skripteinbindung sn_itsm_mobile_agt.MobileUtahUpgradeEngine. * Eine Zuordnung mit Schlüssel-Wert-Paaren, sn_itsm_mobile_agt.MobileIconSectionMigrationConstant, wird eingeführt, wobei der Schlüssel die sys_id der Legacy-Standardkonfiguration ist und der Wert ein Objekt mit einer kommagetrennten Liste von Metadaten für die entsprechende neue Standardkonfiguration ist, die im Upgradeprozess eingeführt wird . {#migrate-itsm-mobile-agent-5.0.3__ul_jlh_vys_fwb} * Nachdem die Skriptaktion ausgeführt wurde und alle erforderlichen Aktionen ausgeführt hat, wird sie deaktiviert, damit sie bei zukünftigen Upgrades nicht erneut ausgeführt wird. {#migrate-itsm-mobile-agent-5.0.3__ul_mzl_rys_fwb} ## Migration von Legacy-Symbolabschnitten zu Navigationsabschnitten {#migrate-itsm-mobile-agent-5.0.3__section_pb1_xzs_fwb} In diesem Fall enthält die Skripteinbindung sn_itsm_mobile_agt.MobileIconSectionMigrationConstants die folgenden Schlüssel-Wert-Paare: * Schlüssel: sys_id des Legacy-Standarddatensatzes sys_sg_icon_section. * Wert: Objekt mit einer kommagetrennten Liste von sys_ids der Datensätze sys_sg_navigation_section und sys_sg_applet_launcher_m2m_section. {#migrate-itsm-mobile-agent-5.0.3__ul_shm_zzs_fwb} Die Skriptaktion Run clean upgrade for ITSM Mobile Agent (Sauberes Upgrade für ITSM Mobile Agent durchführen) wird ausgeführt, um für jeden Schlüssel in der Zuordnung die folgenden Schritte durchzuführen: 1. Überprüft die folgenden Datensätze auf Anpassungen. * Legacy-Standarddatensatz sys_sg_icon_section. * Vergleicht, ob der Legacy-Standardsymbolbereich im Vergleich zum neuen Standardsymbolbereich mindestens einen sys_sg_applet_launcher_m2m_section-Datensatz mehr oder weniger aufweist. {#migrate-itsm-mobile-agent-5.0.3__ul_trd_d1t_fwb} 2. Basierend auf Anpassungen wird einer der folgenden Schritte ausgeführt. * Wenn einer der oben genannten Datensätze angepasst ist, deaktiviert das Skript den neuen Standarddatensatz sys_sg_navigation_section. * Wenn keiner der oben genannten Datensätze angepasst ist, deaktiviert das Skript den Legacy-Standarddatensatz 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} Hinweis: * Anwenderdefinierte Symbolabschnitte, die standardmäßig nicht verfügbar sind, funktionieren weiterhin, unterstützen jedoch möglicherweise nicht das Next Experience-Design und die Compliance für Barrierefreiheit. Kunden müssen sie für eine bessere Experience in Navigationsabschnitte migrieren. * Für anwenderdefinierte Symbolabschnitte, die standardmäßig verfügbar sind, müssen Kunden die noch aktiven Legacy-Standardsymbolabschnitte manuell überprüfen und ihre Anpassungen auf die neuen Standardnavigationsabschnitte übertragen. * Wenn anwenderdefinierte Symbolabschnitte nicht in die neuen Navigationsabschnitte migriert werden, erwartet Anwender eine gemischte Experience, die möglicherweise nicht vollständig mit dem neuen Next Experience-Design kompatibel ist und zu Problemen mit der Barrierefreiheit führen kann. {#migrate-itsm-mobile-agent-5.0.3__ul_y35_31t_fwb} ## Migration von UI-Parametern zum Eingabeformular-Bildschirm {#migrate-itsm-mobile-agent-5.0.3__section_bc2_k1t_fwb} In diesem Fall enthält die Skripteinbindung sn_itsm_mobile_agt.MobileInputFormScreenMigrationConstants die folgenden Schlüssel-Wert-Paare: * Schlüssel: sys_id des Legacy-Standarddatensatzes sys_sg_button_instance. * Wert: Objekt mit kommagetrennter Liste von sys_ids des neuen Standarddatensatzes sys_sg_button_instance und anderer Metadaten. {#migrate-itsm-mobile-agent-5.0.3__ul_cxg_n1t_fwb} Die Skriptaktion Run clean upgrade for ITSM Mobile Agent (Sauberes Upgrade für ITSM Mobile Agent durchführen) wird ausgeführt, um für jeden Schlüssel in der Zuordnung die folgenden Schritte durchzuführen: 1. Überprüft die folgenden Datensätze auf Anpassungen. * Legacy-Standarddatensatz sys_sg_button_instance. * Datensatz sys_sg_button, der dem Datensatz sys_sg_button_instance zugeordnet ist. * Datensätze sys_sg_ui_parameter und sys_sg_action_param_map, die dem Datensatz sys_sg_button zugeordnet sind. * Datensatz sys_sg_write_back_action_item, der dem Datensatz sys_sg_button zugeordnet ist. {#migrate-itsm-mobile-agent-5.0.3__ul_exg_n1t_fwb} 2. Basierend auf Anpassungen wird einer der folgenden Schritte ausgeführt. * Wenn einer der oben genannten Datensätze angepasst ist, deaktiviert das Skript den neuen Standarddatensatz sys_sg_button_instance. * Wenn keiner der oben genannten Datensätze angepasst ist, deaktiviert das Skript den Legacy-Standarddatensatz 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} Hinweis: * Anwenderdefinierte Schaltflächeninstanz-Flows (UI-Parameter), die standardmäßig nicht verfügbar sind, funktionieren weiterhin, unterstützen jedoch möglicherweise nicht das Next Experience-Design und die Compliance für Barrierefreiheit. Kunden müssen sie für eine bessere Experience zu Eingabeformular-Bildschirmen migrieren. * Für anwenderdefinierte Schaltflächeninstanz-Flows (UI-Parameter), die standardmäßig verfügbar sind, müssen Kunden die noch aktiven Legacy-Standarddatensätze sys_sg_button_instance manuell überprüfen und ihre Anpassungen auf den neuen Flow sys_sg_button_instance übertragen (siehe Zuordnung sn_itsm_mobile_agt.MobileInputFormScreenMigrationConstants). Informationen zum Konfigurieren von Eingabeformular-Bildschirmen auf Mobilgeräten finden Sie unter [Eingabeformular-Bildschirm](https://www.servicenow.com/docs/access?context=parameter-input-screen&version=xanadu&pubname=xanadu-mobile&ft:locale=en-US). * Wenn anwenderdefinierte UI-Parameter nicht in die neuen Eingabeformular-Bildschirme migriert werden, erwartet Anwender eine gemischte Experience, die möglicherweise nicht vollständig mit dem neuen Next Experience-Design kompatibel ist und zu Problemen mit der Barrierefreiheit führen kann. {#migrate-itsm-mobile-agent-5.0.3__ul_ixg_n1t_fwb} ## Migration von Elementansichten zu neuen Mobile-Karten {#migrate-itsm-mobile-agent-5.0.3__section_w44_y1t_fwb} In diesem Fall enthält die Skripteinbindung sn_itsm_mobile_agt.MobileIconSectionMigrationConstants die folgenden Schlüssel-Wert-Paare: * Schlüssel: sys_id des Legacy-Standarddatensatzes sys_sg_item_view. * Wert: Objekt mit einer kommagetrennten Liste von sys_ids der Datensätze sys_sg_form_screen und sys_sg_master_item, in denen auf die Legacy-Karte (Elementansicht) verwiesen wird. {#migrate-itsm-mobile-agent-5.0.3__ul_dvy_z1t_fwb} Die Skriptaktion Run clean upgrade for ITSM Mobile Agent (Sauberes Upgrade für ITSM Mobile Agent durchführen) wird ausgeführt, um für jeden Schlüssel in der Zuordnung die folgenden Schritte durchzuführen: 1. Überprüft die folgenden Datensätze auf Anpassungen. * Legacy-Standarddatensatz sys_sg_item_view. * Alle sys_sg_ui_style-Datensätze, die dem Datensatz sys_sg_item_view zugeordnet sind. {#migrate-itsm-mobile-agent-5.0.3__ul_fvy_z1t_fwb} 2. Wenn einer der genannten Datensätze angepasst ist, setzt das Skript die Datensätze sys_sg_form_screen und sys_sg_master_item nur dann auf den vorherigen Status zurück, wenn diese Datensätze nicht angepasst sind. {#migrate-itsm-mobile-agent-5.0.3__ol_evy_z1t_fwb} Hinweis: * Anwenderdefinierte Elementansichten, die standardmäßig nicht verfügbar sind, funktionieren weiterhin, unterstützen jedoch möglicherweise nicht das Next Experience-Design und die Compliance für Barrierefreiheit. Kunden müssen sie für eine bessere Experience zu Eingabeformular-Bildschirmen migrieren. * Für anwenderdefinierte Symbolabschnitte, die standardmäßig verfügbar sind, müssen Kunden die alten Standard-Flows, die noch aktiv sind, manuell überprüfen und ihre Anpassungen auf den neuen Flow übertragen. Informationen zum Konfigurieren von Karten auf Mobilgeräten finden Sie unter [Bildschirme mit Mobile Card Builder anpassen](https://www.servicenow.com/docs/access?context=mcb-customize-item-view&version=xanadu&pubname=xanadu-mobile&ft:locale=en-US). * Wenn anwenderdefinierte Elementansichten nicht auf neue Mobile-Karten migriert werden, erwartet Anwender eine gemischte Experience, die möglicherweise nicht vollständig mit dem neuen Next Experience-Design kompatibel ist und zu Problemen mit der Barrierefreiheit führen kann. {#migrate-itsm-mobile-agent-5.0.3__ul_hvy_z1t_fwb}