Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added link to the Attribute Reference screen


Info

Information valid for from AMI version 8.0 initial release


Summary

The layout of the attribute editor will differ depending on the data type of the attribute being edited. Text For example, text attributes are displayed in the text attribute editor but numeric attributes are displayed in a much simpler editor.

Certain options in the text attribute editor will only be available if the attribute's definition itself supports them; for example, text formatting options will only be displayed for attribute definitions which have the "formatted" option set.


Table of Contents
maxLevel2



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 since the last save 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 Image Added Undo changes
  • Redo Image Added 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 displayedgadget.

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 Image Added Copy current selection to AMI clipboard
  • Paste Image Added 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 may not recognise.

Formatting Options

The These 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

Image Added Remove Styles

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

Image AddedEdit as Control Attribute

This feature allows you to edit the text as if it was 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 Select the Edit as Control Attribute button to display the attribute in table form in 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 Term 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 cross Image Added displayed when hovering over each cell.

  • Move Image Added Move the selected cell to the far left
  • Move Image Added Move the selected cell to the left one cell
  • Move Image Added Move the selected cell to the right one cell
  • Move Image Added 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

Image Added Insert Fraction...

Displays a dialog for entering the numerator and denominator of a fraction. On clicking Select OK to insert 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 -click a fraction to edit its values.

Insert

Image Added 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 selecting Next takes you to the dialog for selecting the asset relation which is to be shown in the hyperlink.

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

Double clicking a hyperlink in the text editor will open the dialog again for editing of the -click a hyperlink to edit its values.

Glossary

Image Added Glossary Term...

Allows the insertion of one of the you to insert an Agility glossary terms in to into the attribute's value.On clicking OK the glossary term will be inserted in to the attribute

You can Filter the list of glossary terms. The value is applied as a 'contains' filter.

Select Image Added or double-click a glossary term it insert it 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

Image Added Attribute Reference...

Allows you to insert references to other attribute instances. This feature is only enabled when an at least one attribute reference instance 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 instance to be pasted. Only attributes attribute instances will be displayed. Other Any clipboard pages not containing attributes will display a message to highlight the fact that the clipboard page does not contains attributesthat do not contain attribute instances will not be displayed.

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

Double clicking -click 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 to edit its values. See Attribute Editor screen for more information.

Image Added Price Reference...

Allows you to insert a reference to a price in the attribute's value.

Select the object that the price reference will be associated with. The object can be entered selected either by typing the ID in to the relevant field, by entering the Name in the relevant field, or by selecting an object from the browser.

The Select 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  for the reference from the dropdown lists. (The Price List selected in AMI is used to resolve the reference.)

Select OK to insert the price reference at the cursor's current location, using the selections you made in the dialog.

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

Asset

to edit its values.

Image Added Asset Reference...

A dialog is displayed for selection of the object that the asset reference will be associated with. The object can be entered Allows you to insert a reference to an asset related to an object. 

Select the object either by typing the ID in to the relevant field, by entering the Name in the relevant field, or by selecting an object from the browser.

Clicking Next displays a list of relations on the object selected. The "Show:" Select Next to choose an asset relation available to the selected object. The Show selector allows you to choose to display only Linked Assets (those relations which already have an asset associated with them for the current object), 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 selectionselect specific language versions.

On clicking Select OK to insert 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 -click an asset reference in the text editor will open the dialog again for editing of the to edit its value.

Smart

Image Added Smart Attribute...

Smart attributes attribute (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 allows you to add a reference to a smart attribute script. Select the object instance to be used as the base context for the script either by typing the ID in to the relevant field, by entering the Name in the relevant field, or by selecting an object from the browser.

Clicking Click Next displays to select a list of smart attributes on the object selectedsmart attribute definition. The "Show:" selector  selector allows you to choose to display only Linked Smart Attributes (those smart attributes which are listed in any of the Design Objects 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 Select OK the smart attribute will be inserted in to the  to insert the smart attribute at the cursor's current location, using the selections you made in the dialogs.

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

Page

reference to edit its values.

Image Added Page Number Reference...

Allows you to insert a reference to the lowest page number on which an object appears. This feature is only enabled when a Page Number Attribute has been configured for in 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 parameters.

Select the object for the page number reference will be associated with. The object can be entered , either by typing the ID in to the relevant field, by entering the Name in the relevant field, or by selecting an object from the browser.

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

Double clicking -click a page number reference in the text editor will open the dialog again for editing of the to edit its value.