# Text Management

## Introduction

The Text Management module provides a central text management facility in Agile e6 to control the textual data used in the system. With Text Management, it is possible to :

- Add additional text to an item position in the BOM
  Text instances can be added to an item position in a BOM. For example the text instance contains instructions for the assembly of the item.
- Add Text as a text position in the BOM
  Text instances can be added to a BOM as an individual position (without referencing an item). Typically "text as a position" is used to structure the BOM, e.g. with a text like "The component contains the following items, which have to be pre-assembled".
- Create a Glossary
  The glossary is a central management facility to manage multi-lingual terms to optimize the translation process of terms and improve the consistency of text data. The glossary will be used for example to create the (text) values for the pool of attributes for classification. Furthermore any other text attribute can reuse the term definitions in the glossary.

The central entity of the text management — the text template — is provided to define text used in the system. Text Templates have the following characteristics:

- Multi-lingual - The text in a text template is multilingual thus provides e.g. a central mechanism for localization.
- Category - Text templates are assigned to one or more categories to group them and facilitate the search for specific text.
- Placeholders - The text in a Text Template can contain placeholders which are replaced by constant values when deriving a so-called text instance.
- Glossary - Glossaries are Text Templates which do not contain any placeholders and are assigned to the standard category Glossary.

To assign a text e.g. to an item position in the BOM, a so-called Text Instances is derived. Text instances provide the mechanism for storing resolved text templates. If the text template includes placeholders, they will be replaced with a "real" value.