View source for On Boarding a project with both LRM and Globalyzer

= OBSOLETE =


= Before On Boarding a project with both LRM and Globalyzer= 
To on-board a project, a some basic information is needed:

=== Code Repository Location ===

* The code repository location and branch for the project. 
* Git locations could look like: https://github.com/group/project ; In addition, the branch for the Git project is needed.
* SVN locations could look like: https://svn.group.com/project/trunk.
* <b>Read and Write Access</b> granted to repository.
* The code repository should contain the Project Definition File for Globalyzer. 

== Globalyzer ==

Lingoport has created a [[Pre_Flight_Check|Pre-flight Check]] for Globalyzer.  Before on boarding a Globalyzer project, please do the pre-flight check.

=== Globalyzer Scan Information ===

* The directories and files to be scanned, as well as what should not be scanned, like code libraries. 
* The rulesets to be used to scan the source code.
* A Globalyzer Project file is created with this information and put in the code repository.

== LRM ==

=== Users ===

* The list of translation requesters. Those members to add to Jenkins so they have permission to trigger the Prep Kit job: <code> username1@company.org, username2@companyname.com </code>
* The list of emails to be notified of the LRM actions:  <code> username1@company.org, username2@companyname.com, username3@companyname.com </code> Note: All emails will also be used as Dashboard user identifiers. 

=== Locales ===

* The locale of the files created by developers and to be translated
* The list of target translation locales 
* The pseudo-locale

=== Resource File types ===

* Files types (for instance .properties, .resx, etc.).  For more information on Resource file types and what is supported, please see [[Resource Files]]
* Naming convention for the base file: for instance '''<filename>_en.properties''' or '''<filename>.properties''' 
* The directory structure for the resource files. 
* Translated file naming convention: for instance '''<filename>_fr_FR.properties'''
* The files or directories which follow the above convention but should NOT be translated. For instance **/config*.properties

=== Localization Vendor ===
* Who is the translation management system and how are the resource files going to be transferred to them?  
* Lingoport supports Local vendors, FTP and SFTP, and WorldServer and Lingotek and also other vendors.

= On Boarding the LRM and Globalyzer Automation Job =

== Jenkins ==
=== Create the Jenkins job ===
To begin the on-boarding process, go to Jenkins, and select the '''1-Automation''' Tab, and '''New Item''' 

[[File:automation_tab_new_item.jpg|700px]]

* Make a copy of <code>Lingoport.SampleLiteLRM</code> 
* Set the name of the new job to '''<groupname>.<projectname>'''
* Make sure '''Add to current view''' is checked and select '''OK'''

=== Configure the Jenkins job ===

==== General ====
[[File:GeneralTab.png|700px]]

*'''General''' section: Select the GitHub project and fill in the Project url
*'''Throttle Current Builds''' should be checked.
*'''LRM Throttle''' should be checked.

==== Source Code Management ====
[[File:source_code_management.jpg|700px]]

'''Source Code Management''' section: Set up the Repository, Credentials, and Branch.  For example if the Git repository is Acme/myproject and the code to work with is in the 'development' branch, then set the Repository URL to '''<nowiki>https://github.com/Acme/myproject.git</nowiki>'''.  It is often easy to copy this from GitHub.  For the branch, make sure to define it as '''*/development'''.  If the '*/' is left off, there will be problems.

==== Build Triggers ====
[[File:BuildTriggers.png|700px]]

These are left unchecked by default, but the '''Build Periodically''' can be set to build on a repeating basis.

==== Build Environment ====
[[File:BuildEnvironment.png|700px]]

Leave these unchecked.

==== Build ====

