placeholder Command:  ARTICLE IMAGES 


Short version Long version Changes Example

Mandatory: no
max. Occurrence:  unbounded
Description:
This tag is used as container for commands regarding the assignment of images to articles/items.
The assigned image files can be used for Pictogramm- and Preset-Buttons of TOUCH-Scales to be displayed on article-buttons.
It's also possible to use the assigned images for advertisement on the customer display (1/4 VGA and Fullscreen) or on the operator display to show operator informations.
With version 1.22.0 and higher it is also possible to assign images used for printout.
 
Mandatory: yes
max. Occurrence:  unbounded
Supported modes: delete Delete the named item.
deleteall Delete all items.
read Read the named item.
read+ Read the following item.
read- Read the previous item.
readall Read all items from the desired device(s). This doesn't mean comparable reading as in the L2 protocol.
write Write the named item.
Description:
This command is used for assigning, manipulating or deleting an Image File-Name to an article.
Notes:
The modes 'read+', 'read-' and 'deleteall' are supported with version 1.28.0 and higher.

For the mode 'readall' the following information can be helpful:
The table below shows values for the mandatory elements.
<department_no> <plu_no> Comment
0 0 The assigned article image name of all articles/items over all departments will be returned.
0 unequal 0 The assigned article image name of the article/item whose plu number is greater or equal than the value <plu_no> over all departments will be returned.
unequal 0 0 The assigned article image name of all articles/items belonging to the department <department_no> will be returned.
unequal 0 unequal 0 The assigned article image name of all articles/items whose plu number is greater or equal than the value <plu_no> belonging to the department <department_no> will be returned.

For the mode 'deleteall' the following information can be helpful:
The table below shows values for the mandatory elements.
<department_no> <plu_no> Comment
0 0 All article images/items of all articles in all departments will be deleted.
0 unequal 0 All article images/items whose plu number is greater or equal than the value <plu_no> over all departments will be deleted.
unequal 0 0 All article images/items of all plu that are belonging to the desired department <department_no> will be deleted.
unequal 0 unequal 0 All article images/items that are belonging to the desired plu <plu_no> and department <department_no> will be deleted.

   
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
The number of the department the article/item belongs to.
   
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: 1 - 999 999
Nillable: no
Description:
The number of the article/item.
Notes:
The plus hand, minus hand and enter unit price operations are treated like normal plu's.
By default (described in the file customer.ini) the article number 999 999 is used as plus hand, the article number 999 998 as minus hand and the article number 999 997 as enter unit price. The article number can be changed in the file customer.ini.
   
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 1 - 10
Nillable: no
Description:
It enables to assign more than one image to an article/item.
Starting with UC3-Application version 1.2.0 its possible to assign 3 images to each article to be used for a Touch-Button and for Display-Advertisment if this article is selected from an operator.
default image_no assigned with customer.ini parameter Description
1 Touch button not available This BMP-Files is used for Touch-Buttons for this article
2 article selected nArticleImage 1 No This image is shown on the customer display after this article is selected
3 article booked nArticleImage 2 No This image is shown on the customer display after this article is booked

The value for the <image_no> for nArticleImag1No and nArticleImage2No can be changed in the customer.ini in the range 2 to 10.
Both images must be enabled with th customer.ini parameters bEnableArticleImage1 and bEnableArticleImage2 (default value is 0 -> disabled).
Notes:
If more than one image shall be assigned to an article/item it is necessary that this number is unique.
If this tag is missing then it will be set to 1 by the device -> Image for a Touch-Button (backwards compatibility).
   
Mandatory: yes
max. Occurrence: 1
Datatype: string
Range: -
Nillable: no
Description:
Defines for which type of destination the image shall be used.

The following values are supported:
Value Description
display The image shall be used on display.
printer The image shall be used for printout.
Please, keep in mind that images for printout should be black/white images.

Notes:
This tag is supported with version 1.22.0 and higher.
If this element is missing the image type is 'display'.
This is for reasons of backward compatibility.
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: max. 100 characters
Nillable: no
Description:
The name of the image file.
   
Mandatory: no
max. Occurrence: 1
Datatype: dateTime
Range: -
Nillable: yes
Description:
The last time when the record was changed.
CCYY-MM-DDThh:mm:ss
The format is as following:
C = Century
Y = Year
M = Month
D = Day
T = Separator between date and time
h = hour
m = minute
s = second