AWS Translate Spoke
Summarize
Summary of AWS Translate Spoke
The AWS Translate Spoke enables integration between your ServiceNow instance and AWS Translate services to detect languages in text and translate text into the desired language. This integration leverages AWS Translate and AWS Comprehend APIs to automate language detection and translation tasks within ServiceNow workflows and actions.
Show less
This spoke requires an Integration Hub subscription and depends on several ServiceNow plugins such as Complex Object, IntegrationHub Runtime, Flow Designer - Dynamic Inputs, and IntegrationHub Action Step - REST. Some plugins may require additional licensing.
Key Features
- Language Detection: Uses AWS Comprehend to detect the dominant language of input text. The output includes a JSON array with detected languages and confidence scores.
- Text Translation: Translates text from a source language to a target language using AWS Translate. Supports automatic source language detection via AWS Comprehend when the region supports it.
- Sample Flow Provided: Includes a sample flow that translates an incident’s short description to Spanish upon creation, which can be customized to fit specific use cases.
- Region-Specific Configuration: Requires specifying a supported AWS region for the translation and detection actions. The list of regions can be retrieved via the Amazon EC2 Spoke’s List Regions action.
- Connection and Credential Management: Uses Integration Hub aliases to manage connection and credential information securely and efficiently across environments without needing to update individual actions.
Requirements and Compatibility
- User with full access to AWS Translate and corresponding Access Key ID and Secret Access Key.
- Compatible with AWS Translate API version 2017-07-01 and AWS Comprehend version 2017-11-27, with potential compatibility for later versions (API version updates must be reflected in all spoke actions).
- Not compatible with dynamic translation in the current version.
- Dependent ServiceNow plugins must be installed and licensed as necessary.
Practical Considerations for ServiceNow Customers
- Ensure you have an Integration Hub subscription and the necessary plugins installed before deploying the AWS Translate Spoke.
- Configure AWS credentials correctly and securely using Integration Hub aliases to facilitate seamless connection management.
- Utilize the sample flow as a template to quickly implement automated translation in incident management or customize it for other processes.
- Consider the AWS region compatibility to avoid errors, especially when using the auto-detect language feature, which requires Amazon Comprehend-supported regions.
Integrate your ServiceNow instance with AWS Translate to detect languages in the text and translate text to the required language.
Request apps on the Store
Visit the ServiceNow Store to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.
Integration Hub subscription
This spoke requires an Integration Hub subscription. For more information, see Legal schedules - IntegrationHub overview.
Supported version
- If you use different API version, ensure that you change the API version in all spoke actions.
- The current version of the AWS Translate spoke is not compatible with dynamic translation.
Spoke dependencies
If you’re having trouble installing the app, ensure that these dependent plugins are installed:
- Complex Object (com.glide.cobject)
- ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
- ServiceNow Flow Designer - Dynamic Inputs (com.glide.hub.dynamic_inputs)
- ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
Spoke requirements
- User with full access to AWS Translate.
- Access Key ID and Secret Access Key of the user. Record these values for later use. For more information, see Create an access key.
Spoke flow
The AWS Translate spoke provides a sample flow, Translate Short Description when Incident is Created to demonstrate translating the short description to Spanish when an incident is created. You can customize the sample flow as per your requirement by creating a copy of it in the required scope.
Spoke actions
| Category | Action | Description |
|---|---|---|
| Language Management | Detect Dominant Language | Detects the language of text using AWS Comprehend service. Note: Provide the text for which you want to
detect the dominant language in the action input
Text. The output is a JSON string
that contains an array of the detected languages. One of the
elements in the array is Score. This
is a decimal number and its value is between
0 and
1. When the action is executed, the Languages Detected action output may not display any runtime value. However, the output data pill still holds the response data and can be used in the subsequent actions in the flow or subflow. |
| Translate Management | Translate Text | Translates text from the source language to the target
language using AWS Translate
service. Note:
|
Connection and credential alias requirements
Integration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.
For information about setting up the spoke, see Set up the AWS Translate spoke.