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:
How To Create a Job Automation Rule
- Go to Account Settings > Integrations
- Click the Automation tab
- From here you can view all rules created and create new rules.
- 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.
- Choose a Project to apply the rule to from the dropdown list of projects.
Contentful Filters
You can refine the content that is included in the automation rule by the following filters:
- Contentful Space: A space is a workspace that contains all content and media for a project. It has its own content model.
- Asset Type: Choose between the supported content types, media assets and entries.
- Content Type: Choose any of your content or mime types
- Contentful Status: Choose to ingest content that's in a specific state in Contentful
- Tags: Choose to ingest content with specific tags
- Smartling Status: Choose to sync content with another Smartling status. This should be used with the language filter below.
- Language: choose to sync content with another language. For example, if you have translated content into French and subsequently add Spanish to your project, you can set up a rule that translates all the content that was translated in French, into Spanish. This should be used with the Smartling Status filter above.
- Last Modified: choose to include content that modified within a certain timeframe in Contentful.
Note: Related assets will not be captured for translated as part of the Automation Rule for Contentful.
Mindtouch Filters
- 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.
- 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.
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.