JOC API

/inventory/repository/store

POST

stores configurations to a local repository in ./resources/joc/repositories

Parameters in the POST body schema

Name	Type	Description	Example	Default
`controllerId`	optional, string	ControllerId of the controller the configurations are deployed to. Required if a specific version of a configuration has to be stored in the local repository.	"controllerId" : "testsuite"
`rollout`	required anyOf(`rollout`, `local`), object	Filter collection of configuration objects to add or update, specified by their paths and object types.	"rollout" : { "draftConfigurations" : [{ ...example see below... ], "deployConfigurations" : [{ ...example see below... ] "releasedConfigurations" : [{ ...example see below... ] }
`draftConfigurations`	required anyOf(`draftConfigurations`, `deployConfigurations`), array	An array of draft configuration of deployable objects.
`configuration`	required, object	A configuration or a Folder specified by its `path` and `objectType`. If draft configurations are specified by a folder, all draft items from the folder will be processed.	"configuration" : { "path" : "/myWorkflows/ifElseWorkflow/workflow_10", "objectType" : "WORKFLOW" }
`path`	required, string		"path" : "/myWorkflows/ifElseWorkflow/workflow_10"
`objectType`	required, string	Subset of deployable objects from the enum ConfigurationType. The subset consist of WORKFLOW, NOTICEBOARD, LOCK, FILEORDERSOURCE and FOLDER.	"objectType" : "WORKFLOW"
`recursive`	optional, boolean	Decides if a given folder should be processed recursively.	"recursive" : true	false
`deployConfigurations`	required anyOf(`draftConfigurations`, `deployConfigurations`), array	An array of deployed configuration objects.
`configuration`	required, object	An deployed configuration specified by its `path`, `objectType` and `commitId` OR a folder specified by `path` and `objectType` only. If deployed configurations are specified by a folder, all latest deployments of the items from the folder will be processed.	"configuration" : { "path" : "/myWorkflows/ifElseWorkflow/workflow_12", "objectType" : "WORKFLOW", "commitId" : "4273b6c6-c354-4fcd-afdb-2758088abe4a" }
`path`	required, string
`objectType`	required, enum	see above.
`commitId`	required, string	The `commitId` of the deployment of the deployed configuration. If no commitId is set the latest deployment of the configuration will be processed.	"commitId" : "4273b6c6-c354-4fcd-afdb-2758088abe4a"
`recursive`	optional, boolean	Decides if a given folder should be processed recursively.	"recursive" : true	false
`releasedConfigurations`	required anyOf(`draftConfigurations`, `deployConfigurations`, `releasedConfigurations`), array	An array of deployed configuration objects.
`configuration`	required, object	A released configuration specified by its `path` and `objectType`. If released configurations are specified by a folder, all released items from the folder will be processed.	"configuration" : { "path" : "/mySchedules/ifElseWorkflows/schedule_if_else_1", "objectType" : "SCHEDULE" }
`path`	required, string
`objectType`	required, enum	see above.
`recursive`	optional, boolean	Decides if a given folder should be processed recursively.	"recursive" : true	false
`local`	required anyOf(`rollout`, `local`), object	Filter collection of deployed objects to delete, specified by their paths and object types. All selected objects will be deleted from all known controllers, not just from the selected ones.	"local" : { "draftConfigurations" : [{ ...example see below... ], "deployConfigurations" : [{ ...example see below... ] "releasedConfigurations" : [{ ...example see below... ] }
`draftConfigurations`	required anyOf(`draftConfigurations`, `deployConfigurations`, `releasedConfigurations`), array	An array of draft configuration of deployable objects.
`configuration`	required, object	A configuration or a Folder specified by its `path` and `objectType`. If draft configurations are specified by a folder, all draft items from the folder will be processed.	"configuration" : { "path" : "/myWorkflows/ifElseWorkflow/workflow_10", "objectType" : "WORKFLOW" }
`path`	required, string		"path" : "/myWorkflows/ifElseWorkflow/workflow_10"
`objectType`	required, string	Configuration objects from the enum ConfigurationType.	"objectType" : "WORKFLOW"
`recursive`	optional, boolean	Decides if a given folder should be processed recursively.	"recursive" : true	false
`deployConfigurations`	required anyOf(`draftConfigurations`, `deployConfigurations`, `releasedConfigurations`), array	An array of deployed configuration objects.
`configuration`	required, object	A deployed configuration specified by its `path`, `objectType` and `commitId` OR a folder specified by `path` and `objectType` only. If deployed configurations are specified by a folder, all latest deployments of the items from the folder will be processed.	"configuration" : { "path" : "/myWorkflows/ifElseWorkflow/workflow_12", "objectType" : "WORKFLOW", "commitId" : "4273b6c6-c354-4fcd-afdb-2758088abe4a" }
`path`	required, string
`objectType`	required, enum	see above.
`commitId`	required, string	The `commitId` of the deployment of the deployed configuration. If no commitId is set the latest deployment of the configuration will be processed.	"commitId" : "4273b6c6-c354-4fcd-afdb-2758088abe4a"
`recursive`	optional, boolean	Decides if a given folder should be processed recursively.	"recursive" : true	false
`releasedConfigurations`	required anyOf(`draftConfigurations`, `deployConfigurations`, `releasedConfigurations`), array	An array of deployed configuration objects.
`configuration`	required, object	A released configuration specified by its `path` and `objectType`. If released configurations are specified by a folder, all released items from the folder will be processed.	"configuration" : { "path" : "/mySchedules/ifElseWorkflows/schedule_if_else_1", "objectType" : "SCHEDULE" }
`path`	required, string
`objectType`	required, enum	see above.
`recursive`	optional, boolean	Decides if a given folder should be processed recursively.	"recursive" : true	false
`auditLog`	optional, object	Object that contains `comment`, `timeSpent` and `ticketLink`.	{ "comment":"Operational requirement!", "timeSpent":2 }
`comment`	optional, string	Field in `auditLog` to comment this action, e.g. the reason.
`timeSpent`	optional, integer	Field in `auditLog` to enter the time spent in minutes.	5
`ticketLink`	optional, string	Field in `auditLog` to enter a link to a corresponding ticket.

Request

Name

Description

Example

Type

Constraints

Default

Headers

X-Access-Token*

Request requires authentication!

550e8400-e29b-11d4-a716-446655440000

string

Body

application/json

model | example

{
    "title": "Filter To Copy To Repository",
    "$schema": "http://json-schema.org/draft-04/schema#",
    "javaType": "com.sos.joc.model.publish.repository.CopyToFilter",
    "type": "object",
    "anyOf": [{
        "required": [
            "rollout"
        ]
    }, {
        "required": [
            "local"
        ]
    }],
    "properties": {
        "controllerId": {
            "type": "string",
            "pattern": "^[^/\\<>?:\"|*]*$",
            "maxLength": 100
        },
        "rollout": {
            "javaType": "com.sos.joc.model.publish.repository.EnvIndependentConfigurations",
            "type": "object",
            "anyOf": [{
                "required": [
                    "draftConfigurations"
                ]
            }, {
                "required": [
                    "deployConfigurations"
                ]
            }],
            "properties": {
                "draftConfigurations": {
                    "type": "array",
                    "items": {
                        "javaType": "com.sos.joc.model.publish.Config",
                        "type": "object",
                        "required": [
                            "configuration"
                        ],
                        "properties": {
                            "configuration": {
                                "javaType": "com.sos.joc.model.publish.Configuration",
                                "type": "object",
                                "required": [
                                    "path",
                                    "objectType"
                                ],
                                "properties": {
                                    "path": {
                                        "description": "absolute path of an object.",
                                        "type": "string",
                                        "pattern": "^(/|(/[^/\\\\<>?:\"|*]+)+)$",
                                        "maxLength": 255,
                                        "minLength": 1
                                    },
                                    "objectType": {
                                        "javaType": "com.sos.joc.model.inventory.common.ConfigurationType",
                                        "type": "string",
                                        "enum": [
                                            "FOLDER",
                                            "WORKFLOW",
                                            "JOBCLASS",
                                            "JOBRESOURCE",
                                            "LOCK",
                                            "NOTICEBOARD",
                                            "FILEORDERSOURCE",
                                            "WORKINGDAYSCALENDAR",
                                            "NONWORKINGDAYSCALENDAR",
                                            "SCHEDULE",
                                            "JOB"
                                        ]
                                    },
                                    "commitId": {
                                        "type": "string",
                                        "pattern": "^[^<>]*$",
                                        "maxLength": 255
                                    },
                                    "recursive": {
                                        "type": "boolean",
                                        "default": false
                                    }
                                }
                            }
                        }
                    }
                },
                "deployConfigurations": {
                    "type": "array",
                    "items": {
                        "javaType": "com.sos.joc.model.publish.Config",
                        "type": "object",
                        "required": [
                            "configuration"
                        ],
                        "properties": {
                            "configuration": {
                                "javaType": "com.sos.joc.model.publish.Configuration",
                                "type": "object",
                                "required": [
                                    "path",
                                    "objectType"
                                ],
                                "properties": {
                                    "path": {
                                        "description": "absolute path of an object.",
                                        "type": "string",
                                        "pattern": "^(/|(/[^/\\\\<>?:\"|*]+)+)$",
                                        "maxLength": 255,
                                        "minLength": 1
                                    },
                                    "objectType": {
                                        "javaType": "com.sos.joc.model.inventory.common.ConfigurationType",
                                        "type": "string",
                                        "enum": [
                                            "FOLDER",
                                            "WORKFLOW",
                                            "JOBCLASS",
                                            "JOBRESOURCE",
                                            "LOCK",
                                            "NOTICEBOARD",
                                            "FILEORDERSOURCE",
                                            "WORKINGDAYSCALENDAR",
                                            "NONWORKINGDAYSCALENDAR",
                                            "SCHEDULE",
                                            "JOB"
                                        ]
                                    },
                                    "commitId": {
                                        "type": "string",
                                        "pattern": "^[^<>]*$",
                                        "maxLength": 255
                                    },
                                    "recursive": {
                                        "type": "boolean",
                                        "default": false
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "local": {
            "javaType": "com.sos.joc.model.publish.repository.EnvRelatedConfigurations",
            "type": "object",
            "anyOf": [{
                "required": [
                    "draftConfigurations"
                ]
            }, {
                "required": [
                    "deployConfigurations"
                ]
            }, {
                "required": [
                    "releasedConfigurations"
                ]
            }],
            "properties": {
                "draftConfigurations": {
                    "type": "array",
                    "items": {
                        "javaType": "com.sos.joc.model.publish.Config",
                        "type": "object",
                        "required": [
                            "configuration"
                        ],
                        "properties": {
                            "configuration": {
                                "javaType": "com.sos.joc.model.publish.Configuration",
                                "type": "object",
                                "required": [
                                    "path",
                                    "objectType"
                                ],
                                "properties": {
                                    "path": {
                                        "description": "absolute path of an object.",
                                        "type": "string",
                                        "pattern": "^(/|(/[^/\\\\<>?:\"|*]+)+)$",
                                        "maxLength": 255,
                                        "minLength": 1
                                    },
                                    "objectType": {
                                        "javaType": "com.sos.joc.model.inventory.common.ConfigurationType",
                                        "type": "string",
                                        "enum": [
                                            "FOLDER",
                                            "WORKFLOW",
                                            "JOBCLASS",
                                            "JOBRESOURCE",
                                            "LOCK",
                                            "NOTICEBOARD",
                                            "FILEORDERSOURCE",
                                            "WORKINGDAYSCALENDAR",
                                            "NONWORKINGDAYSCALENDAR",
                                            "SCHEDULE",
                                            "JOB"
                                        ]
                                    },
                                    "commitId": {
                                        "type": "string",
                                        "pattern": "^[^<>]*$",
                                        "maxLength": 255
                                    },
                                    "recursive": {
                                        "type": "boolean",
                                        "default": false
                                    }
                                }
                            }
                        }
                    }
                },
                "deployConfigurations": {
                    "type": "array",
                    "items": {
                        "javaType": "com.sos.joc.model.publish.Config",
                        "type": "object",
                        "required": [
                            "configuration"
                        ],
                        "properties": {
                            "configuration": {
                                "javaType": "com.sos.joc.model.publish.Configuration",
                                "type": "object",
                                "required": [
                                    "path",
                                    "objectType"
                                ],
                                "properties": {
                                    "path": {
                                        "description": "absolute path of an object.",
                                        "type": "string",
                                        "pattern": "^(/|(/[^/\\\\<>?:\"|*]+)+)$",
                                        "maxLength": 255,
                                        "minLength": 1
                                    },
                                    "objectType": {
                                        "javaType": "com.sos.joc.model.inventory.common.ConfigurationType",
                                        "type": "string",
                                        "enum": [
                                            "FOLDER",
                                            "WORKFLOW",
                                            "JOBCLASS",
                                            "JOBRESOURCE",
                                            "LOCK",
                                            "NOTICEBOARD",
                                            "FILEORDERSOURCE",
                                            "WORKINGDAYSCALENDAR",
                                            "NONWORKINGDAYSCALENDAR",
                                            "SCHEDULE",
                                            "JOB"
                                        ]
                                    },
                                    "commitId": {
                                        "type": "string",
                                        "pattern": "^[^<>]*$",
                                        "maxLength": 255
                                    },
                                    "recursive": {
                                        "type": "boolean",
                                        "default": false
                                    }
                                }
                            }
                        }
                    }
                },
                "releasedConfigurations": {
                    "type": "array",
                    "items": {
                        "javaType": "com.sos.joc.model.publish.Config",
                        "type": "object",
                        "required": [
                            "configuration"
                        ],
                        "properties": {
                            "configuration": {
                                "javaType": "com.sos.joc.model.publish.Configuration",
                                "type": "object",
                                "required": [
                                    "path",
                                    "objectType"
                                ],
                                "properties": {
                                    "path": {
                                        "description": "absolute path of an object.",
                                        "type": "string",
                                        "pattern": "^(/|(/[^/\\\\<>?:\"|*]+)+)$",
                                        "maxLength": 255,
                                        "minLength": 1
                                    },
                                    "objectType": {
                                        "javaType": "com.sos.joc.model.inventory.common.ConfigurationType",
                                        "type": "string",
                                        "enum": [
                                            "FOLDER",
                                            "WORKFLOW",
                                            "JOBCLASS",
                                            "JOBRESOURCE",
                                            "LOCK",
                                            "NOTICEBOARD",
                                            "FILEORDERSOURCE",
                                            "WORKINGDAYSCALENDAR",
                                            "NONWORKINGDAYSCALENDAR",
                                            "SCHEDULE",
                                            "JOB"
                                        ]
                                    },
                                    "commitId": {
                                        "type": "string",
                                        "pattern": "^[^<>]*$",
                                        "maxLength": 255
                                    },
                                    "recursive": {
                                        "type": "boolean",
                                        "default": false
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "auditLog": {
            "javaType": "com.sos.joc.model.audit.AuditParams",
            "type": "object",
            "properties": {
                "comment": {
                    "type": "string",
                    "pattern": "^[^<>]*$",
                    "maxLength": 255
                },
                "timeSpent": {
                    "type": "integer",
                    "minimum": 0
                },
                "ticketLink": {
                    "type": "string",
                    "pattern": "^[^<>]*$",
                    "maxLength": 255
                }
            }
        }
    }
}

{ "controllerId": "testsuite", "rollout": { "draftConfigurations": [{ "configuration": { "path": "/ProductDemo/CyclicExecution/pdCyclicSerialWorkflow", "objectType": "WORKFLOW" } }], "deployConfigurations": [{ "configuration": { "path": "/ProductDemo/AdmissionTimes/pdAdmissionTimeJob2", "objectType": "WORKFLOW", "commitId": "0a4b2077-6912-4a98-b5f1-799af9c1d90a" } }] }, "local": { "draftConfigurations": [{ "configuration": { "path": "/ProductDemo/CyclicExecution/pdCyclicSerialWorkflow", "objectType": "SCHEDULE" } }], "releasedConfigurations": [{ "configuration": { "path": "/ProductDemo/CyclicExecution/pdCyclicAllDays", "objectType": "WORKINGDAYSCALENDAR" } }] } }

{
    "controllerId": "testsuite",
    "rollout": {
        "draftConfigurations": [{
            "configuration": {
                "path": "/ProductDemo/CyclicExecution/pdCyclicSerialWorkflow",
                "objectType": "WORKFLOW"
            }
        }],
        "deployConfigurations": [{
            "configuration": {
                "path": "/ProductDemo/AdmissionTimes/pdAdmissionTimeJob2",
                "objectType": "WORKFLOW",
                "commitId": "0a4b2077-6912-4a98-b5f1-799af9c1d90a"
            }
        }]
    },
    "local": {
        "draftConfigurations": [{
            "configuration": {
                "path": "/ProductDemo/CyclicExecution/pdCyclicSerialWorkflow",
                "objectType": "SCHEDULE"
            }
        }],
        "releasedConfigurations": [{
            "configuration": {
                "path": "/ProductDemo/CyclicExecution/pdCyclicAllDays",
                "objectType": "WORKINGDAYSCALENDAR"
            }
        }]
    }
}

Responses

Code	Description	Body
200	Confirm store successfully	application/json model \| example { "title": "ok answer", "$schema": "http://json-schema.org/draft-04/schema#", "javaType": "com.sos.joc.model.common.Ok", "type": "object", "required": [ "deliveryDate", "ok" ], "properties": { "deliveryDate": { "description": "Value is UTC timestamp in ISO 8601 YYYY-MM-DDThh:mm:ss.sZ or empty", "type": "string", "format": "date-time" }, "surveyDate": { "description": "Value is UTC timestamp in ISO 8601 YYYY-MM-DDThh:mm:ss.sZ or empty", "type": "string", "format": "date-time" }, "ok": { "type": "boolean" } } } { "deliveryDate": "2020-05-05T21:13:35Z", "ok": true } { "deliveryDate": "2020-05-05T21:13:35Z", "ok": true }
401	Unauthorized!	application/json model \| example { "title": "authentication", "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "required": [ "isAuthenticated" ], "properties": { "user": { "type": "string" }, "accessToken": { "type": "string" }, "message": { "type": "string" }, "role": { "type": "string" }, "isAuthenticated": { "type": "boolean" }, "isPermitted": { "type": "boolean", "default": false }, "sessionTimeout": { "type": "integer", "default": 1800 }, "enableTouch": { "type": "boolean", "default": true } } } { "user": "root", "message": "Oops!", "isAuthenticated": false, "isPermitted": false } { "user": "root", "message": "Oops!", "isAuthenticated": false, "isPermitted": false }
403	Forbidden! The user doesn't have sufficient permissions for 'store'	application/json model \| example { "title": "authentication", "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "required": [ "isAuthenticated" ], "properties": { "user": { "type": "string" }, "accessToken": { "type": "string" }, "message": { "type": "string" }, "role": { "type": "string" }, "isAuthenticated": { "type": "boolean" }, "isPermitted": { "type": "boolean", "default": false }, "sessionTimeout": { "type": "integer", "default": 1800 }, "enableTouch": { "type": "boolean", "default": true } } } { "user": "root", "message": "You don't have sufficient permissions for ...", "role": "all", "isAuthenticated": true, "isPermitted": false } { "user": "root", "message": "You don't have sufficient permissions for ...", "role": "all", "isAuthenticated": true, "isPermitted": false }
420	'store' failed!	application/json model \| example { "title": "error object with delivery date", "$schema": "http://json-schema.org/draft-04/schema#", "javaType": "com.sos.joc.model.common.Err420", "type": "object", "required": [ "deliveryDate", "error" ], "properties": { "deliveryDate": { "description": "Value is UTC timestamp in ISO 8601 YYYY-MM-DDThh:mm:ss.sZ or empty", "type": "string", "format": "date-time" }, "surveyDate": { "description": "Value is UTC timestamp in ISO 8601 YYYY-MM-DDThh:mm:ss.sZ or empty", "type": "string", "format": "date-time" }, "error": { "javaType": "com.sos.joc.model.common.Err", "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } } { "deliveryDate": "2016-05-05T21:13:35Z", "surveyDate": "2016-05-05T21:13:33Z", "error": { "code": "JOC-420", "message": "store failed!" } } { "deliveryDate": "2016-05-05T21:13:35Z", "surveyDate": "2016-05-05T21:13:33Z", "error": { "code": "JOC-420", "message": "store failed!" } }
440	Login Timeout! The client's session has expired and must log in again.	application/json model \| example { "title": "authentication", "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "required": [ "isAuthenticated" ], "properties": { "user": { "type": "string" }, "accessToken": { "type": "string" }, "message": { "type": "string" }, "role": { "type": "string" }, "isAuthenticated": { "type": "boolean" }, "isPermitted": { "type": "boolean", "default": false }, "sessionTimeout": { "type": "integer", "default": 1800 }, "enableTouch": { "type": "boolean", "default": true } } } { "user": "root", "message": "Session has expired. Please log in again", "role": "all", "isAuthenticated": false, "isPermitted": false } { "user": "root", "message": "Session has expired. Please log in again", "role": "all", "isAuthenticated": false, "isPermitted": false }