projects/{did}/documents/offline/export (POST)
Export documents from a project to a bilingual format for the purpose of translation in CAT tools other than Wordbee. Export formats are XLIFF, Microsoft Word and Microsoft Excel.
The result is a ZIP archive that contains:
An XLIFF, Word or Excel file per each selected/ticked project document.
An optional TMX file with the top memory hits.
An optional Excel file with word count details.
You may want to “initialise” an export first, see projects/{did}/documents/offline/export/init (GET) . This provides useful information and default options for the importing.
URL
(POST) /api/projects/{pid}/documents/offline/export
PARAMETERS
The URL parameters are:
pid | The project ID | int, Mandatory |
The body must contain a JSON object with these properties:
documents | An array of the project documents to export. See table further down. To enumerate documents for a project, you have different options:
Example for getting the first 100 documents in project 229: (POST) .../api/resources/files/list
BODY:
{ "skip": 0, "take": 100, "scope": { "type": "Project", "projectid": 229 }} Obviously you can apply filters on file names, extensions, languages and so forth.
| object[], Mandatory |
format | The output format. Must be one of these strings:
| string, Mandatory |
includeComments | Boolean, default is false. If true then the document will include existing comments that are attached to the translation. | bool?, Optional |
includeMemoryHits | Boolean, default is false. If true, then the top memory hits are included with each segment in the document. | bool?, Optional |
createTmxFile | Boolean, default is false. If true, then a TMX file (“TM.tmx“) is created and included in the exported ZIP archive. It contains the top memory hits of all the exported files. This option can be set independently of includeMemoryHits | bool?, Optional |
includeCustomFields | Boolean, default is false. If true, then the exported file includes all custom fields of the segment. Supported by XLIFF export format only. | bool?, Optional |
createExcelReport | Boolean, default is true. If true, then the exported ZIP archive includes an Excel (“Summary.xlsx“) that lists all exported documents with various details such as the word count, the file name, the online editor URL and other useful information. | bool?, Optional |
callbackurl, callback | Specify a URL which will be called upon success or failure of operation. This makes polling for operation status unnecessary. | Optional |
The documents collection is an array of objects with these properties:
did | The document ID. This must be a document in the project. | int, Mandatory |
src | The source locale. It is required to specify the source locale. In most cases this will simply be the project source locale but you can even choose a target locale or versioned locale in the context of back translation workflows. | string, Mandatory |
trg | The target locale. | string, Mandatory |
Note: By default you cannot export more than 50 documents at a time. Please use projects/{did}/documents/offline/export/init (GET) to get the applicable limit.
RESULTS
The API method returns an Asynchronous operation result:
{
"trm": {
"requestid":32230,
"status":"Waiting",
"statusText":"Waiting..."
}
}
You can poll the status or use the callback parameter. When the operation is complete, the results are in the custom property
The custom property is a JSON object:
filetoken | The file token to download a ZIP archive with the exported XLIFF, Word or Excel files, the optional summary Excel and the optional TMX. The exported files are grouped in folders by their source/target languages. Usemedia/get/{token} to download the ZIP file. Example archive: The en.de folder contains all exported files for this language combination: The archive entries are the original file names plus the language combination appended at the end. The Summary.xlsx file (if option is enabled), lists the exported documents:
| string |
filename | The name of the ZIP archive. For information only. | string |
documents | A JSON listing all the exported documents. The format is the same as that of property documents (see parameters section in this document) but includes archive, which is the relative path inside the ZIP. The latter comes in handy if you need to automate the extraction of files from the archive. Example: | object |
Copyright Wordbee - Buzzin' Outside the Box since 2008