Material
When on site at a customer, users can choose from the following material usage buttons (if activated).
| Usage | Description |
|---|---|
| Material Usage | All standard material, i.e. all products that are marked as Sales by Service. |
| Additional Repair | All material relevant to the task type, i.e. all products that are marked relevant for the task type that was selected by the user, when entering the Additional Repair screens. This can be useful in cases where customers require the repair of an unforeseen model. Since the task type may indicate a repair (or service), the user can easily select from the list of models without having to scroll through a far more detailed product list. |
| Spare Parts | All products that are marked as a spare part of one of the planned items of the task. |
| Usage/Request | A combined view of the Material Usage and the Material Request screen. |
| showMaterialIcon | ||||
|---|---|---|---|---|
| Type | Default Value | Example | Android | HTML 5 |
| Boolean | true | false | + | - |
The screen behind this icon supports entering a "Material Request".
| showAdditionalRepairIcon | ||||
|---|---|---|---|---|
| Type | Default Value | Example | Android | HTML 5 |
| Boolean | false | true | + | - |
The screen behind this icon supports entering "Additional Repair" information. Also, there must be at least one product, which has the same task-type as the current task, to make the icon appear.
| showSparePartsIcon | ||||
|---|---|---|---|---|
| Type | Default Value | Example | Android | HTML 5 |
| Boolean | false | true | + | - |
The screen behind this icon supports entering "Spare Parts" information.
| showMaterialRequestIcon | ||||
|---|---|---|---|---|
| Type | Default Value | Example | Android | HTML 5 |
| Boolean | false | true | + | - |
The screen behind this icon supports entering a "Material Request".
| showUsageRequestIcon | ||||
|---|---|---|---|---|
| Type | Default Value | Example | Android | HTML 5 |
| Boolean | false | true | + | + |
The screen behind this icon supports entering "Material Usage" and "Material Request" information and is named "Usage/Request".
All these preferences can be made process flow-dependent.
For Additional Repair, a Mobile UI is activated that corresponds with the type of the task (taskType). For the other activities, a slider is shown to let the user choose the quantity.
When entering additional material, the entered quantity can be tested on a value greater than zero. Turn the checkZeroMaterial preference on to avoid zero quantities.
| checkZeroMaterial | ||||
|---|---|---|---|---|
| Type | Default Value | Example | Android | HTML 5 |
| Boolean | false | true | + | + |
When a material was selected by the mobile worker, it is marked as delivered, i.e. the mobile worker can't select this material for this task again. Set the preference filterSelectedMaterial to false to avoid this standard behavior and let the material item remain visible and selectable, even though it was selected before.
| filterSelectedMaterial | ||||
|---|---|---|---|---|
| Type | Default Value | Example | Android | HTML 5 |
| Boolean | true | false | + | + |
OMD Mobile is capable of immediately checking the selected material for availability in the (car) stock of the mobile worker (inventory) or within the organization. Use the checkStockAndAvailability preference to indicate:
- The amount of items of this product in stock
- The availability (not the amount) of the product within the organization
| checkStockAndAvailability | ||||
|---|---|---|---|---|
| Type | Default Value | Example | Android | HTML 5 |
| Boolean | false | true | + | always true |
OMD reserves a special Mobile UI called -OMD-, where option widgets can be defined to allow mobile workers to provide a reason when choosing material. Each of the above material usage types use a separate widget called AdditionalRepair, AdditionalService, SpareParts or MaterialRequest. AdditionalService is the name of the default widget, which will be shown in case the other three do not exist. If AdditionalRepair, SpareParts and MaterialRequest exist, they will be shown where appropriate.
To allow requesting material from colleagues, set the preference allowResourceMaterialRequest to true. The dialog contains an additional button, showing the list of resources sorted by distance who carry the selected material in their inventory.
| allowResourceMaterialRequest | ||||
|---|---|---|---|---|
| Type | Default Value | Example | Android | HTML 5 |
| Boolean | false | true | + | + |