This the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Configuring User Access

Any Oracle Eloqua user who is added to CloudBroker can access the Lionbridge App. However, to send out content for translation from the Lionbridge App, a user must be part of a team. A user’s team determines:

  • the source languages of the assets that a user can send out for translation
  • the target languages into which a user can request translation of the assets
  • the translation providers to whom a user can send the assets for translation

An Oracle Eloqua user also requires specific user permissions in Eloqua to send out content for translation from the Lionbridge App. For a list of the minimal recommended permissions, refer to the Eloqua documentation, available at: https://community.oracle.com/docs/DOC-895414. Specifically, download the OOBSecurityGroups_Permissions.xlsx file on that page, and ensure that the user has the permissions listed in the Advanced Users - Marketing column in that file.

Who can access the Lionbridge App

There are multiple ways to add Oracle Eloqua users to CloudBroker so that they can access Lionbridge App:

Method for Adding Eloqua Users Advantage Disadvantage How To…
Automatically allow all Oracle Eloqua users to access the Lionbridge App and add them to the default team. When an Oracle Eloqua user accesses the Lionbridge App, CloudBroker automatically adds the user to the default team. This is particularly useful if you want all Oracle Eloqua users to have access to the Lionbridge App, and you only want to use one team. Either:

* All Oracle Eloqua users only use one team, so all users can send to all configured source and target languages and translation providers.
* You must move users from the default team to appropriate teams configured source and target languages and translation providers.
In the Eloqua tab of the Site Configuration dialog box, select the Allow All Eloqua Users to Manage Translations check box, and specify a Default Team, as described below.
Import users from Oracle Eloqua into CloudBroker. You select which Oracle Eloqua users to import into CloudBroker. You must add imported users to a team, even if you want to use a single team. In the Site Users page, click Import Users, and select the users to import. For detailed instructions, see Importing Users.
Add individual Oracle Eloqua users to CloudBroker. This is useful if you want only a few Oracle Eloqua users to access the Lionbridge App. It is very time consuming to individually add each user to CloudBroker. In the Site Users page, click New User. For detailed instructions, see Adding a User.

Note: When Oracle Eloqua users access the Lionbridge App, it must authenticate with the Oracle Eloqua server.

To configure user access:
  1. In the Site Administration menu on the left, ensure that My Site is selected, so that the My Site page is open. This is the default selection when you log into CloudBroker as a site administrator. For detailed information about this page, see Viewing Lionbridge App Information and Usage Data.

  2. Click Configure Site.

The Site Configuration dialog box opens. The Site Name field at the top of the dialog box displays the name of your company’s site.

  1. Click the Eloqua tab.

  1. Enter the following information in the Access section:
Field Description
Eloqua Users – Allow All Eloqua Users to Manage Translations Select this check box to enable all Oracle Eloqua users to access the Lionbridge App. CloudBroker then automatically adds each user to the team configured as the default team, which means it is selected in the Default Team dropdown list, described below.

Note: If you do not select this check box, you must add each Oracle Eloqua user who is allowed to access the Lionbridge App, either individually or by importing from Oracle Eloqua. You must also add each user who can send out content for translation to a team. For detailed instructions, see Adding a User and Importing Users.
Default team If you select the Allow All Eloqua Users to Manage Translations check box, described above, CloudBroker automatically adds all Oracle Eloqua users to the team specified here. You can create teams, so that they will be available for selection here. For details, see Adding or Editing a Team.

Note: This dropdown list is available for selection only if the Allow All Eloqua Users to Manage Translations check box, described above, is selected.

For a detailed description of the other fields in this tab, see Viewing and Testing Eloqua Authentication Settings.

  1. Click Save.

1 - Managing Teams

A team is a collection of users for a specific site. All users on a team can send out content for translation from the source languages to the translation providers into the target languages configured for the team.

Important: Before setting up users and teams, read Configuring User Access.

