Pictures

Learn how a user can add photos taken with the device to records (e. g. to persons or products).

Note: Ensure, that the Document (D1) and Document Link (D3) tables are available on the device (i.e. included in the update.tablet configuration). An uploaded image is always linked to the current record using the Document Link (D3) table.

Online Upload

To configure that the user can upload pictures in online mode:

  1. Add the UploadImage button (included in update.tablet) to the Expand header of the desired info area, e. g. Company (FI) or Person (KP). This button has the PhotoUploadAction action call assigned by default, see PhotoUploadAction.

    You can also add a button and assign this action call.

  2. The photo upload is configured in the action template's Config input argument, see Config Input Argument.

Offline Upload

To configure that the user can also upload pictures in offline mode you need:

  1. The D1.OfflineCreateTemplate filter (included in update.tablet):


  2. The Configuration :OfflineDocumentCreation action template must be assigned to the Configuration:OfflineDocumentCreation context menu action (both configuration units exist in update.tablet), see Configuration:OfflineDocumentCreation.
  3. Define the following input arguments for the Configuration:OfflineDocumentCreation action call, see Configuration:OfflineDocumentCreation:
Input Argument Value
DocumentLinkInfoAreaId D3
DocumentTemplateFilter D1.OfflineCreateTemplate(filter included in the update.tablet configuration).

Uploading Pictures Using a Non-WLAN Connection

If pictures are uploaded using a WAN (e. g. 3G) connection, the settings of the following Web Configuration parameters are applied:

Uploading Pictures in the Quick Add

You can add photos in the quick add with the DocumentsDefinition input argument of the SerialEntry action, see SerialEntry.

Note: This option is only available in the OTC vertical.

To add this option:

  1. Switch to the desired action call that has the SerialEntry action assigned.
  2. Define the DocumentsDefinition.

Uploading Pictures to Empty Records in the Quick Add

To be able to upload photos to an empty item record:

  1. Switch to the Edit control of the field group given in the DestinationConfigName input argument, see SerialEntry.
  2. Add a dummy field and set the following Field Attributes:
    • Hide Field - optional
    • Empty Line
  3. Enter a Function name for the field. This function name and the value to be set can be given in the hasDocumentsColumnFunctionName and the hasDocumentsColumnValue input arguments, see DocumentsDefinition Input Argument (OTC/LSI/CG only). The DocumentsColumnValue is usually 1 or true, however, it depends on the given field's type.

Uploading Pictures to the Details/Edit Page

You can add a picture to your Details and Edit view, e. g. for person records.

To add a picture to the Details/Edit view:

  1. Switch to the desired control (Details/Edit) of the desired info area, e. g. Person.
  2. Add a FreeC field, e.g. FreeC1, to the desired panel. This field holds the image key.
  3. Enable the Image field attribute and - if desired - limit the image's size. The following example shows the default value applied if no JSON is given:

    {"previewWidth":"90","previewHeight":"120"}