integrationArtifactResource¶
Add, Delete or Update an resource file of integration flow designtime artifact
Description¶
With this step you can either add, delete or update a resource of integration flow designtime artifact using the OData API. Learn more about the SAP Cloud Integration remote API for managing an resource of integration flow artifact here.
Usage¶
We recommend to define values of step parameters via .pipeline/config.yml file.
In this case, calling the step is essentially reduced to defining the step name.
Calling the step can be done either in an orchestrator specific way (e.g. via a Jenkins library step) or on the command line.
library('piper-lib-os')
integrationArtifactResource script: this
piper integrationArtifactResource
Prerequisites¶
Parameters¶
Overview - Step¶
Name | Mandatory | Additional information |
---|---|---|
apiServiceKey | (yes) | pass via ENV or Jenkins credentials (cpiApiServiceKeyCredentialsId ) |
integrationFlowId | yes | |
operation | yes | |
resourcePath | yes | |
script | (yes) | reference to Jenkins main pipeline script |
verbose | no | activates debug output |
Overview - Execution Environment¶
Orchestrator-specific only
These parameters are relevant for orchestrator usage and not considered when using the command line option.
Name | Mandatory | Additional information |
---|---|---|
Details¶
apiServiceKey¶
Service key JSON string to access the Process Integration Runtime service instance of plan 'api'
Scope | Details |
---|---|
Aliases | - |
Type | string |
Mandatory | yes |
Default | $PIPER_apiServiceKey (if set) |
Secret | yes |
Configuration scope |
|
Resource references | Jenkins credential id: id: cpiApiServiceKeyCredentialsId reference to: apiServiceKey |
integrationFlowId¶
Specifies the ID of the Integration Flow artifact
Scope | Details |
---|---|
Aliases | - |
Type | string |
Mandatory | yes |
Default | $PIPER_integrationFlowId (if set) |
Secret | no |
Configuration scope |
|
Resource references | none |
operation¶
Specifies the operation(create/update/delete) for resource file of the Integration Flow artifact
Scope | Details |
---|---|
Aliases | - |
Type | string |
Mandatory | yes |
Default | $PIPER_operation (if set) |
Possible values | - create - update - delete |
Secret | no |
Configuration scope |
|
Resource references | none |
resourcePath¶
Specifies integration artifact resource file relative path.
Scope | Details |
---|---|
Aliases | - |
Type | string |
Mandatory | yes |
Default | $PIPER_resourcePath (if set) |
Secret | no |
Configuration scope |
|
Resource references | none |
script¶
Jenkins-specific: Used for proper environment setup.
The common script environment of the Jenkinsfile running. Typically the reference to the script calling the pipeline step is provided with the this
parameter, as in script: this
. This allows the function to access the commonPipelineEnvironment
for retrieving, e.g. configuration parameters.
Scope | Details |
---|---|
Aliases | - |
Type | Jenkins Script |
Mandatory | yes |
Default | |
Secret | no |
Configuration scope |
|
Resource references | none |
verbose¶
verbose output
Scope | Details |
---|---|
Aliases | - |
Type | bool |
Mandatory | no |
Default | false |
Possible values | - true - false |
Secret | no |
Configuration scope |
|
Resource references | none |
cpiApiServiceKeyCredentialsId¶
Jenkins-specific: Used for proper environment setup. See using credentials for details.
Jenkins secret text credential ID containing the service key to the Process Integration Runtime service instance of plan 'api'
Scope | Details |
---|---|
Aliases | - |
Type | string |
Configuration scope |
|
Example¶
Example configuration for the use in a Jenkinsfile
.
integrationArtifactUpload script: this
Example for the use in a YAML configuration file (such as .pipeline/config.yaml
).
steps:
<...>
integrationArtifactResource:
cpiApiServiceKeyCredentialsId: 'MY_API_SERVICE_KEY'
integrationFlowId: 'MY_INTEGRATION_FLOW_ID'
operation: 'Create_OR_Modify_Delete_INTEGRATION_FLOW_Artifact_Resource'
resourcePath: 'MY_INTEGRATION_FLOW_Artifact_Resource_Relative_Path'