Attribute Editor v8.0

Editing Text

Once a text attribute is opened for editing, the main panel will display the content of that attribute for editing, in the current language. Where the attribute also exists in a master language, the top of the editing area will display the value of the attribute in that language for reference. This master language display is not editable and can be collapsed.

The OK, Save and Cancel buttons allow you to save or reject any changes you have made. OK will save the attribute value and close the editor. Save will save the attribute value but leave the editor open for further editing. Cancel will discard all changes made and close the editor.

Undo/Redo

When edits are made to the attribute the Undo button will activate to show that one or more undo actions are available. Repeatedly clicking undo will progressively remove changes from the attribute. Once the Undo option has been used, Redo will become available allowing the user to re-apply changes previously undone with the Undo option.

• Undo changes
• Redo previously undone changes

Copy/Paste

The Copy and Paste buttons provide similar functionality to the browser copy and paste (CTRL/CMD + C, CTRL/CMD + V), except that they interact with the AMI clipboard. Selecting a section of text and clicking Copy will copy that text to the AMI clipboard, which will be visible if your current AMI Workspace has the Clipboard Gadget displayed.

The Paste button will become enabled when the current AMI clipboard page contains an item of text. Since the clipboard is also capable of containing various items such as objects and table rows/columns, not all contents will enable the Paste button. However, as well as snippets of text certain copied items like Attributes and Asset References can be pasted in to the attribute editor to create an Attribute or Asset Reference in the text.

• Copy current selection to AMI clipboard
• Paste current entry on AMI clipboard in to the attribute editor

Unlike the standard browser copy and paste functions, the Copy and Paste buttons also retain the full information of the copied area - that is to say any Asset References, Attribute References, Glossary Terms, etc. are copied in their full form. Pasting these previously copied areas of text will recreate those references, etc. exactly as they were in the original case.

Using your web browser's copy and paste functions will not retain this information, instead only copying or pasting the text itself and not any of the additional markup. Also, pasting from external sources (copied text from other websites, Microsoft Word, etc.) using the browser's paste function will only paste the text and not any markup which may have been in the original text (headings, text formatting, etc.). This is to maintain the integrity of the text value within AMI and avoid unexpected formatting which Agility does not recognise.

Formatting Options

The formatting options will only be available for text attribute definitions which have the "formatted" option selected.

Paragraph

Applies the selected style to the entire paragraph that the cursor is currently in. Only one paragraph style can be applied to a paragraph.

Character

Applies the selected style to the current selection. Only one character style can be applied to an area of text.

Override

Applies the selected style to the current selection. Only one override style can be applied to an area of text.

Remove Styles

After prompting for confirmation, this will remove all styles from the text.

Edit as Control Attribute

This feature allows you to edit the text as a simple table, using Column and Row Delimiters to separate the text into cells. Control Attributes are a very specialised form of text attribute.

• Edit the attribute value as a control attribute

On clicking the Edit as Control Attribute button the top area of the editor displays the table, whilst the bottom area displays the actual text value of the text attribute.

In the control area of the editor it is possible to set the characters to be used as the Column Delimiter (the character at which a new column will be created) and the Row Delimiter (the character at which a new row will be created). These characters can also be chosen from the available glossary terms by clicking the appropriate Char button.

Columns and rows can be added to the attribute using the Add Column and Add Row buttons. This will insert text with the appropriate delimiters you have already set and some default text which can then be edited. In the top area of the editor individual cells can be selected with the mouse and moved using the move buttons. They can also be deleted by clicking the cross which is displayed when hovering over each cell.

• Move the selected cell to the far left
• Move the selected cell to the left one cell
• Move the selected cell to the right one cell
• Move the selected cell to the far right

Clicking the Edit as Control Attribute button again will close the top cell editor panel and controls whilst retaining any text changes which have been made.

Options Menu

The options menu contains several functions for adding complex references and characters to the attribute. They can also be configured to appear instead as icons in the editor's toolbar.

Insert Fraction...

