An open API service indexing awesome lists of open source software.

https://github.com/byndyusoft/camunda-process-instances-migrator

Console application for Camunda's process instances migrations between versions of BPMN schemes
https://github.com/byndyusoft/camunda-process-instances-migrator

camunda-bpm migrator nodejs

Last synced: 2 months ago
JSON representation

Console application for Camunda's process instances migrations between versions of BPMN schemes

Awesome Lists containing this project

README

        

# camunda-process-instances-migrator

[![npm@latest](https://img.shields.io/npm/v/@byndyusoft/camunda-process-instances-migrator/latest.svg)](https://www.npmjs.com/package/@byndyusoft/camunda-process-instances-migrator)
[![test workflow](https://github.com/Byndyusoft/camunda-process-instances-migrator/actions/workflows/test.yaml/badge.svg?branch=master)](https://github.com/Byndyusoft/camunda-process-instances-migrator/actions/workflows/test.yaml)
[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)
[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)

Console application for Camunda's process instances migrations between versions of BPMN schemes.

## Requirements

- Node.js v12 LTS or later
- npm or yarn

## Running locally

### Environment

You must initialize `process.env` before start migrator:

```javascript
process.env.INTEGRATIONS_CAMUNDA_API_BASE_URI; #required
process.env.INTEGRATIONS_CAMUNDA_COOKIE; #optional
process.env.PROCESS_DEFINITION_NAME; #required
process.env.SOURCE_PROCESS_DEFINITION_VERSION; #optional
process.env.TARGET_PROCESS_DEFINITION_VERSION; #optional
```

Service can be run locally using the following commands.

```bash
yarn install
yarn start
```

## Usage

### Migrate instances of all processes from all versions to the latest

```javascript
PROCESS_DEFINITION_NAME = ALL;
```

### Migrate instances of the specified process from all versions to the latest

```javascript
PROCESS_DEFINITION_NAME =
```

### Migrate instances of the specified process from version 1 to the latest

```javascript
PROCESS_DEFINITION_NAME =
SOURCE_PROCESS_DEFINITION_VERSION = 1
```

### Migrate instances of the specified process from version 1 to version 2

```javascript
PROCESS_DEFINITION_NAME =
SOURCE_PROCESS_DEFINITION_VERSION = 1
TARGET_PROCESS_DEFINITION_VERSION = 2
```

## Maintainers

- [@Byndyusoft/owners](https://github.com/orgs/Byndyusoft/teams/owners) <>
- [@Byndyusoft/team](https://github.com/orgs/Byndyusoft/teams/team)

## License

This repository is released under version 2.0 of the
[Apache License](https://www.apache.org/licenses/LICENSE-2.0).