Designer Guide

Back Next

Creating Links to Documentation Files

You can create links in repository objects to documentation files. Click these links in the Properties or Edit dialog box of each object to view the business documentation.

The links must be a valid URL or file path to reference a business document. Use either of the following formats:

Root variable.
Use the string “file://$docroot” to refer to the documentation root you have specified in the documentation path field.

For example, if a document root is http://internal.company.com/doc, the Designer points to http://internal.company.com/doc/finance/vendors_help.html, but displays file://$docroot as part of the link.

Complete file path or link.
Precede the file path with ://, such as file://c:\doc\help\ or http://internal.company.com/doc/help/. A file path must be preceded by file:// to be valid.

To create a link, edit the properties of the object. How you do this depends on the type of object you want to document.

The following table summarizes how to create a link for repository objects:

Repository Object	How to Create Documentation Links
Table/Transformation	Double-click the table/transformation in the workspace to open it. Enter the documentation link in the Description window.
Mapping/Mapplet	Open the mapping/mapplet in the workspace. Click Mappings > Edit or Mapplets > Edit. Enter the documentation link in the comment field.
Business Component Directory	Select the business component directory in the Navigator. Click Repository > Business Component > Edit Properties. Enter the documentation link in the comment field.

To add comments to individual business components, edit the properties of the original object it references.

Rename Saved Search

Table of Contents

Designer Guide

Designer Guide

Creating Links to Documentation Files

Creating Links to Documentation Files