Drupal 10 Connector and Plugin

High-level Overview

The Drupal Connector for Bureau Works uses a plugin architecture and the Translation Management Tool module (TMGMT) in Drupal to perform the diverse operations to manage translation projects between the CMS and Bureau Works.

Package

Bureau Works is providing a package to install the Drupal Plugin on page 3 of this document.

Current Dependencies:

1. Drupal 10
   
   
2. TMGMT Plugin Framework for Translation Projects

Installation

1. Install TMGMT
   
   
   Use URL: https://ftp.drupal.org/files/projects/tmgmt-8.x-1.15.tar.gz
   
   
   
   
2. Install the Bureau Works plugin with the same method, but instead of using a URL, upload the following package:

Bureau Works Drupal Plugin

3. Enable TMGMT and Bureau Works in the newly created section of the Translation options under the Extend section.
   
   
   
   
4. Click “Extend” from the toolbar and search for “Bureau”. Check “Bureau Works” and press “Install”. This operation will install and enable the plugin module.
   
   
5. Go to “Translation” > “Providers” and select “Add provider” to add a new provider or click "Edit" next to the existing Bureau Works provider (if already set up).
   
   

6. Add the provider label description and select “Bureau Works” in the “Provider Plugin” box.
   
   
7. The Bureau plugin settings box contains details specific to the provider:
   
   
   1. API Endpoint: the Bureau Works URL (demo.bureauworks.com)
      
      
   2. Access Key: the Key ID that can be acquired on your Profile page by clicking on “Profile” > accessing the tab “Security” > and then clicking on “Generate”
      
      
   3. Secret Key: the secret to the ID
      
      
   4. Org Unit UUID: this is where the ID of the Organization Unit will be in Bureau Works (please refer to the screenshot below). Projects created with this configuration will be set up on the specified Organization Unit and all its inherent configurations.

8. Specify language mappings at “Remote languages mappings” and finish the translator configuration with “Save”.

Adding Content for Translation

1. Go to Translation / Sources
   
   
2. Sources are "nodes" in Drupal - pages, blog posts, etc. You can select nodes for translation on the languages mapped in the Plugin for the Provider.
   
   Select the Nodes you want to translate, along with the Target Languages and select Request Translation.
   
   
3. Fill in the data necessary for the project creation. In the end, click on "Submit to provider and continue". This step will create a project in Bureau Works.
   
   

Managing Projects in Bureau Works

When projects are requested from the provider, they are presented in Bureau Works:

The Work Units created by the request step in Drupal are accessible in the project and can be visualized and translated in Bureau Works's Editor.

Support for managing projects and all other aspects of Bureau Works can be provided in a separate set of guides and tutorials.

Fetching Translations

Once all jobs in Bureau Works have been completed (the translation process has been concluded) and the Project has been marked as Delivered, the Translations will be ready to be fetched

You can find the submitted work under Translation / Jobs:

Click on "Manage" to open a given Job.

Click on Fetch Translations to download that job in Drupal.

Click on View to open Drupal Editor where you can preview the Translation: