Denys Vuika ea2c0ce229
[PRODENG-211] integrate JS-API with monorepo (part 1) (#9081)
* 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
2023-11-21 05:27:51 -05:00

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

AppDefinitionRepresentation

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

AppDefinitionRepresentation

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

AppDefinitionRepresentation

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

Return type

AppDefinitionUpdateResultRepresentation