Verwalten von UI-Konfigurationen

Mit dieser Web-Dynpro-Anwendung (USMD_UI_CONFIGURATION) starten Sie Funktionen des Floorplan Managers (FPM), mit denen Sie UI-Konfigurationen anlegen und bearbeiten können. UI-Konfigurationen sind mandantenunabhängig.

Integration

UI-Konfigurationen setzen Sie an folgenden Stellen ein:

in der Benutzer- und Rollenbearbeitung unter Personalisierung
Die Systemadministration kann für Benutzer ein Standard-Datenmodell und eine UI-Konfiguration zuordnen.
beim Anlegen eines Änderungsantrags

Sie können im Customizing der Stammdaten-Governance unter Allgemeine Einstellungen Prozessmodellierung Änderungsanträge Typ des Änderungsantrags anlegen pro Änderungsantragstyp auf der Ebene des Entitätstyps die ID einer UI-Konfiguration zuordnen. Dies gilt nur für Änderungsantragstypen mit dem Attribut Einzelobjekt und nur für den Hauptentitätstyp.

Das System verwendet diese UI-Konfigurationszuordnung mit höchster Priorität. Wenn beim Änderungsantragstyp nichts eingetragen ist, verwendet das System die benutzerspezifische UI-Konfigurationszuordnung aus der Personalisierung. Wenn keine UI-Konfiguration für den Benutzer zugeordnet ist, verwendet das System die der Rolle zugeordnete UI-Konfiguration.
zur Laufzeit der Einzelbearbeitung

Sie können die benutzerspezifischen (nicht die rollenspezifischen) Einstellungen über Modell ändern anpassen.

Sie können die Standardverarbeitung der UI-Konfiguration mit dem Business Add-In BAdI: Benutzungsoberfläche für Einzelbearbeitung anpassen (USMD_UI_EVENT2) übersteuern. Mit diesem BAdI sind weitreichende UI-Anpassungen möglich.

Voraussetzungen

Sie führen die WD-Anwendung USMD_UI_CONFIGURATION aus, z.B. im Customizing der Stammdaten-Governance unter Allgemeine Einstellungen UI-Modellierung mit der Aktivität UI-Konfiguration bearbeiten.
Es ist ein aktives Datenmodell vorhanden.
Sie verfügen über Grundkenntnisse der FPM-Benutzung sowie der Anwendungs- und Component-Konfiguration mit Web Dynpro ABAP.

Funktionsumfang

UI-Konfigurationen anlegen

Zum Anlegen startet das System den FPM-Anwendungshierarchie-Browser. Das Anlegen ist nur im Deep-Copy-Modus möglich. Das Anlegen umfasst zunächst nur das Anlegen einer ID für die UI-Konfiguration.

Empfehlung

Wir empfehlen, mindestens die Zielkonfigurations-ID in der Zeile für die Anwendungskonfiguration zu ändern. Diesen alphanumerischen Wert verwendet das System für die Personalisierung der Benutzer- und Rolleneinstellungen.

Die Zielkonfigurations-ID repräsentiert die UI-Konfiguration. Im FPM ist die UI-Konfiguration eine Web-Dynpro-Anwendungskonfiguration für die Web-Dynpro-Anwendung USMD_ENTITY_VALUE2 (Einzelbearbeitung).

Ende der Empfehlung.

Beim Anlegen erzeugt das System von der ausgelieferten UI-Konfiguration USMD_ENTITY_VALUE2 eine Kopie, die alle abhängigen UI-Konfigurationen enthält. Von dieser kopierten Vorlage übernimmt das System alle Einstellungen für die Kopfdaten sowie den Identifikationsbereich (IDR) mit allen untergeordneten Knoten. Zu jeder Anwendungs- und zu jeder Component-Konfiguration legt das System automatisch eine Zielkonfigurations-ID an.

Beim Anlegen mit Vorlage kopiert das System auch die Datenmodellzuordnung und die Benutzungsoberflächenbausteine (UIBB) der Component-Konfiguration FPM_OIF_COMPONENT.

UI-Konfigurationen bearbeiten

Empfehlung

Wir empfehlen, dass Sie möglichst nicht die ausgelieferten UI-Konfigurationen bearbeiten.

Ende der Empfehlung.

Sie haben u.a. folgende Bearbeitungsmöglichkeiten:

Sie können das Datenmodell zuordnen.

