SAP General
BlueWorx configuration allows administrators to control the available status' for Orders and Order Operations. For a detailed explanation on Order and Status settings see Order Settings, Order Status and Profile Filters Explained and Maintain Core Settings - Download and Upload Tabs.
Important Information
Summary information about this functionality:
- The configuration settings are all Global - except for the Assigned switch which applies (assigns) the status to the Active Configuration profile
- These Status', unless they are linked to SAP User Status', are unique to the BlueWorx User. i.e. One User can have the Order in Progress while another can have it Paused
- The maintained BlueWorx status can be independent from or linked to SAP standard Order and Order Operational User Status. This allows a user to track their Order and Operational status and optional trigger an update of the SAP Order and Operations User status. It also provides the ability to specify a special status that is auto set on first transfer of the Order to a Users mobile device and optionally set (once per Order) the Order User Status
- If you are online, then the status update in SAP will occur in real time. Like all other updates if you're offline then it will go to the users Outbox for syncing later with SAP
- The Operational status can be configured to set a timer (start | stop) whose value is then offered when making Time confirmations against the operation. This timer, like the status value itself is unique to that User The assigned SAP User status's must be configured in SAP for your Order Types (via Status Profile for Order type). If not configured then the BlueWorx status will update but the SAP User Status will not and will report an error. The SAP Status Code must be maintained as the Default Language value
- The 'Assigned' status for Order and Operational status' was introduced in SP12 along with configuration profiles. It means that the status values can be set up once and then then, by profile, configured for use. For example if you only allowed certain groups of users to 'Return an Order to Planner' you can now configure that option
Order Status
Configuration access is via the BlueWorx Administration > Maintain Core Settings > Order Status - Order Status sub tab.
| Field/ Function | Description/ Usage | Recommendation |
|---|---|---|
| Assigned switch | Mark this status as being assigned/ unassigned to the active Configuration Profile | |
| Select row | Select to edit - see next section |
Add/ Edit Order Status
Selecting the Add button will present the Order Status detailed screen, clicking on an existing row will allow editing.
Field | Sub Field | Explanation |
|---|---|---|
| Status | The key for the status Example 1 - For Status of Paused Value : PAUSED | |
| Description | A description of the status shown to a user Example 1 - For Status of Paused Value: Paused | |
| Sort | The order that the status value appears in the change status dialog | |
| Value State | Value state of the icon Example 1 - For Status of Paused Value: Warning | |
| Order Type | Allows filtering the status to display for certain Order Types (Comma-delimited list) | |
| Icon | Display icon of the status. Use available SAPUI5 icons i.e. sap-icon://xxxx Example 1 - For Status of Paused Value : sap-icon://pause For list of icons see: https://sapui5.hana.ondemand.com/test-resources/sap/m/demokit/iconExplorer/webapp/index.html#/overview/SAP-icons | |
| Default | Whether an in progress or is complete order is the default (BlueWorx start actions go to in progress -> is default, BlueWorx completion actions go to is complete -> is default) Example 1 - For Status of Paused Value: Not selected Note that administrators can set up multiple entries with the 'Complete' and 'Default' flags set. The solution will take the first such occurrence alphabetically on the Status Key. It's therefore up the administrators to make logical admin selections. | |
| Progress | If the status represents an Order in Progress - At least one status must have this set (if multiple are set - one must also be default) Example 1 - For Status of Paused Value: Not selected | |
| Complete | If the status represents a Completed Order (from a user perspective) - At least one status must have this set (if multiple are set - one must also be default). Example 1 - For Status of Paused Value: Not selected Note that administrators can set up multiple entries with the 'Complete' and 'Default' flags set. The solution will take the first such occurrence alphabetically on the Status Key. It's therefore up the administrators to make logical admin selections. | |
| Complete Action | When the status is configured as "Is Complete", the status can TECO or not TECO the order in the backend. This overrides the admin setting for TECO on complete. Default behaviour for already existing "Is Complete" statuses is to use the admin setting, the other options are 'TECO Order' and 'Do Not TECO Order'. This feature is available as of SP5 | |
| Disable Prompt Confirmation | Use this switch to disable prompting the entry of Time when completing an Order - for customers that don't capture time against Work Orders. | |
| Set On Device | If there is no Status records for a User for an Order then, on first sync of the Order to the Device, this Status will be set. It will also update the SAP User Status to the value maintained, on first transfer of the Order to any device. Note: There should only be one status with this switched on. This status will not be made available on Order status update in BlueWorx by the user but will show in the Order History Example 1 - For Status of Paused Value: Not selected | |
| Status Array | Child Operation Status From | On selecting this Status all of the Orders Operations with this Operational Status will be changed - see next sub field. [optional setting] Note: The value used in this configuration must be configured as viable Order Operations Status. Example 1 - For Status of Paused you want to pause any operations in progress if you pause the whole Order Value : STARTED The SAP Status Code must be maintained as the Default Language value. |
| Child Operation Status To | On selecting this Status all of the Order Operations, if complying with the previous sub field value, will be changed to this Operational Status. [optional setting] Note: The value used in this configuration must be configured as viable Order Operations Status. Example 1 - For Status of Paused you want to pause any operations in progress if you pause the whole Order Value : PAUSED The SAP Status Code must be maintained as the Default Language value. | |
| SAP User Status | Set User Status | Selecting this status will set one or more SAP User Status at the Order Header level to this value [optional setting] (Comma delimited list) Note: The value used in this configuration must be configured in SAP for all appropriate Orders. The SAP Status Code must be maintained as the Default Language value. |
| Delete User Status | Selecting this status will remove one or more SAP User Status at the Order Header level to this value [optional setting] (Comma delimited list) Note: The value used in this configuration must be configured in SAP for all appropriate Orders. The SAP Status Code must be maintained as the Default Language value. |
You can optionally maintain translation values for your Order Status values:
Operations Status
Configuration access is via the BlueWorx Administration > Maintain Core Settings > Order Status - Operation Status sub tab.
| Field/ Function | Description/ Usage | Recommendation |
|---|---|---|
| Assigned switch | Mark this status as being assigned/ unassigned to the active Configuration Profile | |
| Select row | Select to edit - see next section |
Add/ Edit Order Operation Status
Selecting the Add button will present the Order Status detailed screen, clicking on an existing row will allow editing.
| Field | Sub Field | Explanation |
|---|---|---|
| Status | The key for the status | |
| Description | A description of the status shown to a user | |
| Display Order | The order that the status value appears in the change status dialog | |
| Clock Action | Whether this operation starts or stops the clock (used in time confirmations as a helper) | |
| Sort | Sets the display sort order | |
| Icon | Display icon of the status For list of icons see: https://sapui5.hana.ondemand.com/test-resources/sap/m/demokit/iconExplorer/webapp/index.html#/overview/SAP-icons | |
| Value State | Value state of the icon | |
| Calendar Display | Controls the colour of the Operational display box in the Planning Calendar in the MyWork form | |
| Prompt Time | If the status change will prompt a Time Confirmation dialog | |
| Status Array | Sibling Operations Status From | On selecting this Status all sibling Order Operations with this Operational Status will be changed - see next sub field. [optional setting] Note: The value used in this configuration must be configured as viable Order Operations Status. |
| Sibling Operations Status From | On selecting this Status all sibling Order Operations, if complying with the previous sub field value, will be changed to this Operational Status. [optional setting] Note: The value used in this configuration must be configured as viable Order Operations Status. | |
| Parent Order Status From | On selecting this Status if the parent Order has this Status it will be changed - see next sub field. [optional setting] Note: The value used in this configuration must be configured as viable Order Status. | |
| Parent Order Status To | On selecting this Status the Order Status, if complying with the previous sub field value, will be changed to this Order Status. [optional setting] Note: The value used in this configuration must be configured as viable Order Status. | |
| SAP User Status | Set User Status | Selecting this status will set one or more SAP User Status at the Order Item level to this value [optional setting] (Comma delimited list) Note: The value used in this configuration must be configured in SAP for all appropriate Order Operations. The SAP Status Code must be maintained as the Default Language value. |
| Delete User Status | Selecting this status will delete one or more SAP User Status at the Order Item level to this value [optional setting] (Comma delimited list) Note: The value used in this configuration must be configured in SAP for all appropriate Order Operations. The SAP Status Code must be maintained as the Default Language value. |
You can optionally maintain translation values for your Order Operation Status values.
