1. Overview
Microservice containing the business logic for managing supervisor-app-service.
1.2. Tags
-
application-properties-controller : Application Properties Controller
-
application-tab-controller : Application Tab Controller
-
bom-formulation-controller : Bom Formulation Controller
-
clock-on-controller : Clock On Controller
-
document-management-controller : Document Management Controller
-
external-config-controller : External Config Controller
-
history-controller : History Controller
-
labor-type-controller : Labor Type Controller
-
line-controller : Line Controller
-
material-controller : Material Controller
-
material-lot-controller : Material Lot Controller
-
operations-controller : Operations Controller
-
product-controller : Product Controller
-
product-family-controller : Product Family Controller
-
product-property-value-controller : Product Property Value Controller
-
property-group-controller : Property Group Controller
-
summary-controller : Summary Controller
-
unit-controller : Unit Controller
-
user-settings-controller : User Settings Controller
-
work-order-component-controller : Work Order Component Controller
-
work-order-segment-controller : Work Order Segment Controller
-
work-orders-controller : Work Orders Controller
2. Resources
2.1. Application-properties-controller
Application Properties Controller
2.1.1. Get Application Properties
GET /app/properties
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
2.2. Application-tab-controller
Application Tab Controller
2.2.1. Get tabs mapped to appId.
GET /apps/{appId}/tabs
Parameters
Type | Name | Description | Schema | Default |
---|---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
|
Path |
appId |
appId |
integer (int64) |
|
Query |
enabled |
enabled |
boolean |
|
Query |
page |
page |
integer (int32) |
|
Query |
size |
size |
integer (int32) |
|
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
< ApplicationTabResponseResults > array |
400 |
Bad Request |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server error |
2.2.2. Get tab details mapped to appId
GET /apps/{appId}/tabs/{tabId}
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
appId |
appId |
integer (int64) |
Path |
tabId |
tabId |
integer (int64) |
Query |
segmentId |
segmentId |
integer (int64) |
Query |
workOrderId |
workOrderId |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
422 |
Unprocessable Entity |
|
500 |
Internal Server error |
2.3. Bom-formulation-controller
Bom Formulation Controller
2.3.1. Get BOM items by formulationId
GET /formulationItems
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
workOrderId |
Workorder Id for which BOM formulation details are required |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
401 |
Unauthorized |
No Content |
403 |
Forbidden |
|
404 |
Not Found |
|
503 |
Service Unavailable |
2.3.2. Get PropertyDefinitions Metadata from property definitionIds
GET /formulationItems/propertyDefinitionDetails
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
propertyDefinitionIds |
List of propertiesDefinitionIds whose metadata like propertyName, DataType etc, are required. |
< string > array(multi) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
400 |
Bad Request |
|
401 |
Unauthorized |
No Content |
403 |
Forbidden |
|
503 |
Service Unavailable |
2.4. Clock-on-controller
Clock On Controller
2.4.1. clockOffUser
POST /workorders/{id}/clockOffUser
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id |
integer (int64) |
Query |
productionLineId |
ProductionLineId |
integer (int64) |
Body |
clockOffByOperatorEntryInfos |
ClockOff User and Operation Details |
< ClockOffByOperatorEntryInfo > array |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.4.2. getClockOnDetails
GET /workorders/{id}/clockOnDetails
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.5. Document-management-controller
Document Management Controller
2.5.1. API Endpoint to Create Metadata / Create revision for the documents
POST /documents
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
clientId |
clientId, The data store (documents or media) |
string |
Body |
documentMetaInfo |
Metadata for creation of document or revision |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
201 |
Created |
object |
400 |
Bad Request |
|
401 |
Unauthorized |
|
422 |
Unprocessable Entity |
2.5.2. API endpoint to Get Documents
GET /documents
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
clientId |
clientId, The data store (documents or media) |
string |
Query |
documentId |
document id |
string |
Query |
offset |
integer (int64) |
|
Query |
pageNumber |
integer (int32) |
|
Query |
pageSize |
integer (int32) |
|
Query |
paged |
boolean |
|
Query |
sort.sorted |
boolean |
|
Query |
sort.unsorted |
boolean |
|
Query |
unpaged |
boolean |
|
Query |
workOrderId |
workOrderId, The workorder whose documents are required |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
400 |
Bad Request |
|
401 |
Unauthorized |
|
422 |
Unprocessable Entity |
2.5.3. API endpoint to upload a document
PUT /documents
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
attachmentName |
Attachment Name |
string |
Query |
clientId |
ClientId, The data store (documents or media) |
string |
Query |
docId |
The document identifier |
string |
Query |
rev |
The Document Revision Id |
string |
FormData |
file |
The file that has to be uploaded |
file |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
400 |
Bad Request |
|
401 |
Unauthorized |
|
422 |
Unprocessable Entity |
2.5.4. API endpoint to Get uploaded document
GET /documents/attachment
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
attachmentName |
attachment Name |
string |
Query |
clientId |
clientId, The data store (documents or media) |
string |
Query |
documentId |
document id or url |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
400 |
Bad Request |
|
401 |
Unauthorized |
|
422 |
Unprocessable Entity |
2.5.5. API endpoint to Create document reference
POST /documents/references
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
clientId |
clientId The data store (documents or media) |
string |
Body |
documentReference |
Document reference |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
201 |
Created |
object |
400 |
Bad Request |
|
401 |
Unauthorized |
|
422 |
Unprocessable Entity |
2.5.6. API endpoint to Get Revisions By InitialId
GET /documents/revision/{initialId}
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
initialId |
initial id |
string |
Query |
clientId |
clientId The data store (documents or media) |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
400 |
Bad Request |
|
401 |
Unauthorized |
|
422 |
Unprocessable Entity |
2.6. External-config-controller
External Config Controller
2.6.1. Get Configurations
GET /v1/configurations
Parameters
Type | Name | Description | Schema | Default |
---|---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
|
Query |
actionId |
actionId |
integer (int32) |
|
Query |
actionName |
actionName |
string |
|
Query |
actionTypeId |
actionTypeId |
integer (int32) |
|
Query |
configId |
configId |
integer (int64) |
|
Query |
includeDeleted |
includeDeleted |
boolean |
|
Query |
page |
page |
integer (int32) |
|
Query |
segmentId |
segmentId |
integer (int64) |
|
Query |
size |
size |
integer (int32) |
|
Query |
workOrderId |
workOrderId |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
204 |
No Content, Error retrieving actions |
|
401 |
User Unauthorized |
No Content |
500 |
Internal Server Error |
2.7. History-controller
History Controller
2.7.1. getHistoryDetails
GET /workorders/{id}/historyDetails
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id |
integer (int64) |
Query |
materialLotActualId |
Material Lot Actual Id |
integer (int64) |
Query |
segmentActualId |
SegmentActualId |
integer (int64) |
Query |
segmentId |
Segment Id |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.8. Labor-type-controller
Labor Type Controller
2.8.1. Get all laborTypes
GET /laborTypes
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
400 |
Invalid data supplied. See message for details. |
|
401 |
Unauthorized |
|
404 |
Not Found |
2.9. Line-controller
Line Controller
2.9.1. Get Route Enabled Lines
GET /lines
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
< Line > array |
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.10. Material-controller
Material Controller
2.10.1. Get Target Material Lot Details
GET /targetMaterialLot
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
lotIdentifier |
lotIdentifier |
string |
Query |
workOrderId |
workOrderId |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.11. Material-lot-controller
Material Lot Controller
2.11.1. Get Material Lot Details
GET /workorders/{id}/materialLotDetails
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id |
integer (int64) |
Query |
page |
Results page you want to retrieve (0..N) |
integer (int32) |
Query |
size |
Number of records per page. |
integer (int32) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.11.2. Get Material Lot Details
GET /workorders/{id}/materialLots
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.12. Operations-controller
Operations Controller
2.12.1. getOperations
GET /operations
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
completedAfter |
Fetch Operations created/completed after |
string |
Query |
completedBefore |
Fetch Operations created/completed before |
string |
Query |
completedTimeFrame |
Completed Timeframe of the Operation |
enum (Last7Days) |
Query |
limitSearchResult |
limitSearchResult |
boolean |
Query |
materialLotName |
Lot Identifier to Fetch the workorders from |
string |
Query |
name |
WorkOrder Name to Fetch |
string |
Query |
onHold |
Fetch only onHold Items |
boolean |
Query |
page |
Results page you want to retrieve (0..N) |
integer (int32) |
Query |
producedMaterialId |
Product Id to Fetch the workorders from |
< integer (int64) > array(multi) |
Query |
productFamilyId |
ProductFamily Ids to Fetch the workorders from |
< integer (int64) > array(multi) |
Query |
productionLineId |
ProductionLine Ids to Fetch the workorders from |
< integer (int64) > array(multi) |
Query |
size |
Number of records per page. |
integer (int32) |
Query |
status |
Status of the WorkOrder (Ready, InProgress, Complete, Skipped) |
< string > array(multi) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.13. Product-controller
Product Controller
2.13.1. Get Products
GET /products
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
productId |
productId |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
< ProductInfo > array |
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.14. Product-family-controller
Product Family Controller
2.14.1. Get Product Families
GET /productFamilies
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
< ProductFamilyInfo > array |
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.14.2. Get Products For Family
GET /productFamilies/getProducts/{productFamilyId}
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
productFamilyId |
ProductFamilyId to Fetch the products from |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
< ProductFamilyInfo > array |
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.15. Product-property-value-controller
Product Property Value Controller
2.15.1. Get property values for product
GET /v1/product/{productId}/properties
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
productId |
product id |
integer (int64) |
Query |
page |
Results page you want to retrieve (0..N) |
integer (int32) |
Query |
size |
Number of records per page. |
integer (int32) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
204 |
No selected group properties for the given request |
object |
400 |
Invalid data supplied. See message for details. |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server error |
2.16. Property-group-controller
Property Group Controller
2.16.1. Get all revisions for property-group-definition
GET /properties/definitions/{initialId}/revisions
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
initialId |
initialId for which property revisions are required |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
400 |
Invalid data supplied. See message for details. |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server error |
2.16.2. Get all property groups list
GET /properties/groups
Parameters
Type | Name | Description | Schema | Default |
---|---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
|
Query |
includeDeleted |
Include deleted items(true/false) |
boolean |
|
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
400 |
Invalid data supplied. See message for details. |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server error |
2.16.3. Get all property definitions by property group id
GET /properties/groups/{groupId}/definitions
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
groupId |
GroupId to fetch definitions from |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
400 |
Invalid data supplied. See message for details. |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server error |
2.16.4. Get selected list of property groups for workorder or segment
GET /properties/workorders/{workOrderId}/segments
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
workOrderId |
Workorder Id for which property details are required |
integer (int64) |
Query |
segmentId |
Segment Id for which property details are required |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
204 |
No selected group properties for the given request |
object |
400 |
Invalid data supplied. See message for details. |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server error |
2.17. Summary-controller
Summary Controller
2.17.1. getSummaryDetails
GET /workorders/{id}/summaryDetails
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id for which summary is required |
integer (int64) |
Query |
page |
Results page you want to retrieve (0..N) |
integer (int32) |
Query |
size |
Number of records per page. |
integer (int32) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.18. Unit-controller
Unit Controller
2.18.1. Get all units
GET /units
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
lineId |
Line Id for which unit details are required |
integer (int32) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
400 |
Invalid data supplied. See message for details. |
|
401 |
Unauthorized |
|
404 |
Not Found |
2.18.2. Get all departments
GET /units/departments
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
400 |
Invalid data supplied. See message for details. |
|
401 |
Unauthorized |
|
404 |
Not Found |
2.19. User-settings-controller
User Settings Controller
2.19.1. Create User settings for the logged in user
POST /v2/settings
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Body |
userSettingsRequest |
User Setting Object |
Responses
HTTP Code | Description | Schema |
---|---|---|
201 |
Created |
|
204 |
No Content, Error retrieving created user settings |
|
400 |
Invalid data supplied |
|
401 |
User Unauthorized |
No Content |
404 |
App ID not found in privilege set |
|
409 |
Conflict, User Setting already exists. Use a PUT to update |
|
500 |
Internal Server Error |
2.19.2. Get User settings for the logged in User
GET /v2/settings
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
appId |
appId |
integer (int32) |
Query |
viewName |
viewName |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Invalid data supplied |
|
401 |
User Unauthorized |
No Content |
404 |
Not found, no user setting found for the user |
|
500 |
Internal Server Error |
2.19.3. Update User settings for the logged in user
PUT /v2/settings
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Body |
request |
User Preference Object |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Invalid data supplied |
|
401 |
User Unauthorized |
No Content |
404 |
Not Found, There is no saved User settings for the logged in user |
|
500 |
Internal Server Error |
2.19.4. Delete User settings for the logged in user
DELETE /v2/settings
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
appId |
appId |
integer (int32) |
Query |
viewName |
viewName |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
204 |
Success |
string |
400 |
Invalid data supplied |
|
401 |
User Unauthorized |
No Content |
404 |
Not Found, User Setting not found |
|
500 |
Internal Server Error |
2.19.5. Get Privilege Sets
GET /v2/settings/apps
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
appName |
appName |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
< PrivilegeSet > array |
400 |
Invalid data supplied |
|
401 |
User Unauthorized |
No Content |
404 |
Not found, no user setting found for the user |
|
500 |
Internal Server Error |
2.20. Work-order-component-controller
Work Order Component Controller
2.20.1. Add alot
POST /workOrders/{workOrderId}/addLots
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
workOrderId |
workOrderId |
integer (int64) |
Query |
authenticated |
boolean |
|
Query |
authorities[0].authority |
string |
|
Query |
credentials |
object |
|
Query |
details |
object |
|
Query |
principal |
object |
|
Query |
status |
status |
string |
Body |
addLotEntry |
addLotEntry |
< AddLotEntry > array |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
object |
201 |
Created |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server error |
2.21. Work-order-segment-controller
Work Order Segment Controller
2.21.1. Get WorkOrder Segments
GET /workorders/{id}/segments
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.21.2. Update WorkOrder Segments
PUT /workorders/{id}/segments
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id |
integer (int64) |
Query |
eTagValue |
eTagValue |
string |
Body |
updatedSegmentsDefinitionObject |
updatedSegmentsDefinitionObject |
object |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.22. Work-orders-controller
Work Orders Controller
2.22.1. Get WorkOrders
GET /workorders
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Query |
completedAfter |
Fetch Workorders created/completed after |
string |
Query |
completedBefore |
Fetch Workorders created/completed before |
string |
Query |
completedTimeFrame |
Completed Timeframe of the WorkOrder |
enum (Last7Days) |
Query |
materialLotName |
Material Lot to be searched |
< string > array(multi) |
Query |
name |
Name of the WorkOrder |
string |
Query |
onHold |
Fetch only onHold Items |
boolean |
Query |
orderBy |
Field by which response is sorted, default by Name (Name, Priority, PlannedStartDate) |
string |
Query |
page |
Results page you want to retrieve (0..N) |
integer (int32) |
Query |
priority |
Relative priority of the WorkOrder |
integer (int32) |
Query |
producedMaterialId |
Product Id to Fetch the workorders from |
< integer (int64) > array(multi) |
Query |
productFamilyIds |
ProductFamily Ids to Fetch the workorders from |
< integer (int64) > array(multi) |
Query |
productionLineId |
ProductionLine Ids to Fetch the workorders from |
< integer (int64) > array(multi) |
Query |
size |
Number of records per page. |
integer (int32) |
Query |
status |
Status of the WorkOrder (Ready, InProgress, Complete) |
< string > array(multi) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.22.2. Get Workorder
GET /workorders/{id}
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
404 |
Not Found |
|
500 |
Internal Server error |
2.22.3. updateWorkOrderPriority
PUT /workorders/{id}
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id |
integer (int64) |
Query |
productionLineId |
ProductionLineId |
integer (int64) |
Body |
workOrderDetails |
Relative priority of the WorkOrder |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.22.4. Cancel Workorder
POST /workorders/{id}/cancel
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id |
integer (int64) |
Query |
productionLineId |
ProductionLineId |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.22.5. Get Lot Status Details
GET /workorders/{id}/currentLotStatus
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.22.6. updateLotIdentifiers
POST /workorders/{id}/updateLotIdentifiers
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
id |
WorkOrder Id |
integer (int64) |
Query |
productionLineId |
ProductionLineId |
integer (int64) |
Body |
updateLotIdentifierEntriesinfo |
Workorder lot Identifiers |
< UpdateLotIdentifierEntryinfo > array |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.22.7. Cancel Material Lot
POST /workorders/{workOrderId}/cancellot
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
workOrderId |
WorkOrderID |
integer (int64) |
Body |
materialLotIds |
materialLotIds |
< integer (int64) > array |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
2.22.8. completeworkorder
POST /workorders/{workOrderId}/completeworkorder
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Header |
Site-Id |
Represents the id of the site to connect to |
string |
Path |
workOrderId |
WorkOrder Id |
integer (int64) |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
500 |
Internal Server error |
3. Definitions
3.1. AddLotEntry
Material lot information used by the add lot command to identify the material lot identifiers and their planned quantity.
Name | Description | Schema |
---|---|---|
lotIdentifier |
Identifier for this material lot |
string |
plannedQuantity |
The planned quantity to produce with this material lot. |
integer (int32) |
3.2. ApplicationTabDetailResponse
Name | Schema |
---|---|
description |
string |
display_name |
string |
id |
integer (int64) |
standard |
boolean |
tab_config_data |
|
tab_config_expressions |
3.3. ApplicationTabResponseResource
Name | Schema |
---|---|
description |
string |
displayName |
string |
enabled |
boolean |
id |
integer (int64) |
links |
|
sequenceOrder |
integer (int32) |
standard |
boolean |
3.4. ApplicationTabResponseResults
Name | Schema |
---|---|
content |
< ApplicationTabResponseResource > array |
links |
|
page |
3.5. AppliesTo
Name | Schema |
---|---|
excludedMaterialLotActualIds |
< integer (int64) > array |
materialLotActualIds |
< integer (int64) > array |
3.6. AssociatedProduct
Name | Schema |
---|---|
associationId |
integer (int64) |
productId |
integer (int64) |
unitId |
integer (int64) |
3.7. BaseResponse
Name | Schema |
---|---|
data |
object |
depServiceStatusCode |
integer (int32) |
message |
< string > array |
statusCode |
integer (int32) |
3.8. BomFormulation
Name | Schema |
---|---|
associatedProducts |
< AssociatedProduct > array |
behaviors |
< string > array |
crossReferences |
< CrossReference > array |
effectiveDate |
string |
expirationDate |
string |
formulationCode |
string |
formulationDescription |
string |
formulationItems |
< FormulationItem > array |
producedQuantity |
number (double) |
producedQuantityPrecision |
integer (int32) |
producedQuantityUnitOfMeasureId |
integer (int64) |
propertyValues |
< PropertyValues > array |
schemaVersion |
integer (int64) |
3.9. ClockOffByOperatorEntryInfo
Clock Off User By Operator Data Transfer Object
Name | Description | Schema |
---|---|---|
operatorName |
Name of the User to be clocked off |
string |
segmentActualId |
Id of the segment actual that is to be clocked off |
integer (int64) |
3.11. CrossReference
Name | Schema |
---|---|
externalId |
string |
externalSystemId |
integer (int64) |
3.14. ExternalConfigResponse
Name | Schema |
---|---|
actionId |
integer (int64) |
actionName |
string |
actionType |
string |
actionTypeId |
integer (int64) |
configId |
integer (int64) |
createdBy |
string |
createdOn |
string |
data |
object |
deleted |
boolean |
id |
integer (int64) |
lastModifiedOn |
string |
updatedBy |
string |
3.15. ExternalConfigResponsePage
Name | Schema |
---|---|
content |
< ExternalConfigResponse > array |
links |
|
page |
3.16. FormulationItem
Name | Schema |
---|---|
appliesTo |
|
behaviors |
< string > array |
displayOrder |
integer (int32) |
itemId |
integer (int64) |
itemReference |
string |
locationId |
integer (int64) |
lotDescription |
string |
lowerTolerance |
number (double) |
lowerTolerancePrecision |
integer (int64) |
productCode |
string |
productDescription |
string |
productId |
integer (int64) |
propertyValues |
< PropertyValues > array |
quantity |
number (double) |
quantityPrecision |
integer (int32) |
scrapFactor |
number (double) |
substitutions |
< Substitution > array |
unitId |
integer (int64) |
unitName |
string |
unitOfMeasureId |
integer (int64) |
uomCode |
string |
uomDescription |
string |
upperTolerance |
number (double) |
upperTolerancePrecision |
integer (int64) |
3.17. FormulationItemsConsumption
Name | Schema |
---|---|
behaviors |
< string > array |
itemReference |
string |
lowerTolerance |
number (double) |
quantity |
number (double) |
quantityPrecision |
integer (int32) |
upperTolerance |
number (double) |
3.19. InputParamterRequest
Name | Schema |
---|---|
custom_property |
boolean |
input_mapping_key |
string |
input_parameter_data |
string |
input_parameter_id |
integer (int64) |
input_parameter_value |
string |
property_definition_data_type_id |
integer (int32) |
property_definition_data_type_name |
string |
property_definition_id |
string |
property_definition_initial_id |
string |
property_definition_initial_value |
string |
property_group_id |
string |
3.20. LaborPlan
Name | Schema |
---|---|
laborCodes |
< integer (int64) > array |
standardLaborPlan |
< LaborPlanItem > array |
3.21. LaborPlanItem
Name | Schema |
---|---|
basis |
enum (item, lot) |
laborPlanningTypeId |
integer (int64) |
time |
integer (int64) |
3.22. Line
Name | Description | Schema |
---|---|---|
assetId |
The asset ID |
integer (int64) |
isRouteEnabled |
Is this line route enabled. A route enabled line is ready to be used by the route service and has been properly configured. |
boolean |
links |
< Link > array |
|
name |
The name of the asset |
string |
type |
The type of the asset |
enum (Department, Line, Unit, Group, Variable, ProcessOrder) |
units |
Collection of Units belonging to this Line |
3.23. Link
Name | Schema |
---|---|
deprecation |
string |
href |
string |
hreflang |
string |
media |
string |
name |
string |
profile |
string |
rel |
string |
template |
|
templated |
boolean |
title |
string |
type |
string |
3.25. MaterialLotDetailsInfo
Name | Description | Schema |
---|---|---|
id |
Unique Identifier for the Material Lot |
integer (int64) |
name |
Name of the Lot |
string |
status |
Status of the Lot |
string |
workOrderId |
Unique Identifier for the WorkOrder |
integer (int64) |
3.26. PageMetadata
Page size and location information.
Name | Description | Schema |
---|---|---|
number |
Current page number. |
integer (int32) |
size |
Maximum number of resources on a page. |
integer (int32) |
totalElements |
Total number of resources in the paged collection. |
integer (int32) |
totalPages |
Total number of pages in the paged collection. |
integer (int32) |
3.27. PlannedUnit
Name | Schema |
---|---|
machinePlan |
|
peoplePlan |
|
unitId |
integer (int64) |
3.28. PrivilegeSet
Name | Schema |
---|---|
category |
string |
description |
string |
displayName |
string |
icon |
string |
id |
integer (int32) |
scope |
string |
3.29. ProductFamilyInfo
Product Family data transfer object
Name | Description | Schema |
---|---|---|
id |
Unique Identifier for the Product Family |
integer (int64) |
name |
Name of the Product Family |
string |
3.30. ProductInfo
Product data transfer object
Name | Description | Schema |
---|---|---|
familyId |
Family to which the product belongs |
integer (int64) |
id |
Unique Identifier for the Product |
integer (int64) |
isSerialized |
Is Serialized |
boolean |
name |
Name of the Product |
string |
3.32. Substitution
Name | Schema |
---|---|
conversionFactor |
number (double) |
productCode |
string |
productDescription |
string |
productId |
integer (int64) |
quantity |
number (double) |
quantityPrecision |
integer (int32) |
substitutionOrder |
integer (int32) |
uom |
integer (int64) |
uomCode |
string |
uomDescription |
string |
3.33. TabConfigData
Name | Schema |
---|---|
authentication |
boolean |
enable_seriallot |
boolean |
external_url |
string |
tab_input_parameters |
< InputParamterRequest > array |
3.35. TargetMaterialLotDetailsInfo
Name | Description | Schema |
---|---|---|
id |
Unique Identifier for the Target Material Lot |
integer (int64) |
lotIdentifier |
Name of the lot identifier |
string |
productId |
Applied product id for the Target Material Lot |
integer (int64) |
3.36. TemplateVariable
Name | Schema |
---|---|
description |
string |
name |
string |
type |
enum (, ?, &, /, #, *) |
3.37. Unit
Name | Description | Schema |
---|---|---|
assetId |
The asset ID |
integer (int64) |
isInventoryUnit |
Is this unit an inventory unit. A inventory unit is a storage unit. |
boolean |
isVirtual |
Is this unit a virtual unit. A virtual unit is a tracking unit. It doesn’t have physical assets associated with it. |
boolean |
lineId |
The line this unit belongs to |
integer (int64) |
links |
< Link > array |
|
name |
The name of the asset |
string |
type |
The type of the asset |
enum (Department, Line, Unit, Group, Variable, ProcessOrder) |
unitRank |
This unit’s rank |
integer (int32) |
units |
Collection of Groups belonging to this Unit |
3.38. UnitCollection
Name | Schema |
---|---|
collection |
|
content |
< Unit > array |
links |
< Link > array |
3.39. UpdateLotIdentifierEntryinfo
Material lot identifier update object
Name | Description | Schema |
---|---|---|
lotIdentifier |
lotIdentifier for the WorkOrder |
string |
materialLotActualId |
MaterialLot Actual Id of the WorkOrder |
integer (int64) |
3.40. UriTemplate
Name | Schema |
---|---|
variableNames |
< string > array |
variables |
< TemplateVariable > array |
3.41. UserSettingRequest
Name | Description | Schema |
---|---|---|
appId |
integer (int32) |
|
data |
The application specific settings, Eg:- 'App Name' : {'property1' : 'value' , 'property2' : 'value'} } |
object |
viewName |
string |
3.42. UserSettingResponseResource
Name | Schema |
---|---|
appId |
integer (int32) |
data |
object |
defaultSetting |
boolean |
links |
< Link > array |
viewName |
string |
3.43. WorkOrder
Work order Data transfer object
Name | Description | Schema |
---|---|---|
cancelledOn |
Date that the work order was cancelled. |
string (date-time) |
completedBy |
The user that completed the work order. |
string |
completedOn |
Date that the work order was completed. |
string (date-time) |
createdBy |
User that created the work order. |
string |
createdOn |
Date that the work order was created. |
string (date-time) |
eTagValue |
Current ETag value of the work order resource |
string |
id |
Work Order ID. |
integer (int64) |
lastModifiedBy |
User that last modified the work order. |
string |
lastModifiedOn |
Date that the work order was last modified. |
string (date-time) |
name |
Work Order name. |
string |
plannedEndDate |
Planned end date for the work order. |
string (date-time) |
plannedQuantity |
The planned quantity to produce with this work order. |
integer (int32) |
plannedStartDate |
Planned start date for the work order. |
string (date-time) |
priority |
Relative priority of the work order. |
integer (int32) |
processOrderId |
Work order’s process order in the plant apps execution system. |
integer (int64) |
producedMaterialId |
Work order produced material ID. |
integer (int64) |
productionLineId |
Work order production line ID. |
integer (int64) |
readyOn |
Date that the work order was made ready. |
string (date-time) |
routeDefinitionId |
Refers to the route used to execute the work order. |
integer (int64) |
startedOn |
Date that the work order was started. |
string (date-time) |
status |
Status of the work order. |
string |
3.44. WorkOrderPage
Contains a page of resources and the links required to navigate over pages.
Name | Description | Schema |
---|---|---|
content |
Set of resources on the page. |
< WorkOrder > array |
page |
3.45. WorkOrderSegmentDefinitionInfo
Name | Schema |
---|---|
bomFormulation |
|
bomFormulationId |
integer (int64) |
eTagValue |
string |
lotStatus |
< MaterialLotDetailsInfo > array |
plannedLineId |
integer (int64) |
producedMaterialId |
integer (int64) |
schemaVersion |
integer (int32) |
segments |
< WorkOrderSegmentInfo > array |
structure |
object |
structureType |
string |
3.46. WorkOrderSegmentInfo
Segments data transfer object
Name | Description | Schema |
---|---|---|
appliesTo |
||
behaviors |
< string > array |
|
dataEntryPlans |
< integer (int64) > array |
|
description |
string |
|
documents |
< Document > array |
|
formulationItemsConsumption |
< FormulationItemsConsumption > array |
|
name |
string |
|
plannedUnits |
< PlannedUnit > array |
|
propertyValues |
< PropertyValues > array |
|
segmentId |
integer (int64) |
|
segmentOnHold |
boolean |
|
segmentType |
enum (group, route, segment) |
|
sequenceNumber |
Sequence Number of the Segment |
integer (int32) |
status |
Status of the segment derived from segment actuals |
string |
suggestedLaborTypes |
< integer (int64) > array |
|
toolCategoryIds |
< integer (int64) > array |
|
toolIds |
< integer (int64) > array |
3.47. WorkOrderUpdateInfo
WorkOrder data update object
Name | Description | Schema |
---|---|---|
eTagValue |
If Match Header for WorkOrder |
string |
plannedEndDate |
Planned end date for the WorkOrder |
string (date-time) |
plannedStartDate |
Planned start date for the WorkOrder |
string (date-time) |
priority |
Relative priority of the WorkOrder |
integer (int32) |
4. Security
4.1. access_token
Type : oauth2
Flow : accessCode
Token URL : https://localhost/uaa/oauth/authorize
Token URL : https://localhost/uaa/oauth/token
Name | Description |
---|---|
default |
Default oauth2 scope. |
4.2. resource_owner
Type : oauth2
Flow : password
Token URL : https://localhost/uaa/oauth/token
Name | Description |
---|---|
default |
Default oauth2 scope. |
4.3. implicit_grant
Type : oauth2
Flow : implicit
Token URL : https://localhost/uaa/oauth/authorize
Name | Description |
---|---|
default |
Default oauth2 scope. |
4.4. client_creds
Type : oauth2
Flow : application
Token URL : https://localhost/uaa/oauth/token
Name | Description |
---|---|
default |
Default oauth2 scope. |