Presentation Style

Displays data in a tabular manner (one row per document). It is fairly easy to set up, and you do not really need to know HTML to use it.

Enables you to write your own FreeMarker code to format content. This template type can be customized more than the tabular form, but requires that you know FreeMarker.

Older presentation style type, primarily for backwards compatibility. We do not recommend this type for new presentations styles.

Select the appropriate subsystem.

Displays the type of presentation style.

Type a name for this tabular form presentation style.

Select the appropriate language for the form.

If you do not select a language, it is automatically set according to: a) the user language, b) the browser language, c) the domain language in the given order.

Type the height of each row (one row per document).

Select the appropriate data source for this presentation style.

The following data sources are available:

• <iKnowBase – Documents>: Regular iKnowBase documents.
• <iKnowBase – Versioned documents>: Versioned iKnowBase documents (current + old versions)

In addition to these data sources you will also have access to select all defined external data sources.

Specify whether to generate links to add new documents or not. The links is placed above the extracted documents at runtime.
Note: You need to specify which links to generate in the viewer or search source configuration (on the quick links tab on the Edit pane), and select the <Add links> attribute for this presentation style. The option is only available when using a iKnowBase Documents/Versioned documents datasource or an external datasource defined as a combined one.

The following options are available:

• Do not show Add links: Links for adding new documents are not generated.
• Show add links in edit mode: Links for adding new documents are generated if you are in the edit mode on the Oracle Portal page with a portlet which uses this presentation style. Note: This option is not applicable for iKnowBase pages.
• Show add links in show mode: Links for adding new documents are generated on iKnowBase pages and Oracle Portal pages in view mode.

Specify whether to generate icons to modify and delete documents or not.

Note: You need to select the appropriate attributes, such as <Edit> and <Delete>, for the presentation style. The option is only available when using a iKnowBase Documents/Versioned documents datasource or an external datasource defined as a combined one.

The following options are available:

• Do not show Add links: Links for modifying or deleting documents are not generated.
• Show add links in edit mode: Links for modifying or deleting documents are generated if you are in the edit mode on the Oracle Portal page with a portlet which uses this presentation style. Note: This option is not applicable for iKnowBase pages.
• Show add links in show mode: Links for modifying or deleting documents are generated on iKnowBase pages and Oracle Portal pages in view mode.

Select the check box to display the labels for the attributes that you select.

Note: You also have to specify for which attributes to display labels in the Style tab.

Select the check box to retrieve the labels from the attribute definition.

Specify whether it should be possible to sort the tabular list, either by clicking on the label or on the sort icons, or not.

If you want to use a style set to render HTML that surrounds the output from this presentation style, select the appropriate styleset here.

Type a default font class for the labels. You can change the font class for each attribute in the Style tab.

Type a default font class for the. You can change the font class for each attribute in the Style tab.

This property lists all regular attributes that are associated with the data source that you have specified for this presentation template.

Some of the attributes available from iKnowBase content store data sources are in fact special functions.

Displays the list of special functions described later in this chapter.

You can reorder the attribute list by using drag and drop in each line.

You can deselect attributes by clicking on the delete icon and save the data.

This attribute is used to displays the title field. You can specify how you want to view the attributes on the Advanced tab. You can select this attribute several times.

Displays a blank line in a free-form presentation style.

Note: Only applicable to free-form presentation styles.

Displays a blank character in a free-form presentation style.

Note: Only applicable to free-form presentation styles.

Displays any quick links in a Shared content viewer or Search source portlet.

Note: Ensure that the Show Add links property is set to show the links.

This attribute is used to create links for an attribute.

To define a link, you must specify a target page and the attribute that you want to send as a value.

This attribute is used to add HTML codes or images.

Note: Only applicable to free-form presentation styles.

This attribute is used to create a link to a form. The document that is created from the form opened from this link becomes a subdocument.

Will try to extract from the image itself this property

Will try to extract the XML_DATA column on the document and return it as a xmltype.

Retrieve as XML the image properties. The format will always start with a <ikbImageProperties> and within it will have the internal structure depending on the information on the document.

This attribute is used to call a database function. You can use this attribute when information is not directly available in the extracted document, but needs to be retrieved from the database. For example, display the author’s department where the department is not a part of the extracted document.

This attribute is divided between the following two types that can be selected from the Advanced tab:

There are two different types of functions:

