User guide

Create translation project

To create a new translation project for Sitecore content:

1. Select the item from the Sitecore Content Editor items tree and click on Avilinga Translate at the Versions tab.

Note: The latest version of the current language is used as the source for the translation.

2. Confirm the item selection in the Items tree, add or remove any additional items, and set the checkbox Also translate all sub-items of each selected item if necessary. Click the Next button.

3. Select the Target Language(s) for the translation. Language groups can be used to facilitate language selection. Click Next.

4. Set the following translation project details:

- Type in Project title to identify the project in the Avilinga portal and Sitecore Avilinga Translation Connector page.

- Select Workflow from options available in your Avilinga account.

- Select Cost Centre from the cost centers associated with your Avilinga API user.

- Uncheck Automatically approve quote to require quotation approval on the Avilinga portal or the Sitecore Avilinga Translation Connector page before launch.

- Add additional Notes if required.

- Click the Next or Create Project button (depends on your project settings).

5. In the case of quote approval to be done automatically, the Delivery on or before request will appear. Select required delivery date and time and click Create Project.

Note: If the selected delivery date and time require additional Rush fee, the confirmation will appear.

Translate from Experience Editor

In the case Sitecore Experience Editor is used for content authoring, the option to send the content for translation instantly from the Experience Editor is available.

To do this, open the Versions tab and click the Avilinga Translate button.

The rest of the process is as described in the Create translation project section

Translate from Avilinga Translations

The Sitecore Avilinga Translation Connector page provides another flexible way to create a translation project:

1. In the Sitecore Desktop menu go to Avilinga Translations.

2. Click on the New Translation Project button.

3. Select the items for translation and set the checkbox Also translate all sub-items of each selected item if required. Click the Next button.

4. Select the Source Language and the Target Language(s) for the translation project and click Next.

Note: The latest version of the selected source language is used as the source for the translation.

The rest of the process is as described in the Create translation project section

List of translation projects

Each active Sitecore translation project will appear in the Avilinga portal and on the Sitecore Avilinga Translation Connector page immediately after the creation. To review and manage translation projects:

1. In the Sitecore Desktop menu go to Avilinga Translations.

2. The Translation Projects page displays the list of all active Sitecore Avilinga Translation Projects, the breakdown per language for the selected project, the buttons to manage the selected translation project if any action is available.

Note: The projects list updates once per the Translation Projects Sitecore page load. To update the list, reload the page with the browser reload button.

Quote approval

The translation projects list displays the total price of the project in QUOTE status. The detailed quote is available on the Avilinga portal.

To approve the quote from the Sitecore Avilinga Translation Projects page:

1. Select the project with QUOTE status and click the Launch button.

Note: The Delete button removes the project from the Sitecore list and the Avilinga system.

2. Select required Delivery on or before date and time and click Launch.

Note: Whether the selected delivery date and time require additional Rush fee, the confirmation will appear.

Receiving translations

Completed translations are automatically retrieved by Avilinga Translation Connector for Sitecore with a default interval of 15 minutes. To change the interval of automatic translation retrieval:

- Open Content Editor and navigate to the /sitecore/System/Tasks/Schedules/Avilinga/Fetch item.

- Change required interval in the Schedule field.

- Click the Save button.

Note: Use Sitecore schedule format for the field.

Note: The minimal possible interval for any Sitecore scheduled task is 10 minutes. Any lower value is interpreted as 10 minutes.

It is possible to retrieve the translation manually before the automated task runs or if the automated task is disabled.

To retrieve translation manually:

1. In the Sitecore Desktop menu go to Avilinga Translations.

2. On the Translations Projects page select the project with COMPLETE or PARTIALLY COMPLETE status.

Note: If the partially completed project selected, the bottom table should contain at least one language with COMPLETED status.

Click the Fetch completed languages button.

Note: If the project is retrieved successfully, it disappears from the Projects list. Retrieved translation project records are available on the Avilinga portal and in the Sitecore database.

Projects history

The list of active and completed translation projects is recorded in the Sitecore master database. To get the information about the projects:

- Navigate to Sitecore Content Editor.

- Open the /sitecore/Avilinga Translation Projects folder.

- Every item named as an ID of the translation project associated with the ID of the project on the Avilinga portal. The child nodes of the item are the target language codes.

- The fields of the target language code item contain the Avilinga Language in ISO 639 format, the Status, and the list of Items sent to the translation within the translation project.

- Every item in the /sitecore/Avilinga Translation Projects/Archive folder is a record for already retrieved project.