Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
General
It can be useful for the Warehouse worker to view an Image of the Item to handle
 


Note
titleBefore you proceed, check your NAV Object version

Minimum version 4.03:Perform only Steps 1, 2, 3

Before version 4.03: Please upgrade your obejcts. Else you must perform all steps and modify object code manually

Description

It is useful to view an image of the item to handle, so Mobile can display images.

These functions can display images

  • Locate Item (Thumbnail)Item 
    • Show Image (Full view)

  • Order Lines (Thumbnail)
    • Show Image (Full view)
  • Any custom List
Prerequisites
Mobile WMS for Android App

Requirements

Step 1 - Import
  • Minimum mobile app version 1.3.0 or newer
  • AND the application.cfg on the scanners contains "listConfiguration" with images i.e.:
      <listConfiguration id="LookupWithImages">. 
  • If both these are not meet, contact Tasklet Factory.
Supported NAV versions
*Note that you may need to download the newest Tasklet objects from Tasklet University that include the new CodeUnits.
  • NAV 2013
  • NAV 2015
  • NAV 2016
  • NAV 2017
  • NAV 2018
Please note
  • Images are cached by the app to reduced bandwidth requirements
    • But still, do keep in mind the image file size
Steps to perform
  1. Import images in Items
  2. Import NAV objects
  3. Enable in NAV code
  4. Configure the Mobile App (Optional)
  • Minimum NAV 2013

Keep image size down

  • Images are cached by the app to reduced bandwidth but large images will take longer to download. Keep image size down.


Overview

Table of Contents
maxLevel2
minLevel2
excludeDescription


Step 1 - Set "Max Message Size" for Web Service

On the servier tier administration, SOAP tab.

You must set this property to the highest possible size of image. 5120 = 5 megabyte.

Warning: Failing to increase this value, will result in images not being stored in NAV.

Image Added


Step 2 - Import images in Items

Import Picture on the relevant Items.

Image Modified


Step

2

3 - Configure the Mobile App to show Images for desired functions

Ask Tasklet perform this step for you. See Raise a Service Desk Ticket


Modify all Planned pages to use to use the "WithImages" listes.

  • Example: "OrderLinesWithImages" is used instead of "OrderLines"

Pick

Image Added

Put-away

Image Added

Receive
Image Added



Note
titleBefore you proceed: Check your NAV Object version

The following steps are only needed if you are using older NAV objects then version 4.03

Step 3 - Import NAV objects

The following two objects will be create

  • Codeunit 6181391 - MOB WMS Media
  • Codeunit 50011- RunMe Setup MOB WMS Media

  1. Re-Compile the object (Important)
  2. Run the object "RunMe Setup MOB WMS Media"
    1. This will set up Image support, by creating a Mobile Document Type called "GetMedia" pointing to Codeunit 6181391

Step

3

4 - Enable in NAV code

Enable for


Warehouse Pick, Put-away and Move

In Codeunit 6181388 - MOB WMS Toolbox and function CreateWhseActLinesResponse


  1. Create a Global variable for the Codeunit Called "MOBWMSMedia" of type "Codeunit" and subtype "MOB WMS Media"
  2. Insert the following snippet


Code Block
languagexml
// MEDIA
MOBWMSMedia.AddItemImageToRequest(WhseActLineTake."Item No.",XMLOrderLine,NS_BASE_DATA_MODEL);
// MEDIA

Image Modified

Enable for


Warehouse Receipt

In Codeunit 6181372 - MOB WMS Receive and function CreateOrderLinesResponse

  1. Create a Global variable for Codeunit Called "MOBWMSMedia" of type "Codeunit" and Subtype "MOB WMS Media"
  2. Insert the following snippet


Code Block
languagexml
// MEDIA
MOBWMSMedia.AddItemImageToRequest(WhseReceiptLine."Item No.",XMLOrderLine,BaseDataModelNS);
// MEDIA

Image Modified

Enable for


Purchase Order Receipt

In Codeunit 6181372 - MOB WMS Receive and function CreatePurchaseLinesResponse

  1. Create a Global variable for the Codeunit Called "MOBWMSMedia" of type "Codeunit" and subtype "MOB WMS Media"
  2. Insert the following snippet