This section describes how to view information about existing teams, add a new team, and edit an existing team.

To manage teams:
  1. In the Site Administration menu on the left, click Site Teams.

The Site Teams page opens, displaying the teams of users set up for your Eloqua site.

This page displays the following information about each team:

Column Description
Name The name of a team.
Source Languages The source languages of the content that users in this team can send out for translation.
Target Languages The target languages of the content to which users in this team can send out content for translation.
Providers The translation providers to which users in this team can send out content for translation.
Total Users The total number of users in this team.

Tip: To view the users in this team, click the  icon. The Team users box displays all the users on the team and their email addresses.
  1. Do one of the following:

    1. To create a new team, click New Team. For detailed instructions, see Adding or Editing a Team.
    2. To edit a team, in the Actions column, click Edit in the corresponding row. For detailed instructions, see Adding or Editing a Team.
    3. To delete a team, in the Actions column, click Delete in the corresponding row. For detailed instructions, see Deleting a Team.

1.1 - Adding or Editing a Team

You can create a new team or edit a team that was created previously.

To add or edit a team:
  1. In the Site Administration menu on the left, click Site Teams.

The Site Teams page opens, displaying the teams set up for your Eloqua site. For detailed information about this page, see Managing Teams.

  1. Do one of the following:
    1. To create a new team, click New Team.
    2. To edit an existing team, click Edit for that team.

Either the New Site Team or the Edit Site Team dialog box opens, displaying the Source Languages tab. Other than the title, these dialog boxes are nearly identical.

  1. In the Team Name field, enter the name for your team.

  2. Select the check boxes for the source languages that users on this team can send out for translation.

  3. Click the Target Languages tab.

  1. Select the check boxes for the target languages to which users on this team can send out content for translation. Users on the team are allow to send content for translation into these target languages.

  2. Click the Providers tab.

  1. Select the check boxes for the translation providers to which the users on this team can send out content for translation.

  2. Click the Users tab.

  1. Select the check boxes for the users who are on this team.

  2. Do one of the following to save your changes:

    1. In the New Site Team dialog box, click Add.
    2. In the Edit Site Team dialog box, click Save.

Important: You can set this team to the default team. A default team is required if you select the Allow All Eloqua Users to Manage Translations check box in the Eloqua tab of the Site Configuration dialog box. For details, see Configuring User Access.

1.2 - Deleting a Team

You can delete a team from the Lionbridge App so that it will no longer be a collection of users with the same permissions for sending out assets for translation from specified source languages, to specified target languages, to specified translation providers.

Important: Deleting a team from the Lionbridge App also deletes all the jobs and items sent by users from the Lionbridge App as part of this team. Deleting a team from the Lionbridge App does not delete the users in the team from either CloudBroker or Oracle Eloqua.

Notes about users that are in multiple teams: Deleting a team does not delete jobs or items that users sent as part of a different team. If users are in multiple teams, deleting a team from the Lionbridge App does not change user permissions from the non-deleted team.

To delete a team from the Lionbridge App:
  1. In the Site Administration menu on the left, click Site Teams.

The Site Teams page opens, displaying the teams set up for your Oracle Eloqua site. For detailed information about this page, see Managing Teams.

  1. In the Actions column, click Delete for the team to delete.

The Delete Team dialog box opens.

The dialog box displays the name of the team to delete. It also displays the following information about the jobs and items that users on this team sent for translation, as part of this team:

Field Description
Total Jobs The total number of jobs users on this team sent out for translation.
Total Translation Items The total number of items users on this team sent out for translation.
Total Completed The total number of translated items that the Lionbridge App has re-imported into Oracle Eloqua.
Total Incomplete The total number of assets that the Lionbridge App has not yet re-imported into Oracle Eloqua. Usually these are assets that are currently in translation, or were just recently received back from translation and that the Lionbridge App is trying to re-import into Oracle Eloqua.

