Display and Styling Control

The administrator can configure how the different aspects of the standard Visual Collaboration User Interface can be displayed.

To change the Secure Message Template Style, do the following:

  1. Login to Aras Innovator as an administrator.
  2. Go to Contents --> Administration --> ItemTypes.
  3. Run the search and open a secure social enabled ItemType for edit, for example, Document.
  4. In the ItemType window, select the SecureSocial tab.
  5. Right-click the DiscussionTemplate in the Relationship grid and select SecureSocial --> Open in the context menu.
  6. In the DiscussionTemplate item tear-off window, click the DiscussionTemplateView tab.
  7. Click the ItemType ID in SM template property.
  8. Note
    Because of difference between Windows and Linux file systems it is required to use OS-specific path separator in paths. Remember that Linux file system is case sensitive so file names ./path/to/file.xml and ./path/to/File.xml are different. For more information about cross-platform development please see section 2.3 Cross-platform development in the Aras Innovator 30 - Programmer’s Guide document.

    This opens the SecureMessageViewTemplate Item tear-off window.

  9. In the Template field, for example, replace string:
  10. <div id="messageText” class="ssvc-message-text">with<div id="messageText” class="ssvc-message-text” style="color: red";">

    Note
    Comment editing is currently unsupported in modified templates. It is only supported in the default SecureMessageViewTemplate.

  11. Save, Unclaim and Close the windows.
Note
The described subsequence of steps will result in applying change in the style of displaying secure messages for all the ItemTypes from which modified item of SecureMessageViewTemplate is referenced from. In Order to apply change to items of one specific type only – new item of SecureMessageViewTemplate should be created (modified, as desired) and referenced from mentioned itemtype (DiscussionTemplate→DiscussionTemplateView→SM template […]).

The admin can set a color that is used for the vertical sidebar in the item tear-off window, as well as the vertical stripes shown on the right of all comments in the Discussion Panel. This color helps users to identify the type of item they are looking at on the screen. For standard ItemTypes the colors are set to be like the color of the ItemType’s icon (e.g., Part is set to purple).

To set the sidebar color for an ItemType, do the following:

  1. Login to Aras Innovator as an administrator.
  2. Go to Contents --> Administration --> ItemTypes.
  3. Run the search and open a secure social enabled ItemType for edit.
  4. In the ItemType window, select the Client Style tab.
  5. For standard ItemTypes a single PresentationConfiguration template with default properties is listed in the Relationship grid:

    • name
    • Color: background-color: rgb(216, 179, 124);
    • Client: JavaScript
  6. Right-click the PresentationConfiguration in the Relationship grid and select View PresentationConfiguration in the context menu.
  7. Use the following procedure to set the sidebar color for an ItemType:

  8. Login to Aras Innovator as an administrator.
  9. Go to Contents --> Administration --> ItemTypes. The menu shown in Figure 20 appears.
  10. Click Search ItemTypes. The Search Grid appears.
  11. Open a secure social enabled ItemType for editing.
  12. In the ItemType window, select the Client Style tab.
  13. Right-click an entry in the name column and select Open in the context menu. This opens the PresentationConfiguration Item tear-off window.
  14. Modify the values of the Style field.
  15. Note
    This field is in CSS format. Either RGB or RGBA syntax is acceptable.

    Example of RGB syntax: background-color: rgb(2126, 179, 124); Example of RGBA syntax: background-color: rgba(0, 116, 198, 0.6);

    Click

    and

    to save and unclaim the items.

Note
The setting for “Secondary Icon” was used prior to Aras Innovator 11 SP5 to display an inverted (reverse color) icon in the sidebar and discussion panel but starting with 11 SP5 the styling has been changed so that this icon is no longer required.

Tooltips are configurable by an administrator, by defining a parameterized string. To configure the Form tooltip text, do the following:

  1. Login to Aras Innovator as an administrator.
  2. Go to Contents --> Administration --> ItemTypes.
  3. Open the Document ItemType for editing.
  4. Select the Secure Social tab.
  5. Right-click the DiscussionTemplate and click Secure Social --> Open in the context menu.
  6. Click the DiscussionTemplateView tab.
  7. Right-click the Relationship grid and select Open from the context menu.
  8. This opens the SSVCPresentationConfiguration Item tear-off window.
  9. In the Form of Tooltip Template field, for example, replace the text from:
  10. Form of${ItemType:label} ${Item:keyed_name} to This is the form of${ItemType:label} ${Item:keyed_name}

  11. Save, Unclaim and Close the windows.

Tooltips are configurable by an administrator, by defining a parameterized string. To configure tooltip text for File Selector, do the following:

  1. Login to Aras Innovator as an administrator.
  2. Go to Contents --> Administration --> ItemTypes.
  3. Open the Document ItemType for editing.
  4. Select the Secure Social tab.
  5. Right-click the DiscussionTemplate in the Relationship grid and click Secure Social --> Open from the context menu. The DiscussionTemplate tear-off window appears.
  6. Click

    to unclaim the template.

  7. Click the FeedTemplate tab.
  8. Click the New FeedTemplate

    button in the Relationship Toolbar to add a new FileSelectorTemplate in the relationship grid.

    1. Double-click the properties in the columns to modify them as required;
    2. Filter: Input the file type ID
    3. Reference: Input the file “related_id” value
    4. Tooltip Template: Configure the Tooltip template, for example,
    5. Replace:

      File ${File:filename} from ${ItemType:label} ${Item:keyed_name}

      To:

      Test File ${File:testpdf} from ${ItemType:testssvc} ${Item:pdfdoc}

  9. Save, Unclaim and Close the windows.

Table 8 shows the configuration options and default settings. Configuration options and default settings

Type Parameterization Options Default Setting Example
3D Viewer with single file Label property of container ItemTypeAny property of the current ItemAny property of the FileFilename without extension, as a calculated value “File “ <filename_no_ext> “ from “<itemtype label> “ “ <item keyed_name> File StepStruder from CAD Document D-24811
PDF Viewer with single file Label property of container ItemTypeAny property of the current ItemAny property of the FileFilename without extension, as a calculated value “File “ <filename_no_ext> “ from “<itemtype label> “ “ <item keyed_name> File Test Plan from Document D12345
Image Viewer with single file Label property of container ItemTypeAny property of the current ItemAny property of the FileFilename without extension, as a calculated value “File “ <filename_no_ext> “ from “<itemtype label> “ “ <item keyed_name> File Image001 from Document D35135

The Visual Collaboration User Interface for an individual item tear-off window consists of a sidebar and a discussion panel. An admin can choose to display this interface for a specific ItemType, either overall or based on Identity or classification. Note that this is independent of whether the ItemType is enabled for Secure Social. An admin can configure this setting by doing the following:

  1. Login to Aras Innovator as an administrator.
  2. Go to Contents --> Administration --> ItemTypes.
  3. Open a secure social enabled ItemType, for example, Document ItemType for editing.
  4. Go to the Views tab.
  5. The Secure Social property in the relationship grid is enabled (set to 1) by default. This means that for the Default view type for a Document Item, the visual collaboration user interface is visible to an end user.

    Note
    For the remaining view types, this property is disabled (set to 0) by default.

  6. Disable this property if you need to hide the visual collaboration interface for that specific view.
  7. Save, Unclaim and close the window.