Code Block
languagexml
// MEDIA
MOBWMSMedia.AddItemImageToRequest(PurchaseLine."No.",XMLOrderLine,BaseDataModelNS);
// MEDIA


Image Modified

Enable for


Transfer Order Receipt

In Codeunit 6181372 - MOB WMS Receive and function CreateTransferLine

  1. Create a Global variable for the Codeunit Called "MOBWMSMedia" of type "Codeunit" and subtype "MOB WMS Media"
  2. Insert the following snippet


Code Block
languagexml
// MEDIA
MOBWMSMedia.AddItemImageToRequest(Transferline."Item No.",XMLOrderLine,BaseDataModelNS);
// MEDIA


Image Modified

Enable for


Locate

Item 

Item

There are two modifications to be made.

1st modification

Modification 1

In Codeunit 6181382 - MOB WMS Lookup and function LookupLocateItem

  1. Create a Global variable for the Codeunit Called "MOBWMSMedia" of type "Codeunit" and subtype "MOB WMS Media"
  2. Insert the following snippet


Code Block
languagexml
// MEDIA
MOBWMSMedia.AddItemImageToRequest("Item No.",XMLLookupResponse,MobXMLMgt.GetNodeNSURI(XMLResponseData));
// MEDIA

Image Modified

2nd modification

Modification 2

In Codeunit 6181382 - MOB WMS Lookup and function AddLookupResponse

  1. Create a Global variable for the Codeunit Called "MOBWMSMedia" of type "Codeunit" and subtype "MOB WMS Media"
  2. Insert the following snippet


Code Block
languagexml
// MEDIA
MOBWMSMedia.AddItemImageToRequest(ItemNo,XMLLookupResponse,Namespace);
// MEDIA


Image Modified

Enable for Planned


Planned Count

In Codeunit 6181376 - MOB WMS Count and function PhysCreateOrderLinesResponse

  1. Create a Global variable for the Codeunit Called "MOBWMSMedia" of type "Codeunit" and subtype "MOB WMS Media"
  2. Insert the following snippet


Code Block
languagexml
// MEDIA
MOBWMSMedia.AddItemImageToRequest(ItemJnlLine."Item No.",XMLOrderLine,BaseDataModelNS);
// MEDIA

Image Modified

Step 4 - Configure the Mobile App to show Images for desired workflows
You must enable images for the workflows you want to use them in, i.e. "Pick" and "LocateItem" etc..
Please note
The prerequisites in the beginning of this article which are:
  • Mobile WMS for Android App version 1.3.0 or newer
  • application.cfg on the scanners contains "listConfiguration" with images i.e.:
      <listConfiguration id="LookupWithImages">. 
  • If both these are not meet, contact Tasklet Factory.
Perform the following modifications to application.cfg
In general, to start using images you need to substitute the listConfiguration for the workflow with a new listConfiguration called the same but with "WithImages" appended.
Change where the  "OrderLines" list is used to instead use "OrderLinesWithImages".
For Pick:
Image Removed
For Put-away

Image Removed

For Receive

Image Removed

If you want to be able to see a larger version of the image during picking:


Show Image

To show the image in Full Screen, you can enable the "Show Image" action.

Image Added


Remove the comment tag surrounding the showImage action under PickLines:

A functional description

How Images are technically requested from the back-end

.


Images on Order lines
  1. A sourceID XML tag appears in the App Configuration file, application.cfg.
    1. This is named "ItemImage".
  2. When the Mobile Request Document Type "GetXXXOrderLines" is reponded to, an Image tag is included.
    1. This is also named "ItemImage".
    2. The value of the tag is a combination of Item No. and the date and time when the Item / Image was modified.
      This way, whenever an Item is modified, the App will know by the value changing and request the Image again, now receiving an updated image.
  • When the sourceID matches with the answer to the request, additional requests are made for the images needed. 
    One request after the next. These will have the Document Type "GetMedia".

    Image Removed

    Order lines

    Image Removed

    "Show Image" action

    Image Removed


    Troubleshooting that no image is being saved

    Mobile Doc. Type is missing

    The "GetMedia" Mobile document type has not been created.

    Solution

    Run "Set up Document Types" action from Mobile WMS Setup -page.


    Unknown error

    Inspect the log files on mobile device for error messages.


    Image Added

    Images on order lines


    Image Added

    Show Image -action



    Image Added

    Shown Image