Warning: If you delete this team, these items will be deleted. They will not be re-imported into Oracle Eloqua.
  1. Click Delete to remove the team and all the jobs and items sent out for translation by users as part of this team from the Lionbridge App.

2 - Managing Users

Eloqua users can access Lionbridge App to send, monitor, and review translation jobs.

Important: Before setting up users and teams, read Configuring User Access.

To manage users:
  1. In the Site Administration menu on the left, click Site Users.

The Site Users page opens, displaying the users set up for your Oracle Eloqua site.

This page displays the following information about each user:

Column Description
Name The name of the user.
Email Address The email address of the user.
Default Language The default language in which the Lionbridge App interface is displayed for the user. If the user is a site administrator, who can access the functionality described in this guide, then this is the language in which the CloudBroker interface is displayed for this user.
Token A checkmark indicates whether this user has an active token for authentication to Eloqua.
Teams The teams to which this user belongs. The team determines which source and target languages the user can send out for translation and the translation providers to which the user can send the content.
Site Admin A checkmark indicates whether this user is a site administrator. Site administrators can access CloudBroker to set up the Lionbridge App, as described in this guide.
Eloqua Super User A checkmark indicates whether this user is an Eloqua superuser. If a user who submitted a translation job does not have sufficient permissions to return the translated content to Eloqua, then the App uses the Eloqua superuser’s credentials to return translated content to Eloqua.
Last Login The time and date when the user last logged into the App, in the following format: YYYY-MM-DD hh:mm:ss AM/PM..
  1. Do one of the following:
    1. To create a new user, click New User. For detailed instructions, see Adding a User.
    2. To import users, click Import Users. For detailed instructions, see Importing Users.
    3. To edit a user, in the Actions column, click Edit in the corresponding row. For detailed instructions, see Editing a User.
    4. To delete a user, in the Actions column, click Delete in the corresponding row. For detailed instructions, see Deleting a User.

2.1 - Importing Users

You import users from Oracle Eloqua to the Lionbridge App so that you can add them to teams, which enables them to send assets for translation from and to specified languages and to specified translation providers. This is the best way to add many Oracle Eloqua users to the Lionbridge App without adding all the users to the App.

Important: Before setting up users and teams, read Configuring User Access.

To import users:
  1. In the Site Administration menu on the left, click Site Users.

The Site Users page opens, displaying the users set up for your Oracle Eloqua site. For detailed information about this page, see Managing Users.

  1. Click Import Users.

A dialog box may open, prompting you to log in to Oracle Eloqua.

  1. If the dialog box opens, enter your Oracle Eloqua credentials, and click Login.

The Import Users dialog box opens.

  1. In the User Name field, enter one or more names or partial names of the users to import, and click Search.

The Eloqua Users box displays all matching Eloqua users.

Note: If an Eloqua user is already in the Lionbridge App, that user is displayed in grey, and the corresponding check box is not available for selection.

  1. Select the check boxes for the users to import into the Lionbridge App, and then click Import.

The Lionbridge App imports each selected user’s username and email address. During the import process, the App automatically overwrites the records of any users with matching email addresses. This prevents duplicate user records in the App.

Note: After users are imported, you still need to add them to a team, so that they can send out assets for translation. You can also specify which users are site administrators, who can access configuration and administration features in the Lionbridge App, and you can specify the default language for displaying the Lionbridge App to each user. For details, see the following section, Editing a User.

2.2 - Editing a User

In general you edit a user that you previously added, either by importing or automatically, to specify the following information:

  • the default language for displaying the Lionbridge App for the user
  • whether the user is a site administrator, who can access CloudBroker to set up the Lionbridge App, as described in this guide
  • the teams that the user joins

You can also change a user’s username or email address.

To edit a user:
  1. In the Site Administration menu on the left, click Site Users.

The Site Users page opens, displaying the users set up for your Oracle Eloqua site. For detailed information about this page, see Managing Users.

  1. Click Edit for the user to edit.

