Migrer le composant de l'interface utilisateur de Espace de travail d'agent pour ITSM vers Espace de travail pour l'exploitation des services pour ITSM

Configurez le composant de l'interface utilisateur pour migrer les actions de liste de Espace de travail d'agent pour ITSM vers Espace de travail pour l'exploitation des services (SOW) pour ITSM.

Avant de commencer

Lors de la migration, vous devez avoir sélectionné l’option Actions de liste pour les fonctionnalités Espace de travail d'agent pour ITSM. Par exemple, l’option Actions de liste pour Liste. Pour plus d'informations sur le processus de migration, voir Migrer de Espace de travail d'agent pour ITSM vers Espace de travail pour l'exploitation des services pour ITSM.

Rôle requis : administrateur

Pourquoi et quand exécuter cette tâche

À la fin du processus de migration, un message de confirmation indique si la migration a réussi ou non. Vous pouvez examiner les informations relatives à la migration et effectuer les étapes postérieures à la migration pour confirmer la réussite de votre configuration ou personnalisation.

Procédure

1. Accédez à la Tous > Cadre de travail Now Experience > Actions déclaratives > Actions de la liste.
2. Filtrez les enregistrements en définissant l'option Implémenté en tant sur Composant de l'interface utilisateur.
3. Affichez le journal de l'enregistrement ayant échoué lors du processus de migration et recherchez le sys_Id de l'enregistrement dans la liste Actions de liste.
4. Sélectionnez l’enregistrement ayant échoué avec le sys_id correspondant.
5. Cliquez avec le bouton droit de la souris sur l'en-tête, puis sélectionnez Insérer et rester.
6. Effacez les champs Espace de travail et Vue.
7. Cochez la case Expérience restreinte.
8. Mettez à jour la valeur du champ Implémenté en tant que sur Action du client UXF.
9. Dans la liste connexe Configuration de l'action, sélectionnez Modifier, puis sélectionnez Actions SOW dans la liste Collection vers la liste Configurations de l'action.
10. Enregistrez la liste Configurations de l'action en sélectionnant Enregistrer.
    Remarque :

    Il n'est pas possible dans ce cas d'ajouter un composant Multiple Record Associator (MRA) ou Intercepteur à la liste. Si vous migrez une personnalisation avec le composant MRA ou Intercepteur, vous devez vérifier le mappage d'événements de complément pour les enregistrements du système de base. Dans le système de base, les mappages d'événements de complément pour les actions déclaratives de la liste ne sont pas spécifiés.

11. Sélectionnez Mettre à jour.

    L'utilitaire de migration prend uniquement en charge les actions déclaratives MRA et Intercepteur du type de composant d'interface utilisateur.

12. Pour MRA, créez une charge utile d'action conformément au bloc de code, puis mettez à jour les valeurs dans les attributs d'action avec les attributs de composant de l'action déclarative Espace de travail d'agent pour ITSM.

    Si aucune valeur n'est spécifiée dans l'enregistrement d'action déclarative Espace de travail d'agent pour ITSM, spécifiez la valeur {{ key }}. Par exemple, si la table des attributs de composant est vide, la valeur doit être {{table}} dans la charge utile.

    { 
    "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. Pour Intercepteur, créez une charge utile d'action conformément au bloc de code de la table Définition de la charge utile de l'action [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. Ajoutez un mappage d'événement de complément à l'action déclarative migrée.

    Recherchez l’action déclarative correspondante dans SOW et ajoutez tous les mappages d’événements de complément à l’action déclarative migrée. Procédez comme suit pour localiser l’action déclarative équivalente dans SOW.

    1. Accédez à la Tous > sys_ux_addon_event_mapping.liste
    2. Filtrez la table puis, à l’aide du nom de table migré et du mappage de charge utile cible, recherchez contains mra ou interceptor route.
    3. Si l'enregistrement est trouvé, renvoyez l'action déclarative sys_id.

       Itérez à travers tous les mappages d'événements de complément pour les actions déclaratives filtrées et ajoutez-les aux actions déclaratives migrées.

    4. Si l'enregistrement est introuvable avec la table, supprimez le filtre de table et recherchez targetPayload contains route=mra ou interceptor.
       Pour le décorateur Liste et Champ, vous devez ajouter manuellement les mappages d’événements du complément MRA et Interceptor. Pour plus d'informations, consultez Create a UX add-on event mapping.
    Remarque :

    L'enregistrement de l'intercepteur de demande de changement [change_request] dans Espace de travail d'agent pour ITSM existe dans SOW.

    Migration des sélecteurs de type d'enregistrement d'espace de l'espace de travail pour le type d'intercepteur de l'action déclarative :

    • Table Espace de travail d'agent pour ITSM : Sélecteur de types d'enregistrements d'espace de travail [aw_record_type_selector]
    • Table SOW : Sélecteur de type d'enregistrement [sn_sow_interceptor_record_type_selector]

    Pour une table de demande de changement [change_request] ayant une valeur standard, l'option Actif est définie sur False lors de la migration des enregistrements de Espace de travail d'agent pour ITSM vers SOW.