UI-Komponente von ITSM-Mitarbeiterbereich nach Service Operations-Arbeitsbereich für ITSM migrieren

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

    • Konfigurieren Sie die UI-Komponente, um Listenaktionen von ITSM-Mitarbeiterbereich nach Service Operations-Arbeitsbereich (SOW) für ITSMzu migrieren.

    Vorbereitungen

    Während der Migration müssen Sie die Option Listenaktionen für ITSM-Mitarbeiterbereich-Funktionen ausgewählt haben. Zum Beispiel die Option Listenaktionen für „Liste“. Weitere Informationen zum Migrationsprozess finden Sie unter Migration von ITSM-Mitarbeiterbereich nach Service Operations-Arbeitsbereich für ITSM.

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Am Ende des Migrationsprozesses wird in einer Bestätigungsmeldung angegeben, ob die Migration erfolgreich war oder nicht. Sie können die Migrationsinformationen überprüfen und die Schritte nach der Migration ausführen, um die erfolgreiche Migration Ihrer Konfiguration oder Anpassung zu bestätigen.

    Prozedur

    1. Navigieren zu Alle > Now-Experience-Framework > Deklarative Aktionen > Listenaktionen.
    2. Filtern Sie die Datensätze wie folgt: Implementiert als ist festgelegt als UI-Komponente.
    3. Zeigen Sie das Protokoll im fehlgeschlagenen Datensatz im Migrationsprozess an, und suchen Sie die sys_Id des Datensatzes aus der Liste Listenaktionen.
    4. Wählen Sie den fehlgeschlagenen Datensatz mit der entsprechenden sys_id aus.
    5. Wählen und halten Sie den Header (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie Einfügen und beibehalten.
    6. Löschen Sie die Felder Arbeitsbereich und Ansicht.
    7. Aktivieren Sie das Kontrollkästchen Auf Experience beschränkt.
    8. Aktualisieren Sie den Wert im Feld Implementiert als auf UXF-Clientaktion.
    9. Wählen Sie in der zugehörigen Liste Aktionskonfiguration die Option Bearbeiten, und wählen Sie dann SOW-Aktionen aus der Liste Sammlung zur Liste Aktionskonfigurationen.
    10. Wählen Sie Speichern, um die Liste Aktionskonfigurationen zu speichern.
      Hinweis:

      Das Hinzufügen von MRA (Multiple Record Associator) oder Interceptor zur Liste ist kein gültiges Szenario. Wenn Sie eine Anpassung mit MRA oder Interceptor migrieren, müssen Sie die Add-on-Ereigniszuordnung für die Basissystemdatensätze überprüfen. Im Basissystem sind keine Add-on-Ereigniszuordnungen für deklarative Listenaktionen angegeben.

    11. Wählen Sie Aktualisieren.

      Das Migrationsdienstprogramm unterstützt nur deklarative MRA- und Interceptor-Aktionen vom Typ „UI-Komponente“.

    12. Erstellen Sie für MRA eine Aktionsnutzlast wie im Codeblock angegeben, und aktualisieren Sie die Werte in Aktionsattributen mit Komponentenattributen der deklarativen ITSM-Mitarbeiterbereich-Aktion.

      Wenn im Datensatz der deklarativen ITSM-Mitarbeiterbereich-Aktion kein Wert eingetragen ist, füllen Sie den Wert mit {{ key }}. Wenn beispielsweise die Komponentenattributtabelle leer ist, muss der Wert in der Nutzlast {{table}} lauten.

      { 
"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. Erstellen Sie für den Interceptor eine Aktionsnutzlast, wie im Codeblock in der Tabelle „Definition der Aktionsnutzlast“ [sys_declarative_action_payload_definition] angegeben. 
      { 
    "table": "target", 
                "sysId": "-1", 
                "parentTable": "{{parentTable}}", 
                "parentSysId": "{{parentRecordSysId}}", 
                "referencedFieldName": "", 
                "pageTitle": "Create " + tableLabel, 
                "pageSubTitle": "Choose one of the following " + tableLabel + " types", 
                "useDomain": false 
}
    14. Fügen Sie der migrierten deklarativen Aktion eine Add-on-Ereigniszuordnung hinzu.

      Suchen Sie die entsprechende deklarative Aktion in SOW, und fügen Sie der migrierten deklarativen Aktion sämtliche Add-on-Ereigniszuordnungen hinzu. Führen Sie die folgenden Schritte aus, um die entsprechende deklarative Aktion in SOW zu finden.

      1. Navigieren zu Alle > sys_ux_addon_event_mapping.list
      2. Filtern Sie die Tabelle mit dem migrierten Tabellennamen und Zuordnung der Zielnutzlast enthält mra oder interceptor route.
      3. Wenn der Datensatz gefunden wird, geben Sie die sys_id der deklarativen Aktion zurück.

        Iterieren Sie durch alle Add-on-Ereigniszuordnungen der gefilterten deklarativen Aktionen, und fügen Sie sie den migrierten deklarativen Aktionen hinzu.

      4. Wenn der Datensatz nicht mit der Tabelle gefunden wird, entfernen Sie den Tabellenfilter, und suchen Sie nach targetPayload enthält route=mra oder interceptor.
        Für Listen- und Feld-Decorator-Elemente müssen Sie die Add-on-Ereigniszuordnungen für MRA und Interceptor manuell hinzufügen. Weitere Informationen finden Sie unter Create a UX add-on event mapping.
      Hinweis:

      Der Interceptor-Datensatz für Change-Anforderungen [change_request] in ITSM-Mitarbeiterbereich ist in SOW vorhanden.

      Die folgende Auswahlen des Arbeitsbereichs-Datensatztyps für den Interceptor-Typ der deklarativen Aktion werden migriert:
      • ITSM-Mitarbeiterbereich-Tabelle: Auswahl für Datensatztypen des Arbeitsbereichs [aw_record_type_selector]
      • SOW-Tabelle: Datensatztypauswahl [sn_sow_interceptor_record_type_selector]

      Für eine Change-Anforderungstabelle [change_request] mit dem Wert „Standard“ wird „Aktiv“ auf „false“ festgelegt, wenn die Datensätze von ITSM-Mitarbeiterbereich nach SOW migriert werden.