The Edit Userdialog box opens.

  1. You can modify the following information:
Field Description
User Name The user’s username. This must be the same as the user’s username for accessing Oracle Eloqua.
User Email The user’s email address.
Default Language In the dropdown list, select the default language in which the Lionbridge App interface is displayed for the user. If the user is a site administrator, who can access the functionality described in this guide, then this is the language in which the CloudBroker interface is displayed for this user. Languages are configured in CloudBroker by the Lionbridge Connector Team. For more information, please contact Lionbridge Connector Support, as described in How to Contact Lionbridge Connector Support.
Eloqua Permission Indicates whether this user is an Eloqua superuser. If a user who submitted a translation job does not have sufficient permissions to return the translated content to Eloqua, then the App uses the Eloqua superuser’s credentials to return translated content to Eloqua.

* If the user is an Eloqua superuser, select the Is Eloqua Super User check box.
* If the user is not an Eloqua superuser, clear the **Is Eloqua Super User** check box.
User Role Indicates whether this user is a site administrator, who can access CloudBroker to set up the Lionbridge App, as described in this guide.

* If the user is a site administrator, select the **Is Site Admin** check box.
* If the user is not a site administrator, clear the Is Site Admin check box.

If the user is not a site administrator, you can grant the following administrative permissions to the user by selecting the corresponding check boxes:

* **Configure Site**: configure your site, in the Site Configuration dialog box.
* **Map Languages**: configure language mappings, in the Language Mapping dialog box.
* **Manage Dynamic Content Translation settings**: configure translation settings for dynamic content, in the Site Extension dialog box.
* **Manage Providers**: configure translation providers, in the Site Providers page.
* **Manage Teams**: manage teams, in the Site Teams page.
* **Manage Users**: manage users, in the Site Users page.
* **View All Teams' Jobs**: view the translation jobs for all teams, in the Site Jobs page. Otherwise, the user can view jobs only for the teams to which the user is assigned.
* **Download Translation Files**: download source and target XML translation files, in the Job Details tab of the Translation Jobs page.
Join Teams The teams to which this user belongs. A user must belong to at least one team to be able to send out content for translation. The team determines which source and target languages the user can send out for translation and the translation providers to which the user can send the content.

You can view the settings for all teams on the Site Teams page. For details, see Managing Teams.

* To join a team, select the corresponding check box.
* To leave a team, clear the corresponding check box.
  1. Click Save to save your changes.

2.3 - Adding a User

You can individually add an Oracle Eloqua user to the Lionbridge App so that you can add the user to one or more teams. This enables the user to send assets for translation from and to specified languages and to specified translation providers.

Individually adding an Oracle Eloqua user to the Lionbridge App is useful if you want only a few Oracle Eloqua users to access it.

Important: Before setting up users and teams, read Configuring User Access.

To add a user:
  1. In the Site Administration menu on the left, click Site Users.

The Site Users page opens, displaying the users set up for your Oracle Eloqua site. For detailed information about this page, see Managing Users.

  1. Click New User.

The New User dialog box opens.

  1. Enter the following information to identify the new user:
Field Description
User Name Enter the user’s username for accessing the Lionbridge App. This must be exactly the same as the user’s username for accessing Oracle Eloqua. It is not case sensitive.
User Email Enter the user’s email address. This must be exactly the same as the user’s email address for accessing Oracle Eloqua. It is not case sensitive.
  1. Click Verify. The App checks whether there are any users with the same or similar name already in Eloqua.
  • If the App finds one user with the same or a similar name in Eloqua, it updates the record with the name and email address specified here. The Add button, described below, is enabled.
  • If the App finds multiple users with similar names in Eloqua, it uses the email address specified here to match with the correct user. It then updates the record with the name specified here. The Add button, described below, is enabled.
  • If the App does not find a user with a similar name in Eloqua, the Add button, described below is not enabled.

