Auswahl eines Listenformulars 

 

Welche Transformation wird für die Darstellung von XML-Dokumenten in einem Ordner verwendet?

 

Fall 1: Dokumente aus verschiedenen Projekten

Fallbeschreibung

Ein Ordner enthält Dokumente aus verschiedenen Projekten, z. B. News und FAQs.

 

Systemverhalten

Innerhalb des gleichen Ordners werden die XML-Dokumente mit unterschiedlichen Transformationen dargestellt: News mit der RenderListItem-Transformation des News-Projekts, FAQs mit der RenderListItem-Transformation des FAQ-Projekts.

Das System entscheidet anhand des Ressourcentyps jedes Dokuments, aus welchem Projekt die Transformation verwendet wird.

Der Projektname ist Bestandteil des Ressourcentyps, den das System in die Eigenschaften jedes Dokuments schreibt. Beispielsweise erhalten XML-Dokumente, die Sie mit dem Erfassungsformular des News-Projekts anlegen, den Ressourcentyp http://sap.com/xmlns/cm/app/xmlforms/News.

Sie können den Ressourcentyp im Details-Dialog der Dokumente anzeigen (Einstellungen ® Eigenschaften ® System).

 

Fall 2: Dokumente aus verschiedenen  Projekten und eigene Formulare

Fallbeschreibung

Ein Ordner enthält Dokumente aus verschiedenen Projekten, z. B. News und FAQs.

Zusätzlich haben Sie in einem oder mehreren Projekten eigene Formulare angelegt, z. B. ein Narrow-Formular für die Darstellung in einem schmalen iView (siehe Einbinden eigener Listenformulare in iViews). Das System generiert für jedes Formular eine eigene Transformation.

 

Systemverhalten

Innerhalb des gleichen Ordners werden die XML-Dokumente mit unterschiedlichen Transformationen dargestellt.

Das System entscheidet zunächst anhand des Ressourcentyps, aus welchem Projekt eine Transformation verwendet wird (siehe Fall 1).

Anschließend entscheidet das System, welche Transformation innerhalb dieses Projekts verwendet wird. Dabei prüft das System in der folgenden Reihenfolge, ob ein Formular vorhanden ist:

 

Die untenstehenden Beispiele gehen davon aus, dass Sie im verwendeten XML-Forms-Ressourcen-Renderer im Parameter XML Forms List Renderer den Wert Narrow  angegeben haben.

 

Auswahl eines Listenformulars

Rang	Formularname	Systemverhalten	Beispiel für Formularname
1	<Parameterwert> (hundertprozentige Übereinstimmung)	Das System prüft, ob ein Formular vorhanden ist, dessen Name mit dem Wert des Parameters XML Forms Transformation im verwendeten Ressourcen-Renderer identisch ist.	Narrow
2	RenderListItem + <Parameterwert>	Das System prüft, ob ein Formular vorhanden ist, dessen Name aus der Zeichenkette “RenderListItem“ und dem Wert des Parameters XML Forms List Renderer zusammengesetzt ist.	RenderListItemNarrow
3	RenderListItem	Das System verwendet das Standard-Listenformular RenderListItem.	RenderListItem
4	kein Formular mit einem der oben genannten Namen vorhanden	Das System verwendet den Standard-Renderer. Dieser zeigt lediglich den Dokumentnamen an.

 

Beispiel

Beispiel: iView mit XML-Dokumenten aus verschiedenen Projekten

Im Projekt News haben Sie zwei Formulare für Listen angelegt: RenderListItem und Narrow.

Im Projekt FAQs haben Sie ein einziges Formular für Listen angelegt: RenderListItem.

 

In den iView-Eigenschaften haben Sie ein Layout-Set eingetragen, das einen XML-Ressourcen-Renderer mit der Transformation Narrowvorsieht.

 

Im Ordner haben Sie drei Dokumente angelegt: zwei News und eine FAQ.

 

Das System verwendet für die Darstellung der News die Transformation Narrow.

Im FAQs-Projekt ist kein Formular mit dem Namen Narrow vorhanden. Das System verwendet für die Darstellung der FAQ die Transformation RenderListItem (in der obigen Liste Fall 3).