Set up custom field on WMS

JIRA Code : HLUK-649

1. Create the custom transaction body field, and then apply it to the transaction.For this sample customization, create a Country of Origin transaction body field, and then apply it to the item receipt transaction. For detailed instructions, see Creating Custom Transaction Body Fields.Take note of the ID of the new custom field, which you must set up in step 3.
2. Clone the mobile process that contains the page on which you want to display and configure the field.For this sample customization, clone the PO Receiving process. To clone a mobile process, go to Setup > Custom > Mobile – Applications. To view the instructions, see Customizing Mobile Processes.
3. For your custom mobile process, create and configure the mobile page element for the custom field by doing the following:
   1. Using the Administrator role, go to Setup > Custom > Mobile – Applications.
   2. On the Mobile – Applications List, click View next to the mobile application.
   3. On the Mobile – Process List, click View next to the custom mobile process you cloned in step 2.
   4. On the Mobile – Process page, click the Pages subtab, and then click the name of the mobile page on which you want to display the custom field.For this example, click the poReceiving_quantityScan_ link next to the Enter Quantity page.
   5. On the Mobile – Page page, click the Page Elements subtab, and then click New Mobile – Page Element.
   6. On the Mobile – Page Element page, enter or select values in the following fields:NoteThe fields for dropdown elements vary from those for textbox and other page elements. The fields that appear on this page depend on the element type that you select. 
      • In the Name field, enter a unique name for the page element.
      • In the Type field, select the page element type.For this example, select Drop Down. Only the fields for drop down elements remain on the page.
      • In the Label field, enter the field label you want to show on the mobile page.To add a new label, click the new  icon.For this example, enter Country of Origin.
      • In the Input ID and Input Value fields, set up the value-label pair that identifies the dropdown element selection. In the Input ID field, enter the name of the column that contains the list of values for the pair. The value that corresponds to the dropdown element selection is assigned to the pair. In the Input Value field, enter the name of the column that contains the list of labels for the pair. The labels appear as the dropdown element options and the selected label is assigned to the pair.You can enter a column from a list or saved search to set up a dynamic list. For this example, set up a static list by entering [“Canada”, “United Kingdom”, “United States”] in both fields.
      • In the Record Name field, enter the ID of the transaction form to which you want to save the value of this field.For this example, enter itemreceipt.
      • In the Field Name field, enter the ID of the custom transaction body field, which you created in step 1.TipTo get values from a saved search, instead of a list in this example, configure and enter a Saved Search action in the On Load Action field. Then, you must set the value of the Response Key field to data. For the Input ID and Input Value fields, you must enter the internal IDs of columns returned by the saved search. For more information about mobile actions, see Configuring Actions for Custom Mobile Processes. 
4. Configure the Submit Form action setting on the last page of the form by doing the following:
   1. After you have configured the custom field, access the Mobile – Process page, as you did in step 3.
   2. On the Pages subtab, next to the Enter Bin title, click poReceiving_enterBin_.For this sample customization, configure the Submit Form action of the submission button that appears on the Enter Bin page, the last page of the PO Receiving process form.
   3. On the Mobile – Page page, click the Page Elements subtab, and then next to the Enter Bin action button, click the poReceiving_enterBin_nextBtn link.Mobile pages can have multiple Submit Form actions configured on different page elements. For example, on the Enter Bin page, instead of clicking the Enter Bin submission button, you can select a bin from the table to submit the form. You can update the Submit Form action for the button element, data table element, or both.TipIf you want to apply the same update to the bin table, click poReceiving_enterBin_binListTbl next to the Data Table type. On the Mobile – Page Element page, click the action in the On Row Click Action field. To configure this action, proceed to step e. 
   4. On the Mobile – Page Element page, in the On Click Action field, click the poReceiving_validateBinAndSubmit link.
   5. On the Mobile – Action page, click Edit.
   6. To configure the action setting, beside the After Action Restlet field, click the New  icon.
   7. On the new Mobile – Action page, enter or select values in the following fields:
      • In the Name field, enter a unique name for the restlet action.
      • In the Type field, select Restlet.
      • In the HTTP Method field, select POST
      • In the Script ID field, enter the ID of the default script: customscript_mobile_rl_create_record.
      • In the Deployment ID field, enter the ID of the default script deployment: customdeploy_mobile_rl_create_record.
   8. Click Save.
5. After you have completed all of your customizations, you must update the mobile application by doing the following:
   1. Go to Setup > Custom > Mobile – Applications.
   2. On the Mobile – Applications List, click the Update App link next to the mobile application.To view the status of your update, click the link on the processing message at the top of the page. Wait for the confirmation message to appear before you start accessing your custom mobile page.