Difference between revisions of "Custom Tasks"

From Lingoport Wiki
Jump to: navigation, search
(Setting up AtTask (WorkFront))
(Setting up AtTask (WorkFront))
Line 91: Line 91:
 
</before-send-locale>
 
</before-send-locale>
 
</pre>
 
</pre>
<pre style="background:ivory; color:blue; margin-bottom:0px; margin-top:0px; border-style:none">
+
<pre style="color:blue; margin-bottom:0px; margin-top:0px; border-style:none">
 
<after-send-locale>
 
<after-send-locale>
 
<task url="file:"
 
<task url="file:"
Line 104: Line 104:
 
</before-notify-changes>
 
</before-notify-changes>
 
</pre>
 
</pre>
<pre style="background:ivory; color:blue; margin-bottom:0px; margin-top:0px; border-style:none">
+
<pre style="color:blue; margin-bottom:0px; margin-top:0px; border-style:none">
 
<before-late-prep-kits>
 
<before-late-prep-kits>
 
<task url="file:"
 
<task url="file:"
Line 117: Line 117:
 
</before-import-locale>
 
</before-import-locale>
 
</pre>
 
</pre>
<pre style="background:ivory; color:blue; margin-bottom:0px; margin-top:0px; border-style:none">
+
<pre style="color:blue; margin-bottom:0px; margin-top:0px; border-style:none">
 
<after-import-locale>
 
<after-import-locale>
 
<task url="file:"
 
<task url="file:"

Revision as of 16:50, 28 April 2016

Custom Tasks

The config_custom_tasks.xml configuration file contains the specific stages where a plugin can be called. Dynamic information is available to the plugin through the LRM Context object (com.lingoport.lrm.customtask.LRMContext). The lrm-customtasktest.jar, located in the samples/CustomTask/ folder of your install directory, contains methods for testing out these different stages.

Configuration

The config_custom_tasks.xml has elements for each stage of the LRM process that allows for custom tasks. The stages are:

custom-tasks>
	<stages>
		<prep-kit>
			<before-send-locale>
			    <!-- Tasks that will run BEFORE files are uploaded to the specified L10n Vendor -->
                        </before-send-locale>
			<after-send-locale>
			     <!-- Tasks that will run AFTER files have been successfully uploaded to the specified L10n Vendor -->
			</after-send-locale>
		</prep-kit>
		<notification>
			<before-notify-changes>	
			    <!-- Tasks that will run BEFORE the Notify Changes email is sent -->					   
			</before-notify-changes>
			<before-late-prep-kits>
			    <!-- Tasks that will run BEFORE the Late Prep Kit email is sent -->
			</before-late-prep-kits>
		</notification>
		<import-kit>
			<before-import-locale>
                            <!-- Tasks that will run BEFORE files for a specific locale are imported -->
			</before-import-locale>
			<after-import-locale>
			     <!-- Tasks that will run AFTER files for a specific locale have been imported successfully -->
			</after-import-locale>
		</import-kit>
	</stages>
</custom-tasks>

Syntax of Task element

The task element has the following attributes:

  • url - the location of the jar file that contains the custom task
  • class - the class library that is to be used
  • method - the method that is to be called. This method has either no arguments or the com.lingoport.lrm.customtask.LRMContext argument.
  • onerrorresumenext - if false then the process continues if there is an error that is thrown. If true then the process will stop with an error.

Example using the lrm-customtasktest.jar located in the install directory under samples/CustomTask

<task url="file:/C:/Lingoport/LRM-Server-3.0/samples/CustomTask/lrm-customtasktest.jar"
     class="com.lingoport.lrm.customtask.test.CustomTaskTest" 
     method="testNoArgs"
     onerrorresumenext="true"/>

LRM Context Argument

The com.lingoport.lrm.customtask.LRMContext argument is a map containing dynamic information for a particular stage. You can view the information that is contained in the LRMContext object for each of the custom task stages by adding the following task to each stage (changing the location of your LRM home if needed). The following is an example of adding a task to the <before-notify-changes> stage:

<before-notify-changes>	
   <task url="file:/var/lib/jenkins/lingoport/lrm-server-3.0/samples/CustomTask/lrm-customtasktest.jar"
         class="com.lingoport.lrm.customtask.test.CustomTaskTest" 
         method="testLRMContextArg"
         onerrorresumenext="true"/>
</<before-notify-changes>

The log file will contain the LRMContext information.

Sample Custom Tasks

The lrm-customtest.jar located in the install directory's sample/CustomTask folder contains 3 methods that can used for testing.

  • testNoArgs - this method has no arguments.
  • testLRMContextArg - this method has the com.lingoport.lrm.customtask.LRMContext argument and will list out all the information in the LRMContext object.
  • testThrowError - this method will throw an error. Depending on the value of attribute 'onerrorresumenext' the process will either stop or continue.

Setting up AtTask (WorkFront)

The creation of AtTask projects require the setup of both the config_attask.properties and the config_custom_tasks.xml configuration files.

Global Configuration Files contains the information for configuring the config_attask.properties file in order for projects and task to be created.

The following methods allow for the interaction between LRM and AtTask (Workfront)

  • createAtTaskProjectForLocale - this method creates an AtTask project, if it doesn't exist, for a prep kit and then adds a task that represents the locale. This method will be called after a kit for a locale has been successfully uploaded to the specified L10n vendor.
  • updateDueDatesFromAtTask - this method checks the AtTask due date for a particular task. If it's changed then the LRM due date will be changed to match the AtTask due date. The date change will be reflected in the Dashboard. This method will be called when determining if the Late Prep Kit email needs to be sent.
  • setAtTaskToComplete - this method sets the AtTask task to complete. This method will be called after a kit for a locale has been successfully imported.

The sample config_custom_tasks.xml located in the install directory's deploy\templates\dir_structure\global\config folder contains the structure for the implementation of AtTask. The structure is:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<custom-tasks>
	<stages>
		<prep-kit>
			<before-send-locale>
	
			</before-send-locale>
			<after-send-locale>
				<task url="file:" 
				class="com.lingoport.lrm.customtask.CustomTaskController" method="createAtTaskProjectForLocale"  
				onerrorresumenext="false"/>
                        </after-send-locale>
		</prep-kit>
		<notification>
			<before-notify-changes>	
			</before-notify-changes>
			<before-late-prep-kits>
			       <task url="file:"  
				class="com.lingoport.lrm.customtask.CustomTaskController" method="updateDueDatesFromAtTask"  
				onerrorresumenext="false"/>
			</before-late-prep-kits>
		</notification>
		<import-kit>
			<before-import-locale>
			</before-import-locale>
			<after-import-locale>
			<task url="file:" 
				class="com.lingoport.lrm.customtask.CustomTaskController" method="setAtTaskToComplete"  
				onerrorresumenext="false"/>
			</after-import-locale>
		</import-kit>
	</stages>
</custom-tasks>