Displays a dialog for entering the numerator and denominator of a fraction. On clicking OK the fraction will be inserted in to the attribute at the cursor's current location.

Double clicking a fraction in the text editor will open the dialog again for editing of the values.

Insert Hyperlink...

Displays a dialog for entering a URL and either text or an Agility asset relation to create a hyperlink in the attribute value. Entering text is straightforward and if no text is entered then the URL will be displayed as text instead. If you choose an Asset hyperlink then clicking Next takes you to the dialog for selecting the asset relation which is to be shown in the hyperlink.

On clicking OK the hyperlink will be inserted in to the attribute at the cursor's current location.

Double clicking a hyperlink in the text editor will open the dialog again for editing of the values.

Glossary Term...

Allows the insertion of one of the Agility glossary terms in to the attribute value.

On clicking OK the glossary term will be inserted in to the attribute at the cursor's current location.

Double clicking a glossary term in the text editor will open the dialog again for editing of the value.

Attribute Reference...

This feature is only enabled when an attribute reference is on the AMI clipboard, i.e. at some point an attribute was copied to the clipboard.

The dialog displays the current AMI clipboard, allowing you to move left and right through the clipboard pages to select the attribute to be pasted. Only attributes will be displayed. Other clipboard pages not containing attributes will display a message to highlight the fact that the clipboard page does not contains attributes.

To select an attribute for pasting check the checkbox next to the value and click OK. In the case of language-dependent attributes the attribute can be expanded to show the available languages, allowing a particular language value to be selected. Multiple values can be selected to be inserted at the same time

Double clicking an attribute reference in the text editor will open the dialog again for editing of the value.

Price Reference...

A dialog is displayed for selection of the object that the price reference will be associated with. The object can be entered either by typing the ID in to the relevant field, entering the Name in the relevant field, or selecting an object from the browser.

The Price Type and Price Style options are presented at the bottom of the dialog.

On clicking OK the price reference will be inserted in to the attribute at the cursor's current location, using the selections you made in the dialog.

Double clicking a price reference in the text editor will open the dialog again for editing of the value.

Asset Reference...

A dialog is displayed for selection of the object that the asset reference will be associated with. The object can be entered either by typing the ID in to the relevant field, entering the Name in the relevant field, or selecting an object from the browser.

Clicking Next displays a list of relations on the object selected. The "Show:" selector allows you to choose to display only Linked Assets (those relations which already have an asset associated with them), All Relations, or the relations in the Default Design for this object. One or more asset relations can be selected, and in the case of language-dependent relations the relation can be expanded to show specific languages for selection.

On clicking OK the asset reference will be inserted in to the attribute at the cursor's current location, using the selections you made in the dialogs.

Double clicking an asset reference in the text editor will open the dialog again for editing of the value.

Smart Attribute...

Smart attributes (alternatively known as publishing blocks) displays a dialog for selection of the object that the smart attribute will be associated with. The object can be entered either by typing the ID in to the relevant field, entering the Name in the relevant field, or selecting an object from the browser.

Clicking Next displays a list of smart attributes on the object selected. The "Show:" selector allows you to choose to display only Linked Smart Attributes (those smart attributes which are listed in any of the Design Objects for the object's publication properties), All Smart Attributes, or the smart attributes in the Default Design for this object (again, taken from the object's publication properties). One or more smart attributes can be selected.

On clicking OK the smart attribute will be inserted in to the attribute at the cursor's current location, using the selections you made in the dialogs.

Double clicking a smart attribute in the text editor will open the dialog again for editing of the value.

Page Number Reference...

This feature is only enabled when a Page Number Attribute has been configured for the current workspace. If the option is unavailable then contact your system administrator to enable the feature.

A dialog is displayed for selection of the object that the page number reference will be associated with. The object can be entered either by typing the ID in to the relevant field, entering the Name in the relevant field, or selecting an object from the browser.

On clicking OK the page number reference for the selected object will be inserted in to the attribute at the cursor's current location.

Double clicking a page number reference in the text editor will open the dialog again for editing of the value.