• Simple functions: Functions of this type does not take any parameters. Example: dbms_random.random
• Advanced functions: Functions of this type takes parameters and must return a text value. The signature is described in Database Functions (Pres.Style:Database Function).

This attribute creates a link to form, which may be used to edit the document.

Note: Ensure that the Show Edit links property is set. To display the links, the user must have access to update the document.

This attribute opens Microsoft Word, PowerPoint, or Excel to update the file-content of the document.

Note: Ensure that the Show Edit links property must be set. To display the links, the user must have access to update the document, and the document contain a Microsoft Office document.

This attribute generates an icon or link that opens a dialog box to select a new information type.

Note: You must configure this attribute in the Advanced tab with a quick link that displays the forms for the information types that can be selected. For these forms you must ensure that the Save information type on update property is selected.

This attribute generates an icon or link to use the check-in and check-out (CICO) functionality. Note: You must activate CICO for the appropriate information types. The links will only be displayed for information objects of these types.

An information object with activated CICO will not be available for edit until the user checks it out. It will not be available for checkout if already checked out by another user.

The user is given one of the following messages:

• The document is checked out by someone else
• The document is checked out by me, and can be checked in
• The document is not checked out by anyone, and can be checked out by me

This attribute creates a link that opens a dialog box to delete the document.

Note: Ensure that the Show Edit links property is set. To display the link, the user must have access to delete the document.

This attribute displays the number of times the document is read.

Note: To enable use of this special function attribute, configure the appropriate information types to store statistics ( Statistics property).

This attribute displays a score from the Oracle text, while searching for free text. The score may be used to sort the list so that most significant documents are displayed at the top of the list.

This attribute displays an icon that can generate HTML code for the document content.

This attribute displays the level in a document structure. The usage is restricted to viewers extraction sub documents by a connect-by clause.

Displays the list of selected attributes.

Type the label that you want to display for the specific attributes.

This property will be used when you have chosen to show label for the attribute, and chosen not to use the prompt from the attribute definition.

You may use HTML codes in this field.

Note: This property doesn�t have language support. You may use labels stored in the NLS tables to achieve this. The syntax is #ObjectId.StringId#, where ObjectId is the value in the IKB_NLS_STRING.OBJECT_ID column and StringId is the value in the IKB_NLS_STRING.STRING_ID column. The NLS tables may be overwritten in case of an upgrade.

Select the appropriate alignment.

Select this check box to print the label for this attribute.

Note: Select the Show labels check box on the Main tab to make this property visible on the Style tab.

Select this check box to display the sort icons for this attribute.

Note: Select one of the sort-options for the Show sort icons property on the Main tab to make this property visible.

Type the style class for the label.

Note: When you specify a standard font for labels, this value appears as a suggestive value.

Type the style class for the value field.

Note: When you specify a standard font for values, this value appears as a suggestive value.

Type the width of the TD cell.

Select the appropriate unit for the width property. Available units are percent and pixels.

Select the appropriate sort order. This will apply to the first level (default) if running a traversing viewer.

Select the appropriate sort order on the siblings. This will only apply when running a traversing viewer.

Select whether to display or hide the title attribute.

Select this check box to display the document title itself. Rather that displaying the document title, you can display a label or image for the title attribute. For this, you must define the label or image in the Label property on the Style tab.

Select the appropriate format restriction.

• All types: The title will be displayed for documents with all content formats.
• Text: The title will be displayed only for documents with text content.
• File: The title will be displayed only for documents with file content.
• Links: The title will be displayed only for documents with link content.
• File/link: The title will be displayed for documents with file and link content.

Select the appropriate link type.

• Link: A link is always be generated for the title attribute.
• Link only if content: A link will be generated for the title attribute if the document has content (file, url, or text content)
• No Link: No link will be generated for the title attribute.

Select the appropriate option to display the document when the user clicks on the title link.

• Content: The document is displayed on the target destination in case of text-based content. Otherwise, the url or file is opened in a new browser window.
• Target: The document is displayed on the target destination.

Select the appropriate tooltip function.

You can use tooltips to preview an image or display details of a document. Tooltips are displayed when you move the mouse over the title link. The functionality for displaying tooltips are implemented by the javascript library cluetip combined with PL/SQL functions.
By default you have five function to choose from:

