Automation Rules For Connector Content Translation

The Integration Automation feature allows Account Owners and Project Managers to schedule content to automatically be ingested into Smartling from a connecting platform, and batched into a Job based on a set of rules. You can also choose to authorize the Job automatically for translation.

The content that is ingested for translation is based on the filters used in the rules. There are different filters for each of the applicable connectors.

Automation settings are applicable to the following Connectors:

1. Mindtouch
2. Contentful (field-level only)
3. Akeneo
4. Shopify 

The Drupal 8/9/10/11 TMGMT Connector supports automated Job creation through Drupal Continuous Jobs.

How To Create a Job Automation Rule

1. Go to Account Settings > Integrations
2. Click the Automation tab
   
   
   • From here you can view all rules created and create new rules.
3. Click Create Rule, and insert the following:
   • Choose a Project to apply the rule to from the dropdown list of projects.
     • Choose from any Mindtouch or Contentful projects you have set up
   • Rule Name (required): this is the name of the rule as it will appear in the list of automation rules
   • Job Name Prefix (required): This is the prefix that will be attached to the name of the Job created, together with the date and timestamp of when the Job is created. 
   • Job Description: Give your Job a meaningful description for translators.
   • Schedule (required): Decide when you want the Job to be created, and the frequency.
     • Frequency options include; weekly, fortnightly, every 3 weeks, or every month.
     • You can also be specific about the day of the week, date of the month, and time at which the Job is created.
     • Alternatively, instead of an exact time, you can decide that the Job should be created every hour, every 3 hours, every 6 hours, or every 12 hours.
   • Languages: Select the languages you want to content translated into.
     • Only content that is not authorized across all the selected locales will be captured.
   • Authorize for Translation: Set to ON if you want to automatically authorize the Job for translation.
     • If enabled, you can choose the workflow each language will use for translation.

Contentful Filters

You can refine the content that is included in the automation rule by the following filters:

1. Contentful Space: A space is a workspace that contains all content and media for a project. It has its own content model.
2. Asset Type: Choose between the supported content types, media assets and entries.
3. Content Type: Choose any of your content or mime types
4. Contentful Status: Choose to ingest content that's in a specific state in Contentful
5. Smartling Status: Choose to sync content with another Smartling status. This should be used with the language filter below. 
6. Last Modified: Choose to include content that was modified within a certain timeframe in Contentful.
7. Tags: Choose to ingest content with specific tags, or assets without tags
8. Choose to include related assets of each asset captured in the rule

Mindtouch Filters

1. Include page paths and their child pages: Insert the Mindtouch path to the content you want to translate. It will also include any subfolders within the path.
2. Exclude page paths and their child pages: Insert the Mindtouch path to the content you want to exclude from translation. It will also exclude any subfolders within the path.

Akeneo Filters

1. Content Type
2. Family
3. Product IDs
4. Categories: Enter the Akeneo category codes, adding one code per line without spaces, commas, or separators. Important: Use the category code, not the label. For example, if the category label is “Heating, Venting & Cooling”, the corresponding code would be “master_heating_venting_cooling”. Copy the actual category code from Akeneo’s settings. Wildcards are not allowed. If the list is empty, the Category filter will not be applied. 
5. Date Modified: Include content modified within a specified timeframe in Akeneo.
6. Date Created
7. Status: Choose to include content that is enabled or disabled in Akeneo. 
8. Smartling Status
9. Out of Sync: Include changed content that was previously requested for translation. 
10. Include Sub-Categories
11. Include Child Assets 

Shopify Filters

1. Content Type
2. Tags
3. Identity (Asset Id)
4. Date Modified 
5. Date Created 
6. Smartling Status

Please note that the available filtering options may vary depending on the selected content type.

Turn Rules On or Off

To activate a rule, toggle the switch to On under the Enabled/Disabled column.

To deactivate a rule, toggle the switch to Off under the Enabled/Disabled column.

Run Rules Outside the Schedule

If you wish to run Job Automation before the scheduled time, click the play icon from within the Actions column. You can also edit or delete the rule at any time. If you wish to disable the rule temporarily, toggle OFF from within the Status column.

Each time the rule runs, the most recent time is captured in the Last Run column.

Project Processes

To view the status of the content captured as part of the automation rule, click Actions > Project Processes. This modal displays a list of Job processes and the status of each. If a process is still in progress, you can cancel it by clicking the ellipses > cancel.

• Job Request: the number of requested and uploaded entries. This helps determine if some entries are failing during the upload process.
• Status: Completed, Failed, or In Progress and the timestamp of when the status occurred.
• Requested By: the user account that submitted the request. Typically, this will be the connector slug, however if a user runs a rule outside a schedule, that username will be displayed. 
• Action: If a process is In Progress, you can cancel it from this menu. If the process is Completed or Failed status, this action menu will be inactive.