Einer neu angelegten UI-Konfiguration ist noch kein Datenmodell zugeordnet. Sie können daher beim Bearbeiten der UI-Konfiguration ein Datenmodell zuordnen.
Sie können in der Component-Konfiguration die UIBB auswählen und konfigurieren
Welche Auswahl hier möglich ist, hängt vom Entitätstyp und Datenmodell ab. Sie können zu jedem Entitätstyp mit Ablage- und Verwendungsart 1 eine oder mehrere Hauptsichten anlegen. Pro Sicht legen Sie mindestens einen UIBB an.
Sie können Felder in UIBBs mit einem der ausgelieferten Standard-Ereignisse verknüpfen:
- USMD_ENTER
  
  Ereignis bei Betätigen der Eingabetaste
- USMD_ACTION
  
  Ereignis beim Wählen einer Drucktaste oder Ausführen eines Links
  
  Wenn Sie mehrere Drucktasten oder Links verwenden, geben Sie zu dieser Ereignis-ID auch einen Identifikator an. Damit können Sie im BAdI USMD_UI_EVENT2 die Ereignisse voneinander unterscheiden.
Wenn der Entitätstyp die entsprechende Funktion unterstützt, können Sie folgende UIBBs hinzufügen:
- für Hierarchien den UIBB Hierarchiebeziehung
- für Sets den UIBB Sets
- für Anlagen den UIBB Anlagen
- für sprachabhängige Texte den UIBB Textübersetzung
Beim Hinzufügen übernimmt das System automatisch die jeweils erforderlichen Standard-UI-Bausteine.
Für Entitätstypen mit Ablage- und Verwendungsart 4 können Sie die Tabellendarstellung nach dem Master-Detail-Prinzip konfigurieren. Dabei zeigt das System zu einer Zeile, die Sie in einer übergeordneten Tabelle (Master-Tabelle) ausgewählt haben, die abhängigen Detaildaten in einem Formular unter der Tabelle an.

Hinweis
Die Einzelpflege-UI USMD_ENTITY_VALUE2 unterstützt nur die Schachtelung einer führenden Entität mit einer Ablage- und Verwendungsart 1 in eine abhängige Entität mit einer Ablage- und Verwendungsart 4.

Ende des Hinweises

Um eine Master-Detail-Darstellung zu konfigurieren, geben Sie beim Anlegen eines Formular-UIBBs als Enthaltenen Entitätstyp den Entitätstyp an, für den Sie die übergeordnete Tabelle konfiguriert haben.

Hinweis
Für ein einfaches Formular ist im Dialogfenster Parameter bearbeiten keine Eingabe des Enthaltenen Entitätstyps erforderlich. Sie müssen ihn jedoch angeben, wenn das System zum Entitätstyp der Master-Tabelle weitere Details anzeigen soll.

Ende des Hinweises
Fremde Entitätstypen einbinden
Wenn Sie Daten fremder Entitätstypen nur anzeigen wollen, können Sie auch andere als den aktuell bearbeiteten Entitätstyp in Ihr UI einbetten. Sie geben dazu im aktuell bearbeiteten Entitätstyp einfach die Konfigurations-ID des fremden Entitätstyps an (Sie überschreiben den Eintrag im Feld Konfig.-Name).

Beispiel
Zum Entitätstyp Konto (Buchungskreis) – dieser enthält die buchungskreisabhängigen Daten – zeigen Sie das Konto an.

Ende des Beispiels.

Sie können beliebige Formular- oder Tabellen-UIBBs von fremden Entitätstypen des eigenen Datenmodells hinzufügen. Um der Einzelbearbeitung eine eindeutige ID für den anzuzeigenden Wert mitzuteilen, müssen Sie ggf. dazu das BAdI USMD_UI_EVENT2 implementieren.
Testen
Über die gleichnamige Drucktaste in der Anwendungskonfiguration können Sie anzeigen, wie Ihre UI-Konfiguration in der Einzelbearbeitung aussehen wird.

Aktivitäten

Anlegen