• Tooltip – cluetip – gist (used in search)
• Tooltip – cluetip – markup (used in search)
• Tooltip – cluetip – show preview page
• Tooltip – cluetip – snippets (used in search)
• Tooltip – cluetip – title/description

To add new functions you can write your own PL/SQL-function, add it as a database command and use it in the presentation style layer. Use e.g the function ikb_tooltip.cluetip_preview as an example.

Select whether you want to display or hide the attribute.

Select the appropriate sort order. This will apply to the first level (default) if running a traversing viewer.

Select the appropriate sort order on the siblings. This will only apply when running a traversing viewer.

By default, iKnowBase applies a default format to the item being displayed. If you want to customize this output, create a database function and use that for column formatting. Normally, you will not need to use a function.

For more information on properties of database function, see Properties.

Select the appropriate size for the image attribute. This property is available only for image attributes.

Select the attribute value to pass as parameter.

Select the text to be displayed on the link. Available options are the label for the <link> attribute or one of the attributes selected for the presentation style.

Select the target to use for the link.

Type the path of an image to use as the link. This will override Text source. The text specified in Text source will be used as tooltip for the link.

The image must be placed under the resource directory.

Select the appropriate sort order. This will apply to the first level (default) if running a traversing viewer.

Select the appropriate sort order on the siblings. This will only apply when running a traversing viewer.

Select whether to display or hide the title attribute.

Select the database function.

Select the attribute to pass as parameter to the database function. Use the option <Simple function>, if the database function takes no parameters. Otherwise select the appropriate attribute.

Note: If the function is not a simple function, it must have the signature described in <Database Functions> (Pres.Style:Database Function).

Type the path of an image. For example, /resource/image.gif. The image appears instead of the label.

Type the height of the image in pixels.

Select the appropriate quick link to use for this link/icon. Applicable to <Add subdocument> and <Change information type>.

Enter the path of the icon for an unselected ascending sort, for example /resource/icons/sortxx.png.

Enter the path of the icon for a selected (active) ascending sort, for example /resource/icons/sortxx.png.

Enter the path of the icon for an unselected descending sort, for example /resource/icons/sortxx.png.

Enter the path of the icon for a selected (active) descending sort, for example /resource/icons/sortxx.png.

Enter the path of the icon for the “check out documents” command. You can click the icon and check out a document.

Enter the path of the icon to display this status. A ToolTip displays the name of the user who checks in a document and the time of check-in.

Enter the path of the icon to display this status. You can click the icon and check in a document.

Select the appropriate subsystem.

Displays the type of presentation style.

Type a name for this tabular form presentation style.

Select the appropriate language for the form.

If you do not select a language, it is automatically set according to: a) the user language, b) the browser language, c) the domain language in the given order.

If you want to use a file-based template (not recommended), enter the file path here. The file must be available to the application server on this path.

Normally, this value will be blank.

Select the appropriate data source for this presentation style.

The following data sources are available:

• <iKnowBase – Documents>: Regular iKnowBase documents.
• <iKnowBase – Versioned documents>: Versioned iKnowBase documents (current + old versions)
• <Workflow task>: Tasks from the process engine. With this data source selected, only the task viewer portlet can use this presentation style.

In addition to these data sources you will also have access to select all defined external data sources.

Specify whether to generate links to add new documents or not. The links is placed above the extracted documents at runtime.

Note: You need to specify which links to generate in the viewer or search source configuration (on the quick links tab on the Edit pane), and select the <Add links> attribute for this presentation style.

The following options are available:

• Do not show Add links: Links for adding new documents are not generated.
• Show add links in edit mode: Links for adding new documents are generated if the user is in edit mode on the Oracle Portal page with a portlet which uses this presentation style. Note: This option is not applicable for iKnowBase pages.
• Show add links in show mode: Links for adding new documents are generated on iKnowBase pages and Oracle Portal pages in view mode.

Specify whether to generate icons to modify and delete documents or not.

Note: You need to select the appropriate attributes, such as <Edit> and <Delete>, for the presentation style.

The following options are available:

• Do not show Add links: Links for modifying or deleting documents are not generated.
• Show add links in edit mode: Links for modifying or deleting documents are generated if you are in the edit mode on the Oracle Portal page with a portlet which uses this presentation style. Note: This option is not applicable for iKnowBase pages.
• Show add links in show mode: Links for modifying or deleting documents are generated on iKnowBase pages and Oracle Portal pages in view mode.

Select the check box to retrieve the labels from the attribute definition.

