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/ FunctionDescription/ UsageRecommendation
Assigned switchMark this status as being assigned/ unassigned to the active Configuration Profile
Select rowSelect 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
DescriptionA description of the status shown to a user

Example 1 - For Status of Paused
Value: Paused
SortThe order that the status value appears in the change status dialog
Value StateValue state of the icon

Example 1 - For Status of Paused
Value: Warning
Order TypeAllows filtering the status to display for certain Order Types (Comma-delimited list)
IconDisplay 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
DefaultWhether 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.
ProgressIf 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
CompleteIf 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 ActionWhen 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 ConfirmationUse 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 ArrayChild Operation Status FromOn 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 ToOn 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 StatusSet User StatusSelecting 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 StatusSelecting 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/ FunctionDescription/ UsageRecommendation
Assigned switchMark this status as being assigned/ unassigned to the active Configuration Profile
Select rowSelect 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.

FieldSub FieldExplanation
Status
The key for the status
DescriptionA description of the status shown to a user
Display OrderThe order that the status value appears in the change status dialog
Clock ActionWhether this operation starts or stops the clock (used in time confirmations as a helper)
SortSets the display sort order
IconDisplay 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 StateValue state of the icon
Calendar DisplayControls the colour of the Operational display box in the Planning Calendar in the MyWork form
Prompt TimeIf the status change will prompt a Time Confirmation dialog
Status ArraySibling Operations Status FromOn 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 FromOn 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 FromOn 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 ToOn 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 StatusSet User StatusSelecting 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 StatusSelecting 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.