Image Lists define the options that are available to the User in Image Selection Fields. This Field type cycles through different values when the User clicks on the image and each of the images has an associated value that is then stored against the Field. An example would be to use an Image Selection Field to set a value for confidence using custom images for the values Low, Medium and High.
Once an Image List has been created it will be stored globally which means that you will be able to choose these selection options for multiple Fields across multiple Apps.
Accessing the Image Lists
To access the Image List area, first select Settings from the COGS Menu and then select the 'Image Lists' folder in the left pane menu.
To edit the options in an existing Image List click on the row from the List of all existing items. To create a new Image List, click on the '+' icon next to Selection in the left pan menu. If it is a new Image List then you will need to add an Identifier and a Name.
Identifier: This is a value so that the system has a unique reference to the Selection Options you are creating.
Name: The name is how you will recognise the Image List for selection when assigning it to an Image List Field.
Adding the Selection Options
On the Image List edit page you will be able to choose what values to appear for the Field that it is assigned to. Click on 'Add an item' and for each option that you add to the Image List, you will need to enter four values.
Title: This is the friendly name for the option that will be shown to the User when hover over the image on the input screen. It may also be used in Reporting as the friendly name for the selection made
Value: The value is what is stored against the Field in the database when the Image has been selected.
Note: In our example here, the User has scored the confidence on a scale of 1 to 3 but the Title for each option is the friendly name of Low, Medium & High.
Note: Please also note that while the value of a particular image may be numeric, the value stored is a text value, so if you need to use this value in an expression then you need to convert it to a number within the expression, e.g.
IF(Int([Confidence]) >=2, 'Great', 'Bad')
Image: Now set the image that is going to be displayed that represents the value. You have the option of selecting from one of the Images that you have uploaded to the Image List Assets folder or you can upload a new Image here by clicking on the import icon and then using drag and drop or choose file. Once uploaded click the tick at the top right of the add image pane to confirm selection of the Image that you have uploaded.
Display Order: The display order is the order that the selection options appear in. If no Display Order has been set then the options will display in the order that they were added. To specify a Display Order assign each selection option a numeric value. They will display first to last in the selection based on lowest number first.
You can toggle between the edit and done view of the Selection Option by clicking on the row to open the edit mode and clicking on done to close the edit mode. If you want to remove a selection item then this can be done by clicking on the cross on the right of the selection option.
Once you are happy with the Selection Options that you have added click on the tick icon at the top right of the screen to save the Image List.
Adding the Image List to a Field
Having created the Selection Options, these can now be assigned to a Field. For the Field Type ImageList, it will let you choose from the list of globally stored selection options. After choosing the correct Image List for the Field, you can then specify the size that it should appear with the options of Small, Medium and Large.
You also have the option of defining the Image List at this point by clicking on the edit icon to the right of selection options. It will pop open a pane with the option to choose an Image List to update or create a new Image List.
To add an image in this screen you must first upload it in the area above the Image List Options and then choose it for the option. Once you have made the changes that you want click the tick in the top right to confirm and assign that Select List to the Field.