Documentation attribute

Hi Erik,

In contrast to the Description/Definition attribute the Documentation can contain e.g.  images, hyperlinks and tables.

To specify the attribute you should consider a specific procedure (described in the Online help, Topic 'Create an external description'):

You can describe database and model items (models, objects, groups, etc.) using formatted documents or other files and save these documents in the Documentation attribute. If you are using the Microsoft® Word file formats DOC und DOCX, a preview is available and the Edit button is available. To do so, you can create the documents directly from the Documentation attribute.

Prerequisite

You are using a method filter that contains the Documentation attribute.

Procedure

1. Open the Attributes window for the item you want to assign a description to.
2. Navigate to the Documentation attribute that is not yet assigned any file.
3. Click Edit in the attribute value cell of the attribute. The word processor is run and a new document opens.
4. Finish the description and save the document. You are offered the name of the item to be described with the file extension .doc or .docx as a name for saving the document.
5. Close the word processor.
6. If necessary, click Update.

The document is added to the Documentation attribute and a preview is displayed.

Kind regards,

Dagmar

Thank you for your detailed description about the usage of the documentation attribute.

Let's assume that I have used the documentation attribute for models and objects throughout my business process.

- What business need is the attribute intendend to satisfy and how? (What is SAG's intent with the attribute)

- How have ARIS clients used the attribute in their environment?

- If intended, what is the best practice to publish content of the attribute to a wide audience? (ie. the entire organization)

/ Erik