* integrate JS-API with monorepo * [ci:force] fix token issue [ci:force] migrate docs folder [ci:force] clean personal tokens * [ci:force] gha workflow support * [ci:force] npm publish target * fix js-api test linting * [ci:force] fix test linting, mocks, https scheme * [ci:force] fix https scheme * [ci:force] typescript mappings * [ci:force] update scripts * lint fixes * linting fixes * fix linting * [ci:force] linting fixes * linting fixes * [ci:force] remove js-api upstream and corresponding scripts * [ci:force] jsdoc fixes * fix jsdoc linting * [ci:force] jsdoc fixes * [ci:force] jsdoc fixes * jsdoc fixes * jsdoc fixes * jsdoc fixes * [ci:force] fix jsdoc * [ci:force] reduce code duplication * replace 'chai' expect with node.js assert * replace 'chai' expect with node.js assert * [ci:force] remove chai and chai-spies for js-api testing * [ci:force] cleanup and fix imports * [ci:force] fix linting * [ci:force] fix unit test * [ci:force] fix sonar linting findings * [ci:force] switch activiti api models to interfaces (-2.5% reduction of bundle) * [ci:force] switch activiti api models to interfaces * [ci:force] switch AGS api models to interfaces * [ci:force] switch AGS api models to interfaces * [ci:force] switch search api models to interfaces * [ci:force] switch content api models to interfaces where applicable
11 KiB
AppdefinitionsApi
All URIs are relative to /activiti-app/api
Method | HTTP request | Description |
---|---|---|
deleteAppDefinition | DELETE /enterprise/app-definitions/{appDefinitionId} | deleteAppDefinition |
exportAppDefinition | GET /enterprise/app-definitions/{modelId}/export | Export an app definition |
getAppDefinition | GET /enterprise/app-definitions/{modelId} | Get an app definition |
importAndPublishApp | POST /enterprise/app-definitions/publish-app | importAndPublishApp |
importAndPublishApp | POST /enterprise/app-definitions/{modelId}/publish-app | importAndPublishApp |
importAppDefinition | POST /enterprise/app-definitions/import | Import a new app definition |
updateAppDefinition | POST /enterprise/app-definitions/{modelId}/import | Update the content of an existing app |
publishAppDefinition | POST /enterprise/app-definitions/{modelId}/publish | Publish an app definition |
updateAppDefinition | PUT /enterprise/app-definitions/{modelId} | Update an app definition |
deleteAppDefinition
deleteAppDefinition(appDefinitionId)
deleteAppDefinition
Example
import AppdefinitionsApi from 'src/api/activiti-rest-api/docs/AppDefinitionsApi';
import {AlfrescoApi} from '@alfresco/js-api';
this.alfrescoApi = new AlfrescoApi();
this.alfrescoApi.setConfig({
hostEcm: 'http://127.0.0.1:8080'
});
let appdefinitionsApi = new AppdefinitionsApi(this.alfrescoApi);
appdefinitionsApi.deleteAppDefinition(appDefinitionId).then(() => {
console.log('API called successfully.');
}, function (error) {
console.error(error);
});
Parameters
Name | Type | Description | Notes |
---|---|---|---|
appDefinitionId | number | appDefinitionId |
Return type
null (empty response body)
exportAppDefinition
exportAppDefinition(modelId)
Export an app definition
This will return a zip file containing the app definition model and all related models (process definitions and forms).
Example
import AppdefinitionsApi from 'src/api/activiti-rest-api/docs/AppDefinitionsApi';
import {AlfrescoApi} from '@alfresco/js-api';
this.alfrescoApi = new AlfrescoApi();
this.alfrescoApi.setConfig({
hostEcm: 'http://127.0.0.1:8080'
});
let appdefinitionsApi = new AppdefinitionsApi(this.alfrescoApi);
appdefinitionsApi.exportAppDefinition(modelId).then(() => {
console.log('API called successfully.');
}, function (error) {
console.error(error);
});
Parameters
Name | Type | Description | Notes |
---|---|---|---|
modelId | number | modelId from a runtime app or the id of an app definition model |
Return type
null (empty response body)
getAppDefinition
AppDefinitionRepresentation getAppDefinition(modelId)
Get an app definition
Example
import AppdefinitionsApi from 'src/api/activiti-rest-api/docs/AppDefinitionsApi';
import {AlfrescoApi} from '@alfresco/js-api';
this.alfrescoApi = new AlfrescoApi();
this.alfrescoApi.setConfig({
hostEcm: 'http://127.0.0.1:8080'
});
let appdefinitionsApi = new AppdefinitionsApi(this.alfrescoApi);
appdefinitionsApi.getAppDefinition(modelId).then((data) => {
console.log('API called successfully. Returned data: ' + data);
}, function (error) {
console.error(error);
});
Parameters
Name | Type | Description | Notes |
---|---|---|---|
modelId | number | Application definition ID |
Return type
importAndPublishApp
AppDefinitionUpdateResultRepresentation importAndPublishApp(file)
importAndPublishApp
Example
import AppdefinitionsApi from 'src/api/activiti-rest-api/docs/AppDefinitionsApi';
import {AlfrescoApi} from '@alfresco/js-api';
this.alfrescoApi = new AlfrescoApi();
this.alfrescoApi.setConfig({
hostEcm: 'http://127.0.0.1:8080'
});
let appdefinitionsApi = new AppdefinitionsApi(this.alfrescoApi);
appdefinitionsApi.importAndPublishApp(file).then((data) => {
console.log('API called successfully. Returned data: ' + data);
}, function (error) {
console.error(error);
});
Parameters
Name | Type | Description | Notes |
---|---|---|---|
file | Blob | file |
Return type
AppDefinitionUpdateResultRepresentation
importAndPublishApp
AppDefinitionUpdateResultRepresentation importAndPublishApp(modelIdfile)
importAndPublishApp
Example
import AppdefinitionsApi from 'src/api/activiti-rest-api/docs/AppDefinitionsApi';
import {AlfrescoApi} from '@alfresco/js-api';
this.alfrescoApi = new AlfrescoApi();
this.alfrescoApi.setConfig({
hostEcm: 'http://127.0.0.1:8080'
});
let appdefinitionsApi = new AppdefinitionsApi(this.alfrescoApi);
appdefinitionsApi.importAndPublishApp(modelIdfile).then((data) => {
console.log('API called successfully. Returned data: ' + data);
}, function (error) {
console.error(error);
});
Parameters
Name | Type | Description | Notes |
---|---|---|---|
modelId | number | modelId | |
file | Blob | file |
Return type
AppDefinitionUpdateResultRepresentation
importAppDefinition
AppDefinitionRepresentation importAppDefinition(fileopts)
Import a new app definition
Allows a zip file to be uploaded containing an app definition and any number of included models.
This is useful to bootstrap an environment (for users or continuous integration).
Before using any processes included in the import the app must be published and deployed.
Example
import AppdefinitionsApi from 'src/api/activiti-rest-api/docs/AppDefinitionsApi';
import {AlfrescoApi} from '@alfresco/js-api';
this.alfrescoApi = new AlfrescoApi();
this.alfrescoApi.setConfig({
hostEcm: 'http://127.0.0.1:8080'
});
let appdefinitionsApi = new AppdefinitionsApi(this.alfrescoApi);
let opts = {
'renewIdmEntries': renewIdmEntries_example // | Whether to renew user and group identifiers
};
appdefinitionsApi.importAppDefinition(fileopts).then((data) => {
console.log('API called successfully. Returned data: ' + data);
}, function (error) {
console.error(error);
});
Parameters
Name | Type | Description | Notes |
---|---|---|---|
file | Blob | file | |
renewIdmEntries | string | Whether to renew user and group identifiers | [optional] [default to false] |
Return type
importAppDefinition
updateAppDefinition importAppDefinition(modelIdfile)
Update the content of an existing app
Imports an app inside an existing app definition and creates a new version
Before using any new or updated processes included in the import the app must be (re-)published and deployed.
Example
import AppdefinitionsApi from 'src/api/activiti-rest-api/docs/AppDefinitionsApi';
import {AlfrescoApi} from '@alfresco/js-api';
this.alfrescoApi = new AlfrescoApi();
this.alfrescoApi.setConfig({
hostEcm: 'http://127.0.0.1:8080'
});
let appdefinitionsApi = new AppdefinitionsApi(this.alfrescoApi);
appdefinitionsApi.updateAppDefinition(modelIdfile).then((data) => {
console.log('API called successfully. Returned data: ' + data);
}, function (error) {
console.error(error);
});
Parameters
Name | Type | Description | Notes |
---|---|---|---|
modelId | number | modelId | |
file | Blob | file |
Return type
publishAppDefinition
AppDefinitionUpdateResultRepresentation publishAppDefinition(modelIdpublishModel)
Publish an app definition
Publishing an app definition makes it available for use. The application must not have any validation errors or an error will be returned.
Before an app definition can be used by other users, it must also be deployed for their use
Example
import AppdefinitionsApi from 'src/api/activiti-rest-api/docs/AppDefinitionsApi';
import {AlfrescoApi} from '@alfresco/js-api';
this.alfrescoApi = new AlfrescoApi();
this.alfrescoApi.setConfig({
hostEcm: 'http://127.0.0.1:8080'
});
let appdefinitionsApi = new AppdefinitionsApi(this.alfrescoApi);
appdefinitionsApi.publishAppDefinition(modelIdpublishModel).then((data) => {
console.log('API called successfully. Returned data: ' + data);
}, function (error) {
console.error(error);
});
Parameters
Name | Type | Description | Notes |
---|---|---|---|
modelId | number | modelId | |
publishModel | AppDefinitionPublishRepresentation | publishModel |
Return type
AppDefinitionUpdateResultRepresentation
updateAppDefinition
AppDefinitionUpdateResultRepresentation updateAppDefinition(modelIdupdatedModel)
Update an app definition
Example
import AppdefinitionsApi from 'src/api/activiti-rest-api/docs/AppDefinitionsApi';
import {AlfrescoApi} from '@alfresco/js-api';
this.alfrescoApi = new AlfrescoApi();
this.alfrescoApi.setConfig({
hostEcm: 'http://127.0.0.1:8080'
});
let appdefinitionsApi = new AppdefinitionsApi(this.alfrescoApi);
appdefinitionsApi.updateAppDefinition(modelIdupdatedModel).then((data) => {
console.log('API called successfully. Returned data: ' + data);
}, function (error) {
console.error(error);
});
Parameters
Name | Type | Description | Notes |
---|---|---|---|
modelId | number | Application definition ID | |
updatedModel | AppDefinitionSaveRepresentation | updatedModel |