Recommendation: Add the user to Eloqua before adding the user to the App. Alternatively, after adding the user to Eloqua, import the user to the App. For detailed instructions, see Importing Users.

  • If the App finds a user with the same or a similar name in Eloqua, but this user already exists in the App, then the Add button, described below, is not enabled.
  1. Enter the following additional information about the new user:
Field Description
Default Language In the dropdown list, select the default language in which the Lionbridge App interface is displayed for the user. If the user is a site administrator, who can access the functionality described in this guide, then this is the language in which the CloudBroker interface is displayed for this user. Languages are configured in CloudBroker by the Lionbridge Connector Team. For more information, please contact Lionbridge Connector Support, as described in How to Contact Lionbridge Connector Support.
Eloqua Permission Indicates whether this user is an Eloqua superuser. If a user who submitted a translation job does not have sufficient permissions to return the translated content to Eloqua, then the App uses the Eloqua superuser’s credentials to return translated content to Eloqua.

* If the user is an Eloqua superuser, select the **Is Eloqua Super User** check box.
* If the user is not an Eloqua superuser, clear the **Is Eloqua Super User** check box.
User Role Indicates whether this user is a site administrator, who can access CloudBroker to set up the Lionbridge App, as described in this guide.

* If the user is a site administrator, select the **Is Site Admin** check box.
* If the user is not a site administrator, clear the **Is Site Admin** check box.

If the user is not a site administrator, you can grant the following administrative permissions to the user by selecting the corresponding check boxes:

* **Configure Site**: configure your site, in the **Site Configuration** dialog box.
* **Map Languages**: configure language mappings, in the **Language Mapping** dialog box.
* **Manage Dynamic Content Translation settings**: configure translation settings for dynamic content, in the **Site Extension** dialog box.
* **Manage Providers**: configure translation providers, in the **Site Providers** page.
* **Manage Teams**: manage teams, in the **Site Teams** page.
* **Manage Users**: manage users, in the **Site Users** page.
* **View All Teams' Jobs**: view the translation jobs for all teams, in the **Site Jobs** page. Otherwise, the user can view jobs only for the teams to which the user is assigned.
* **Download Translation Files**: download source and target XML translation files, in the **Job Details** tab of the Translation Jobs page.
Join Teams Select the check boxes of the teams the user is joining. A user must belong to at least one team to be able to send out content for translation. The team determines which source and target languages the user can send out for translation and the translation providers to which the user can send the content.

You can view the settings for all teams on the Site Teams page. For details, see Managing Teams.
  1. Click Add.

2.4 - Deleting a User

You can delete a user from the Lionbridge App so that the user will no longer have access. Deleting a user from the Lionbridge App also deletes all the jobs and items sent by this user from the Lionbridge App .

Important: Deleting a user from the Lionbridge App does not delete the user in Oracle Eloqua.

To delete a user from the Lionbridge App:
  1. In the Site Administration menu on the left, click Site Users.

The Site Users page opens, displaying the users set up for your Oracle Eloqua site. For detailed information about this page, see Managing Users.

  1. In the Actions column, click Delete for the user to delete.

The Delete User dialog box opens.

The page displays the username and email address of the user to delete. It also displays the following information about the jobs and items this user sent for translation:

Field Description
Total Jobs The total number of jobs this user sent out for translation.
Total Translation Items The total number of items this user sent out for translation.
Total Completed The total number of translated items that the Lionbridge App has re-imported into Eloqua.
Total Incomplete The total number of assets that the Lionbridge App has not yet re-imported into Oracle Eloqua. Usually these are assets that are currently in translation, or were just recently received back from translation and that the Lionbridge App is trying to re-import into Oracle Eloqua.

Warning: If you delete this user, these items will be deleted. They will not be re-imported into Oracle Eloqua.
  1. Click Delete to remove the user and all the jobs and items sent out for translation by this user from the Lionbridge App.