Translate the description

Use case

Translate the description of the issue to English using the DeepL REST API.

Prerequisites

In Jira administration > Manage apps > Remote actions > Connections, create a new connection and name it.

Set the following base URL.

https://api-free.deepl.com/v2

If you are already have a DeepL API Pro plan, use the following base URL instead.

https://api.deepl.com/v2

Select No authentication as authentication method.

Configuration

Add the Execute remote action post function to the transition of your choice.

Action

In Expert mode, create a new action with the following parameters:

Name

Enter Translate description as the name of the new action.

Method

Select the POST method.

Default connection

Select the connection with DeepL.

REST path.

Use the following REST path after replacing nnnnn-nnnnn with the authorization key from your DeepL account.

/translate?auth_key=nnnnn-nnnnn

Action body

Enter this action body.

{
	"text": ["%{{replaceAll(htmlToTxt(wikiToHTML(%{issue.description})), "\"", "'")}}"],
    "target_lang": "EN"
}

The target language of the translation can be edited by changing the value of the "target_lang" key according to the DeepL specifications.

Update issue fields

Update a Text Field (multi-line).

Select the option Set field value manually (parser expression).

Enter the following expression with the expression editor in General mode.

%{action.response.translations[*].text}

Related use cases

Use case	Workflow function	Parser functions
Automatically create a version when starting the release	Execute remote action
Automatically link an issue to an external one	Execute remote action
Automatically log work on a Jira issue	Execute remote action	dateTimeToString()
Clone issue in external instance	Execute remote action
Create a comment on an external Jira ticket	Execute remote action
Create a component to group issues related to UI design	Execute remote action
Create a new employee account during an onboarding process	Execute remote action
Create an external project for a new employee during an onboarding process	Execute remote action
Create an overview page for a software release	Execute remote action
Create a personal space for a new employee	Execute remote action
Create Confluence page with links to issues	Execute remote action
Get attributes of Assets objects	Execute remote action
Get Checklist	Execute remote action
Get Hubspot contact information	Execute remote action
Link a Jira issue with the corresponding release ticket	Execute remote action
Notify the reporter of an issue about its status by a Telegram message	Execute remote action
Read the information from a Trello card	Execute remote action
Retrieve the assets of an issue in Jira cloud	Execute remote action
Set Checklist	Execute remote action
Set the assignee of an external issue same as the transitioned issue	Execute remote action
Transition an external Jira ticket based on the linked internal one	Execute remote action
Translate the description	Execute remote action	replaceAll() wikiToHTML() htmlToTxt()