Skip to content

IBM-Cloud/gp-ucd-plugin

Repository files navigation

IBM Globalization Pipeline plug-in for UrbanCode Deploy

What is this?

IBM Globalization Pipeline is an IBM Bluemix service that provides rapid machine translation for application developers. The IBM Globalization Pipeline plug-in for UrbanCode Deploy integrates this service as an UrbanCode Deploy component that provides machine translation within your existing build and deploy process. Using your English resource files as input, the service provides real-time machine translation for the following languages: Simplified Chinese, Traditional Chinese, French, German, Italian, Japanese, Korean, Portuguese, Spanish, and Arabic. The machine translation output can be leveraged by invoking the RESTful API or downloading the translations.

See also the UrbanCode plugin page for this plugin.

Download

Binary downloads are available here: releases

Installation

See Installing plug-ins in UrbanCode Deploy and follow the steps for installing an automation plug-in.

Usage

The IBM Globalization Pipeline plug-in for UrbanCode Deploy contains two processes that need to be configured.

TranslateV2

Description

This process is for configuring the parameters that will be used to translate your resource files. With the Globalization Pipeline plug-in for UrbanCode Deploy, you can create bundles, upload source files, and download translated files.

Parameters

  • Job Type is the job that will be run.
    CREATE is currently the only supported job type.

  • Input pattern is the expression that is used to identify the source files to be translated.
    For example: *_en.properties will match all files that end with _en.properties.

  • Source folder is used to define the folder where source files can be found.
    If not specified, the working folder will be selected by default.

  • Download translation Select this option to download the translations to the source folder that is specified.

  • Target languages

    • select languages in service dashboard (Default option)

      It will create the bundle without any language and user can go to the bluemix globalization pipeline dashboard to add target languages.

    • translate into all languages

      It will call the bluemix globalization pipeline service API to get the available languages for the instance.

  • Bluemix credential

    Globalization Pipeline service credential, eg: {"credentials": { "url": "*", "userId": "*","password": "*", "instanceId": "*" }}'

History

Version 1

The following features are included in the initial beta release of the plug-in:

  • Automatically request translation during the deployment
  • Retrieve translations in real time without managing the resource files
  • Easily add new languages without having to build or deploy

Support

Any questions about the use of this service can be posted to the developerWorks Answers site using the tag "Globalization".

This plug-in is based on the Globalization Pipeline Java Client which is a recommended integration method for the IBM Globalization Pipeline service.