======Customization Process======

<wrap em>Produmex Manufacturing is a legacy product and Boyum IT Solutions no longer sells new installations for it.</wrap>

The customization process for the Produmex mobile applications consists of the following steps:
  * Enable the Customization Assist mode and run the client application. Check the customization information of the screen.
  * Create the custom field and/or the SAP user query.
  * Restart the client application and check the results of the customization.

Many screens of Produmex mobile applications are customizable with SAP Business One’s queries. The used query have to be named specifically based on the screen it is used on. The query names, and parameters can be found with the help of the 'Customization Assist'. The query result column names indicate which fields to set.

Supported customization types:
  * Preset field data
  * Validation: The system checks if the entered values are correct during a ‘validate’ or a ‘button’ event.
  * Add new fields/Hide existing fields

=====1. Configure and run client application=====
====1.1. Enable the Customization Assist====
To see information regarding the customization possibilities enable the Customization Assist mode. 

<WRAP round tip>The Customization Assist mode is only needed to see customization possibilities. It is not required to be enabled during normal operations.</WRAP>

Start the Produmex PDC Configuration application. On the [[implementation:manufacturing:confguide#appearance_tab|‘Appearance’ tab]] tick the Customization Assist checkbox to enable the Customization Assist mode.

{{ :implementation:scan:custom:general:enable_ca_pdc.png |Configuration}}

====1.2. Run client application====
After the Customization Assist Mode has been activated, run the Produmex client application. Go to the screen to be customized.

Press the {{:implementation:scan:custom:general:pdc_icon.png?25|icon}} button on the top of the screen. The ‘Customization Info of //ScreenName//’ screen will open up. \\
On the ‘Parameters’ tab the possible parameters for customization user queries are listed with their type and current value. On the ‘Events’ tab the customizable events are listed. The ‘Exists’ checkbox indicates whether there is an existing custom query for the event or not.

{{ :implementation:scan:custom:general:custominfo_pdc.png |Customization Info screen}}

=====2. Customization=====
====2.1. Create custom field====
Open the Customization Fields table in SAP Business One via: Tools > User Defined Windows > BXCUSTFD. 

^<WRAP>//**Field**//</WRAP>^<WRAP>//**Description**//</WRAP>^<WRAP>//**Value**//</WRAP>^
^Field Name|This name will be used in the custom queries. On the Customization window the field will appear with this name. \\ If the name of an existing field is added, the other properties can be changed. (For example this hide an existing field set the ‘Visibility’ to ‘No')|Please see: [[implementation:manufacturing:customizationexamples|Produmex Manufacturing Customization Examples]]|
^Field Type|Type of the field.|Supported field types: \\ //String(0)//: Creates a new input fields. It will have a ‘validate’ and ‘validate after’ event. \\ //Button(13)//: Creates a new button. It will have a ‘click’ and ‘click after’ event.|
^Label|The displayed text. It is also possible the change the label of an existing field.|   |
^Module|The name of the mobile solution.|BXPPSMobilePDC|
^On External Form|Defines whether the new field is added to a new screen or not. If yes, a new button will appear to open the external screen.|Yes/No|
^Protected|If set to yes, the field will be displayed on the proceeding screen as well. The entered value in read-only mode.|Yes/No|
^Read Only|Defines whether the field will be read only or not.|Yes/No|
^Screen|The screen name.|The screen name can be found in the first line on the Customization window.|
^Visible|Defines whether the field is displayed on the screen or not.|Yes/No|

====2.2. Create an SAP user query====
Open the Query Manager in SAP Business One via: Tools > Queries > Query Manager 

Create the user query. \\
The name of the query defines when it will be executed, therefore save it as the name of the event when you would like to run the user query. \\

<WRAP round box>EXAMPLE: The user query that runs when the ‘GR PO’ screen is loaded in Produmex Scan is 'BXMobileWH9_GoodsReceiptPOScreen_Load'</WRAP>
====2.2.1. Supported message types====

The following message types can be used in user queries for Produmex PDC: 
  * **I: Information** \\ A green line will appear at the footer of the screen with the message. The event will execute.
  * **W: Warning** \\ A blue line will appear at the footer of the screen with the message. The event will execute.
  * **E: Error** \\ This is the default message type value. A red line will appear at the footer of the screen with the message. The event not will execute.
  * **IM: Information with message box** \\ A pop up information message will be prompted, that needs user confirmation (OK). The event will execute. 

{{ :implementation:scan:custom:general:im.png |IM}}

  * **WM: Warning with message box** \\ A pop up warning message will be prompted, that needs user confirmation (OK). The event will execute.

{{ :implementation:scan:custom:general:wm.png |WM}}

  * **EM: Error with message box** \\ A pop up error message will be prompted, that needs user confirmation (OK). The event will not execute.

{{ :implementation:scan:custom:general:em.png |EM}}

  * **YM: Yes/No with message box** \\ A pop up confirmation message will be prompted, that can be answered with yes or no. The event will execute depending on user choice.

{{ :implementation:scan:custom:general:ym.png |YM}}

 
=====3. Restart the application=====
To apply the customization restart the mobile application. 
<WRAP info round>You must restart the application every time a new user query is created but it is not necessary to restart the application when modifying an existing query.</WRAP>