Associating Images, Icons, Comments and NLS Names to Concepts and Attributes

You can associate an image with a concept you want to publish. This image will be displayed in the Parameters dialog box at instantiation. Note that you can associate an image and/or a comment to every concept attribute.

This task shows you how to:

Create a Zip Folder and Save an Image
Create a Resource Table
Create the CATRsc File
Create the CATNls File

Before you begin:

Note: The following image formats are supported: RGB, PICTURE, JPEG, BMP, and PNG.

Create a Zip Folder and Save an Image

You must save the image you want to be displayed in the instantiation tab in a Zip folder before associating it to the template.

Select Add > Content.
The New dialog box appears.
Expand the Know-how Apps Package node, and select Know-how Apps Resources.
From the Manage Content section, click Import Directory and click the node in the tree.
The Folder Chooser dialog box opens.
Navigate to the directory containing your image and click OK.
The folder is displayed below the zip name in the tree as well as the image it contains.
Select Share > Save > Save with Options.

The image is saved in the Zip file.

Create a Resource Table

After creating the zip folder, you must create a resource table and save the new zip in this table.

From the Compass, click 3D Modeling Apps , and select 3D Templates Capture.
Click Resource table .
The Resource table management tab opens.
Click Add a new resource item.
Give a logical name to the new resource item and select PLM Directory in the Resource Type scrolling list.
Double-click the Resource field.
The Select a PLM Directory for item xxx tab appears.
Click the From Search tab, enter the Zip name, and click Search.
The zip file appears in the list.
Double-click the zip and click OK.

The Resource table is created.

Create the CATRsc File

The CATRsc file is required to display the image at instantiation.

Note: The CATRsc file must be called KBEConcept_ConceptName.CATRsc to be associated with a concept called ConceptName, the file name is case sensitive. It allows associating icons to concepts attributes and representations (3D or Images) to concepts attributes and concepts themselves.

In a Text Editor, enter:
```
MyTable.Rep="MyZip|Table.png"; /*MyZip is the name in the resource table. MyTable is the concept name*/
MyTable.tableHeight.Rep="Rep3D"; /*Name of a 3D Representation*/
MyTable.tableHeight.Icon="I_KBETemplate"; /*Icon name*/
```
Note: In the example above, the following line associates Table.png in the "MyZip" zip ("MyZip" being the logical name of the zip in the resource table of the current Know-how Apps component) with the MyTable concept itself. The image appears when selecting a concept in the Library as well as when no specific Image is associated with the attributes of the concepts.

if no zip logical name is specified, the picture will be searched for automatically in the resource container of the current Know-how Apps component.

The second line associates the 3D representation with the logical name Rep3D in the resource table of the current Know-how Apps component to the attribute Attr1 of the current concept. This representation will be displayed when a value is required for this attribute.

The last line of the CATRsc file associates the Icon I_KBETemplate (contained in the current zip). The icon will be displayed when a value is required for this attribute.
Save your file.
Double-click the zip file you created and click Import Files .
The Files Chooser opens.
Select the file you just created and click Open.
The file is added to the zip.

Create the CATNls File

The CATNls file is required to display the comments associated with the attributes.

Note: The CATNls file is required to display the comments associated with the attributes. It must be encoded in UTF-8. In a text editor, enter: <meta charset="UTF-8"/>.

In a Text Editor, enter:
```
MyTable.Comment="This is a table"; /*MyTable is the concept name*/
tableHeight.Comment="Enter the table height. Value must be below 150cm";
tableHeight="TableHeight";
```
Note: In the example above, the CATNls file must be called KBEConcept_ConceptName.CATNls to be associated with a Concept called ConceptName, the file name is case sensitive. It allows associating Comments and NLS Names to Concepts and Concepts Attributes.
The first line associates a comment to the MyTable concept. This comment will be displayed when selecting a concept in a library as well as when the attributes do not have a specific Comment.

The second line associates a Comment to the tableHeight attribute in the MyTable concept. This comment will be displayed at instantiation time when the user is asked to valuate the attribute.

The last line will associate a NLS name to the tableHeight attribute. This name can contain spaces and will be displayed when the user is asked for a value on this attribute instead of the name defined in the library.
Save your file.
Double-click the zip file you created and click Import Files .
The Files Chooser opens.
Select the file you just created and click Open.
The file is added to the zip.