Displays a globally unique identifier number for this component. This property appears after you save a component. You cannot update the information of this property.

Displays a unique identifier number for this component. This property appears after you save a component. You cannot update the information of this property.

Displays when the component was created and by whom it was created.

Displays when the component was last updated and by whom it was updated.

Displays the list of selected attributes.

Type the reference name of the attribute. If you want to identify the attribute in the template, you must provide a reference name. This reference name must be unique.

Type the label that you want to display for the specific attributes.

Note: It is recommended to use text elements rather than the Label property. This property doesn’t have language support.

Select the appropriate sort order. This will apply to the first level (default) if running a traversing viewer.

Select the appropriate sort order on the siblings. This will only apply when running a traversing viewer.

Select whether to display or hide the title attribute.

Select this check box to display the document title itself. Rather that displaying the document title, you can display a label or image for the title attribute. For this, you must define the label or image in the Label property on the Style tab.

Select the appropriate format restriction.

• All types: The title will be displayed for documents with all content formats.
• Text: The title will be displayed only for documents with text content.
• File: The title will be displayed only for documents with file content.
• Links: The title will be displayed only for documents with link content.
• File/link: The title will be displayed for documents with file and link content.

Select the appropriate link type.

• Link: A link is always be generated for the title attribute.
• Link only if content: A link will be generated for the title attribute if the document has content (file, URL, or text content)
• No Link: No link will be generated for the title attribute.

Select the appropriate option to display the document when the user clicks on the title link.

• Content: The document is displayed on the target destination in case of text-based content. Otherwise, the URL or file is opened in a new browser window.
• Target: The document is displayed on the target destination.

Select the appropriate tooltip function.

You can use the tooltip to preview an image or display the details of a document.

New tooltip functions may be implemented as PL/SQL functions. Have a look at IKB_TOOLTIP.SHOW_ADVANCED_TOOLTIP_INGRESS as an example implementation. Register the new functions in the database table IKB_TOOLTIP_FUNCTION to make them available in the dropdown box.

Select whether you want to display or hide the attribute.

Select the appropriate sort order. This will apply to the first level (default) if running a traversing viewer.

Select the appropriate sort order on the siblings. This will only apply when running a traversing viewer.

By default, iKnowBase applies a default format to the item being displayed. If you want to customize this output, create a database function and use that for column formatting. Normally, you will not need to use a function.

For more information on properties of database function, see Properties.

Select the appropriate size for the image attribute. This property is available only for image attributes.

Select the attribute value to pass as parameter.

Select the text to be displayed on the link. Available options are the label for the <link> attribute or one of the attributes selected for the presentation style.

Select the target to use for the link.

Type the path of an image to as the link. This will override Text source. The text specified in Text source will be used as tooltip for the link.

The image must be placed under the resource directory.

Select the appropriate sort order. This will apply to the first level (default) if running a traversing viewer.

Select the appropriate sort order on the siblings. This will only apply when running a traversing viewer.

Select whether to display or hide the title attribute.

Select the database function.

Select the attribute to pass as parameter to the database function. Use the option <Simple function>, if the database function takes no parameters. Otherwise select the appropriate attribute.

Note: If the function is not a simple function, it must have the signature described in <Database Functions> (Pres.Style:Database Function).

Type the path of an image. For example, /resource/image.gif. The image appears instead of the label.

Type the height of the image in pixels.

Select the appropriate quick link to use for this link/icon. Applicable to <Add subdocument> and <Change information type>.

Type the FreeMarker template code.

A list of available attributes and their IDs available for use in the HTML template code.

Enter the path of the icon for an unselected ascending sort, for example /resource/icons/sortxx.png.

Enter the path of the icon for a selected (active) ascending sort, for example /resource/icons/sortxx.png.

Enter the path of the icon for an unselected descending sort, for example /resource/icons/sortxx.png.

Enter the path of the icon for a selected (active) descending sort, for example /resource/icons/sortxx.png.

Enter the path of the icon for the �check out documents" command. You can click the icon and check out a document.

Enter the path of the icon to display this status. A ToolTip displays the name of the user who checks in a document and the time of check-in.

Enter the path of the icon to display this status. You can click the icon and check in a document.

Type an identifier for the label.

Type the text labels that you want to use in the template. If multiple languages are supported in the solution, clicking on the text box will display one text box per language, for easy editing.