Working Through Configuration Steps for New Web Forms

You must work through several configuration steps in the Knowledge Management (KM) configuration to be able to use new Web forms with the Web Page Composer.

Procedure

1. Create Resource Types

You require a separate resource type in KM for each new Web form.

In the portal, navigate to System Administration System Configuration Knowledge Management Content Management Global Services Resource Types Resource Types .
Create a separate resource type for the Web form.
- Enter values for the Name and Resource Type ID parameters.
  
  Note
  Enter the same information in both parameters.
  
  End of the note.
- Activate the Reserved for Application parameter so that the resource type can only be used for Web Page Composer purposes.
- If you are using a bundle file, enter this in the Bundle File parameter.
- Optional: Specify the image to be used as a symbol for the resource type.
  You can optionally specify an image to be used as an icon for your Web form in the page container and for the corresponding content template. To do this, specify the file name and, if necessary, the subfolder name, for example, <myicon>.gif or <subfolder>/<myicon>.gif in the Icon parameter.
  
  Note
  The file must be stored in the folder /etc/public/mimes/images or in a subfolder thereof.
  
  End of the note.

For more information, see Resource Types.

2. Create a Web Resource Type

To assign the resource type, you require a separate Web resource type in the configuration of the Web Page Composer.

In the portal, navigate to System Administration System Configuration Knowledge Management Content Management Web Page Composer Web Content Types Web Resource Type.

To create the Web resource type for the page with predefined values, search for the wpc_webarticle instance, select it, and choose Duplicate.

Make sure that the following values are entered in the following parameters:

Parameter Values for the Web Resource Type
Parameter	Value
Name	Change the name. Use the name of the resource type used in the previous step.
Resource Type	Specifies the assigned resource type. Choose the resource type that you just created for the Web form.
Description	Description of the resource type
Factory implementation	Specifies the factory implementation required to create instances of this Web resource type. You must use `com.sap.nw.pcc.kmfacade.factory.XMLDocumentBaseFactory` for all resource types that rely on the default rendering mechanism (Web resource types that are based on an XML definition and use XSL transformation). Therefore, do not change the value in this parameter, unless you use a custom rendering mechanism.
Renderpath	Enter the complete ID of the Web content template iView of the new Web content type. For more information, see: Creating iViews for New Web Forms.

3. Reference the XSL File in the Stylesheet Object

In the portal, navigate to System Administration System Configuration Knowledge Management Content Management Web Page Composer Editor Stylesheets StyleSheets Document Styles .

Choose New to create a new stylesheet object and specify the path to the XSL file and other parameters.

Parameters for a Stylesheet Object
Parameter	Required	Description
Name	Yes	Name of the configuration object
Bundle File	No	Specifies the bundle file in which the key and label for the object are stored.
Key for Description	No	Specifies the corresponding key for the label containing the description of the object. The key is stored in the bundle file.
XSL Location	No	Specifies the XSL file including the path. The XSL files have to be stored in a subdirectory of the `/etc` repository.

4. Create a Stylesheet Group

For technical reasons, the stylesheet object must be entered in a stylesheet group.

In the portal, navigate to System Administration System Configuration Knowledge Management Content Management Web Page Composer Editor Stylesheets StyleSheet groups Document Style Groups .

Choose New to create a new stylesheet group and choose the stylesheet object that you have just created. Specify the other parameters.

Parameters for a Stylesheet Group
Parameter	Required	Description
Name	Yes	Name of the configuration object
Styles	No	Specifies the stylesheet objects that are used in this group. Enter the stylesheet object from the previous step here.
Description	No	Description of the configuration object

6. Reference the XML File in the Document Type

In addition to the XSL file, you must also reference the XML file that describes the new Web form. Create a new document type for the Web form and specify the path to the XML file.

In the portal, navigate to System AdministrationSystem ConfigurationKnowledge ManagementContent Management, choose Web Page Composer Editor Document Types Document Types .

Choose New to create a new document type and choose the stylesheet group that you just created. Specify the other parameters.

Parameters for a Document Type
Parameter	Required	Description
Name	Yes	Technical name of the Web resource type
Default style	Yes	Specifies the stylesheet that is to be used for displaying all objects created using this Web form. Select the stylesheet object that you just created.
Resource Type	Yes	Specifies the resource type assigned to each object created using this Web form. Select the resource type that you just created.
Style Group	Yes	Specifies the stylesheet group to be used. This group contains the stylesheets that can be used to display objects created using this Web form. Select the stylesheet group that you just created.
Bundle File	No	Specifies the bundle file in which the key and label for the object are stored.
Key for Description	No	Specifies the corresponding key for the label containing the description of the object. The key is stored in the bundle file.
XML Location	No	Specifies the XML file including the path. The XML files are to be stored in a subdirectory of the `/etc` repository.

More Information

Using Bundle Files for Multilingual Texts