Setting Up Image Capture or File Upload
On mobile pages, you can add the following icon page elements that provide additional capabilities to a standard or custom mobile process:
-
Capture Image Icon – Enables you to capture up to 15 images per page through your mobile device and upload it to the file cabinet.
The default image format is in JPEG, which is saved using the following default naming convention: <app name>_<state path>_<timestamp>_<filename>.jpg.
When you add this icon, you can configure the <state path> component of the format to set up a dynamic value. The <filename> component of the format follows the one you set on your mobile device.
Along with an icon, this page element also displays a list of captured and uploaded image files by default. It opens the camera app of a mobile or tablet device only. If you access the mobile process on a kiosk or desktop device, it opens your file browser or selection window.
-
Upload File Icon – Enables you to upload up to 15 image or document files per page to the file cabinet.
Along with an icon, this page element also displays a list of uploaded image and document files by default.
When you add these icons, you automatically include the image or document files during submission as you complete the mobile process flow. You can add only one of each icon on the same mobile page.
Review the following lists to verify that you can attach the files to a transaction:
-
You can attach files to the following order transactions: purchase order, sales order, transfer order, work order, work order completion, work order issue. Other supported transactions include the item fulfillment, item receipt, assembly build, return authorization, inventory count, and inventory adjustment.
By default, the app displays the list of attachments on the Mobile App Attachments subtab. Alternatively, you can choose the standard or custom field in which you want to display the image or document attachments.
-
You cannot attach the files to the following transactions: bin transfer, inbound shipment, wave, pick task, and any custom record.
The instructions in this topic apply to both Mobile Customization for custom processes and Mobile Configuration for standard processes. It begins on the Mobile – Page Element page on which you can specify the settings for a new page element. To navigate to this page, refer to the following topics:
To set up image capture or file upload:
-
On the Mobile – Page Element page, do the following:
-
In the Name field, enter a unique name for the page element.
-
In the Label field, select the label that you want to appear on the mobile page for this element.
-
In the Type field, select one of the following page element types: Capture Image Icon or Upload File Icon.
-
-
To map the target transaction to which you want to attach the image or document files, set the Record Name field.
To display an attachment in a sublist, set up the Sublist Name field instead. If you want to display it in a specific field within a record or sublist, set up the Field Name field too.
If you want to attach files to multiple transactions, set the same fields on the No Code Settings subtab. To map a new transaction, click New Mobile – No Code Settings.
For more information about these fields, see Data Capturing and Storage for Page Elements.
-
To map this page element with the transaction associated with the mobile process, do the following:
-
In the Reference Transaction Type field, enter the internal ID of the transaction.
For example, you want to add the icon to a mobile page within the PO Receiving process. Enter purchaseorder, to map the icon with the purchase order transaction.
-
In the Reference Transaction State Path field, enter the state path to the key that contains the reference transaction’s internal ID.
Example: state:datarecord:scriptParams:transactionInternalId – This state path to the transactionInternalId key stores the internal ID of purchase orders processed through PO Receiving on the app. For more information about state paths, see Accessing Data Stored in the State.
Alternatively, to assign a static value, enter the internal ID of the specific reference transaction. You may also use the keyword, constant, following by the internal ID or another static value.
-
-
(Optional) For the Capture Image Icon, to include additional details in the filename, you can set up the Image State Path field. In this field, you can enter the state path to a key that contains the additional detail.
For example, if you want to include the warehouse name in the filename, you can enter the following path in this field: state:dataRecord:auxParams:warehouse.
-
Optionally, to control the visibility of the icon on the mobile page, you can set the following additional fields: Visibility Condition or Disable Field Condition.
For detailed instructions, see Page Element Visibility and Loading.
-
Click Save.
You can perform other customizations or configurations on other pages or page elements within the mobile process.
-
To apply all your updates to the app, you can click Save and Update App for Mobile Configuration. For Mobile Customization, see Compiling Mobile Customizations.
After you update the standard or custom mobile process, you can view the icon on the app. To capture or upload files, see Capturing and Attaching Files Through the App.