Sie wählen Anlegen. Das System öffnet den Floorplan Manager Anwendungshierarchie-Browser.
Sie überschreiben die Zielkonfigurations-ID mit einem möglichst sprechenden Wert aus dem Kundennamensraum <Z...>.
Sie wählen im Deep-Copy-Modus die Funktion Deep Copy starten.
1. Sie wählen das Paket für die Web Dynpro Component-Konfiguration aus und bestätigen die weiteren Dialogfenster.
2. Auf der Basis der Vorlagekonfiguration USMD_ENTITY_VALUE2 legt das System eine neue UI-Konfiguration an.
Sie aktualisieren die Anzeige der WD-Anwendung UI-Konfigurationen verwalten. Die neu angelegte (kundeneigene) UI-Konfiguration erscheint in der Liste.

Anlegen mit Vorlage

Sie markieren zunächst im Bild UI-Konfigurationen verwalten eine UI-Konfiguration (z.B. eine von SAP ausgelieferte UI-Konfiguration oder eine bereits bearbeitete, mit zugeordnetem Datenmodell) und wählen Mit Vorlage anlegen. Das System legt eine neue UI-Konfiguration an, bei der Sie einer kundeneigenen Konfigurations-ID eine kundeneigene Zielkonfigurations-ID zuordnen.

Bearbeiten

Sie markieren im Bild UI-Konfigurationen verwalten eine UI-Konfiguration (z.B. eine neue, der noch kein Datenmodell zugeordnet ist) und wählen Bearbeiten. Das System öffnet den Editor für die Web-Dynpro-ABAP-Anwendungskonfiguration.
Sie wählen Ändern.
1. Auf der Registerkarte Eigenschaften ändern Sie die Beschreibung der UI-Konfiguration.
2. Um ein Datenmodell zuzuordnen, öffnen Sie die Registerkarte Anwendungsparameter, geben unter USMD_MODEL das Datenmodell ein und sichern Ihre Eingaben.
3. Auf der Registerkarte Struktur wählen Sie Zur Component-Konfiguration springen. (Dieser Absprung funktioniert nur, wenn Sie das Datenmodell zuvor zugeordnet haben.) Sie gelangen auf das in mehrere Sichten untergliederte Bild zum Bearbeiten der Component-Konfiguration (Konfiguration der OIF-Component).
Hinweis
Das Standard-Datenmodell enthält in der Auswahl der Standard-Entitätstypen den Dummy-Eintrag Muss gelöscht werden. Nach dem Anlegen des ersten Entitätstyps können Sie diesen Eintrag löschen.

Ende des Hinweises
Sie wählen Hinzufügen und im zugehörigen Kontextmenü den Eintrag Entitätstyp, z.B. wählen Sie zum Datenmodell 0G den Entitätstyp Konto (ACCOUNT) aus.
1. Sie legen den Entitätstyp an.
2. Sie löschen den Dummy-Entitätstyp (namens Muss gelöscht werden).
Um Benutzungsoberflächenbausteine für den Entitätstyp anzulegen, wählen Sie UIBB hinzufügen.

Das System öffnet einen Default-UI-Baustein (UIBB). Das System fügt pro Hauptsicht automatisch eine Vorlage für einen UIBB hinzu. Diesen unvollständigen Dummy-Eintrag müssen spätestens vor dem Sichern löschen.
1. Sie wählen Formular hinzufügen. Das System öffnet einen Bildbereich mit Details für den gerade angelegten UIBB.
  Das System bietet u.a. folgende Bausteine an:
  - Tabelle
    
    Diese Auswahl ist verfügbar, wenn der ausgewählte Entitätstyp mindestens einen enthaltenen Entitätstyp (Ablage- und Verwendungsart 4) besitzt.
  - Anlagen
    
    Mit dieser Auswahl übernimmt das System direkt die für Anlagen erforderlichen Standard-UI-Bausteine.
  - Textübersetzung
  - Hierarchiebeziehung
2. Falls Sie den nicht benötigten Default-UI-Baustein noch nicht gelöscht haben, löschen Sie in jetzt. Sichern Sie die Konfiguration.
Zum neu angelegten UI-Baustein wählen Sie UIBB konfigurieren. Sie gelangen zum Editor für die Web Dynpro ABAP Component-Konfiguration. Weitere Informationen finden Sie unter Konfigurieren der Benutzungsoberfläche eines Entitätstyps.
Sie bearbeiten die UIBB-Attribute (hier: Formularattribute) mit den Funktionen des FPMs.

Hinweis
Mit dem FPM können Sie auch Sets, Hierarchiebeziehungen und Tabellen konfigurieren (Anlagen und Textübersetzung jedoch nicht).

Ende des Hinweises
Sie wählen Sichern.