How to deliver translations in Sitecore

There are two ways of delivering translations once they are ready:

• Automated delivery via a scheduled task
• Manual delivery

Automated delivery via a scheduled task

The Sitecore extension installation package adds a Scheduled Task to Sitecore which enables automated translation delivery to the website. Configuration of a scheduled task is recommended to be carried out by your IT team. 

How to set up automated delivery via a scheduled task

To navigate to the scheduled task:

 

1. Switch to the Sitecore core database.

 

 

2. Open the Content editor. 

 

In the Localization tab, navigate to the System/Tasks/Schedules/Schedule Localization Delivery.

 

This is a standard Sitecore scheduler and you can set it up when and how frequently you want to check and deliver completed translations.

 

To do this, you need to modify the Schedule field.

 

 

Here is an instruction on how to fill in this field:

 

Value format: {start timestamp}|{end timestamp}|{days to run bit pattern}|{interval}

 

• Start timestamp and End timestamp: Determines the start and end of the scheduled task. Format is the Sitecore ISO datetime, YearMonthDayTHoursMinutesSeconds. Example: 20000101T000000 = January 1st 2000 at 00:00:00.

• Days to run: A 7-bit pattern determining which days the task must run: 1 = Sunday 2 = Monday 4 = Tuesday 8 = Wednesday 16 = Thursday 32 = Friday 64 = Saturday So, 127 means to run the task every day. To run the task on Saturday and Sunday, add the 2 values, 1+64 = 65.
• Interval: How long time between each run. 00:05:00 means that the task will run with 5-minute intervals.

 

Scheduler agent configuration

Update the config file to make Sitecore determine when the task runner should run:

 

<scheduling>

<frequency>00:05:00</frequency>

<agent type="Sitecore.Tasks.DatabaseAgent" method="Run" interval="00:05:00">

<param desc="database">master</param>

<param desc="schedule root">/sitecore/system/Tasks/Schedules</param>

<LogActivity>true</LogActivity>

</agent>

</scheduling>

 

The frequency setting determines when the global Sitecore task runner should run at all.

 

The agent determines when the tasks configured in the master database at the root /sitecore/system/Tasks/Schedules should run.

 

In the example above, the task runner runs every 5 minutes, checking the config file for tasks to run. It will then run the agent with 5-minute intervals. If another task is running, it could block the task runner, delaying the agent from running.

 

Manual delivery

You can manually deliver completed translations to the website. This option can be used when you want to receive translations immediately.

Delivering all translations

1. Navigate to the Localization tab in Content Editor or Experience Editor. Click the Deliver All button.

2. Confirm the action in the modal window.

Delivering specific translations 

1. Navigate to the Localization tab in Content Editor or Experience Editor.

2. Go to the Jobs in the Selected item section or in All items section depending on whether you need to get translations of the selected item or several ones. 

3. Check the jobs with Ready to deliver status and click Get translations.

Use the Status filter to quickly find the jobs with completed but not delivered translations.