[[File:BuildLiteLRM.png|700px]]
* '''Run Globalyzer Lite''': Globalyzer requires a Project Definition File.  Is is recommended that this is put in the repository in a lingoport folder, although it can be anywhere as long as it can be found. Here is an example of a [[Globalyzer_CI/CD_(Continuous_Integration_and_Continuous_Delivery)#Project_Definition_Format |Project Definition File]].
* The '''Top Level Directory''' is defaulted to look at the whole repository.  If the resource files are located under a resources directory, this can be changed to '''<code>$WORKSPACE/resources</code>''' . 
* '''Locales''' are defaulted to common values.  Remove and add locales to get the appropriate translation languages.  '''Pseudo locale''' defaults to 'eo'.
* '''Copy Settings''': Use this if you have a project already set up with a similar configuration.  This can save configuration time.  If there is no other project, just leave it unfilled.
* Check the '''Send Unique File Names''' if you want the prep kit files to have unique file names. The default is not to send unique file names. If you have multiple file names that have the same name you may want to check the box. For more information see [[LRM_Unique_File_Names|LRM Unique File Names]].
* Advanced: '''Detect Errors''': It is unlikely you need to change the default settings. 
** '''Missed Translation Error''': (Default: Unchecked) If you check this box, when a string is returned back from translation with the same text as the original one, an error will be raised. Be cautious with this check: Population for instance is the same word in English and in French.
** '''Parameter Mismatch Error''': (Default: Checked) Keep this check if you'd like to make sure that when a parameter(s) is (are) sent in a text, say "Hello {userName}", the same parameter(s) is (are) sent back untranslated. If the French translation is "Bonjour {nom d'utilisateur}", the 'userName' variable cannot be replaced at run time in the application.



[[File:Build2.png|700px]]

*  You can have more than one file extension. For example, you may have .json file and .properties files in the same repository. '''For each file''' extension, fill in or modify the following fields:
** Extension: the resource file extension, for instance properties (without the '.'), json, resx, etc.
** Filename Pattern: 
*** The <code>*</code> (star) character represents the filename without the extension or the locales; 
*** <code>l</code> represents the locale's language, for instance 'fr' for French
*** <code>c</code> represents the locale's country, for instance 'FR' for France
*** <code>v</code> represents the locale's variant. That's less frequent.  is the variant. 
** A few examples may help: 
*** <code>*_l_c_v</code>: If a target locale is '''fr_FR''' and '''messages_en.properties''' needs to be translated, the French file will be '''message_fr_FR.properties'''
*** <code>*.l-c-v</code>: If a target locale is '''fr_FR''' and '''messages.resx''' needs to be translated, the French file will be '''messages.fr-FR.resx'''
*** <code>*-l-c-v</code>: If a target locale is '''fr_FR''' and '''messages-en.json''' needs to be translated, the French file will be '''messages-fr-FR.json'''
* The sample at the bottom shows what the system is going to look for resource files.  Verify that the resource files look like the example, otherwise errors could occur. 
* For the other entries, leave them defaulted unless told to change them.

[[File:Build3.png|700px]]

* '''Directories''': Which directories and files to include and which ones to exclude as resource files. 
* '''Emails''': Who will be receiving emails for which notification

[[File:Build4.png|700px]]
* The L10n Vendor can be configured in Jenkins, Manage Jenkins or in the project.  Also a project can have a different value than other projects in the same group.

==== Post Build Actions ====
* Nothing needs to be modified in this section

Select the '''Save''' button.  '''Enable''' the project and '''Build Now'''.  The Jenkins project should run and push the results to the Lingoport Dashboard.

For more information, see [[Project Configuration Files]]

= Verifying the Automation Job =

The Jenkins job should complete successfully and populate the Lingoport Dashboard.

To check if it completed successfully, select the project and look at the '''Build History'''

[[File:BuildHistory.jpg|500px]]

The indicator should look like a blue ball.  If it is a red ball, select it to go to '''Console Output''' and look for errors.  



[[File:DashboardLiteLRM.png|700px]]

If the indicator is blue, then login to the Lingoport Dashboard and verify that the project is on the Dashboard. If you select the project and go to the overview page, both the Resource Manager and Globalyzer Summaries will have data. 

If there are problems at this point, please contact '''support@lingoport.com''' for assistance.

== Set up the "send to translate" URL on the Dashboard ==
Finally, if this is the first project on the Dashboard, the URL for Jenkins needs to be configured. 
# Select '''Administration''' on the top of the Dashboard.
# Select '''Lingoport''' in the left side menu
# Scroll down to '''Resource Manager''' and '''Jenkins URL'''
# Enter the URL for Jenkins and '''Save'''. 

[[File:JenkinsURL.png|600px]]


Returning to the Resource Manager page, the '''Send to translate''' button should be populated in the '''Next Send Translation Content''' area. If there are "no files to prep and send for translation", the button will not appear. 

[[File:JenkinsURLSendToTranslate.png|600px]]

= Next Steps =

The following are optional helper jobs for LRM projects.   

The Nightly job, checks the status of projects on a nightly basis and sends out notifications. 

The PrepKit job will send the projects files to be translated.  This can also be done from the Dashboard. 

*[[On Boarding the Nightly Job]]
*[[On Boarding the Prep Kit Job]]