Skip to main content

XTM Connect – Oracle Content Management 1.0/Administrator Guide

Configuring Oracle Profiles in XTM Connect – Oracle Content Management

You configure Profiles in the Add profile tab in the XTM Connect – Oracle Content Management Administrator screen. The parameters for an Oracle Profile are grouped in sections. Some parameters are not displayed until you have completed others, so it is important to set all the parameters in this sequence:

Note

Sections with * after the heading, or fields with * after their name, are mandatory and the others are optional. In this manual, all parameters which are not specified as optional, are treated as mandatory. Any values you enter, or parameters that you set, are saved when you finish creating a Profile and select the Save button, at the end. You do not need to save them while you are working.

To configure Oracle Profiles in XTM Connect – Oracle Content Management:
  1. Log in to XTM Connect – Oracle Content Management.

  2. Select the Oracle Profiles tab. All defined Profiles are listed in the Oracle Profiles tab screen.

  3. Set the Profile identification parameters:

    1. At the top of the screen, on the left, select the Add Profile button.

      The Add Profile screen is displayed.

    2. Enter a unique Oracle profile name.

    3. In the Client assigned dropdown, you will see the client name to which you are assigned, as the Client administrator.

      Note

      It is already populated here and this field is locked for editing by Client administrators.

      A Profile can only be assigned to one Client and used by that Client's end-users (Translation requesters).

      Note

      Only XTM International's Support team can view all clients and modify the client that can be seen here.

    4. In the User assigned dropdown, select end-users (Translation requesters) in the Client's organization who will use this Profile.

      Note

      You can:

      • search for end-users by name

      • Select all end-users, if you want all Translation requesters to be able to use this Profile

    5. If you want this Profile to be listed for selection by the end-user or end-users for whom it has been assigned, set it to Active. If not, do not set it to Active. You can do so later when required.

      You have finished specifying the profile identification parameters. Now set the OCM connection parameters.

  4. Set the Oracle Content Management connection parameters:

    1. In the ORACLE SETTINGS section, specify the following Login details:

      1. Enter the Oracle Client ID. This credential will be provided to you by the Client.

      2. Enter the Oracle Client secret. This credential will be provided to you by the Client. ("IDCS" stands for "Oracle Identity Cloud Service".)

      3. Enter the Oracle IDCS access token URL. This credential will be provided to you by the Client. ("IDCS" stands for "Identity Cloud Service".)"

      4. Enter the Oracle URL. This is the URL of the Oracle system to which this Profile will be connected. This credential will be provided to you by the Client.

      5. Enter the Scope. This credential will be provided to you by the Client.

      6. Select the Connect to Oracle button to establish the connection to OCM.

        Once the connection to OCM has been established, the Connect to Oracle field content changes to Connected and additional OCM parameters are displayed.

    2. In the ORACLE SETTINGS section, set the following Product media files parameter that defines how to process media files if any are present in a zipped package that XTM Cloud receives from OCM:

      • to optionally Enable processing of media files, select the checkbox.

        Then, make the following additional mandatory settings:

        • the Extensions for source files multiselection dropdown contains extensions that are handled by XTM Cloud. From it, select valid file extensions for source files that can be sent to XTM Cloud for translation. For more details, see the “File formats supported in XTM Cloud” section of the XTM Cloud manual.

          Note

          XTM Connect – Oracle Content Management does not support the .pdf file extension.

        • in the Extensions for reference files text field, specify extensions for files that will be sent to XTM Cloud as reference files, and not as translation files. Type the file extensions in the text field. Separate them with commas.

      • to disable the processing of media files, clear the checkbox next to the optional Enable processing of media files setting

      You have finished specifying the Oracle Content Management connection parameters. Now set the XTM Cloud connection parameters.

  5. Set the XTM Cloud connection parameters:

    1. In the XTM CLOUD SETTINGS section, specify the following Login details:

      1. Enter the XTM Cloud URL. This is the URL of the XTM Cloud system in which this Profile will be used.

      2. Enter the XTM Company name. This is the XTM Cloud company for which this Profile will be used.

      3. Enter the XTM Cloud User. This is used to log in to the XTM Cloud system.

      4. Enter the XTM Cloud password. This is used to log in to the XTM Cloud system.

      5. Select Connect to XTM Cloud to establish a connection to XTM Cloud.

        You have finished specifying the XTM Cloud Login details. Now set the additional XTM Cloud Settings.

    2. In the XTM CLOUD SETTINGS section, specify the following additional XTM Cloud Settings:

      1. Select the Default XTM Cloud Customer from the dropdown list of customers that have already been defined in XTM Cloud.

      2. Select the Default XTM Cloud templates from the dropdown list of project templates that have been created for the XTM Cloud customer that you have selected in the previous field.

        Note

        This field is only displayed after you select one XTM Cloud customer. It contains a different, dynamically generated dropdown list for each customer chosen in the Default XTM Cloud Customers field.

      3. Default the due date to X days ahead: if you set this value, the number of days ahead specified here will automatically be added to the due date for projects created using XTM Connect – Oracle Content Management. This later date will be the default due date. If a Translation requester changes the due date for a project in XTM Connect – Oracle Content Management in Translation Queue, it will always overwrite this default setting.

    3. In the XTM CLOUD SETTINGS section, specify the Language mapping settings.

      The languages defined in OCM must be mapped to the languages defined in XTM Cloud. To map a language that is defined in OCM to a language defined in XTM Cloud:

      1. Select the Plus button to display the OCM language field.

      2. In the Oracle language field dropdown, select the language code for a language that is defined in OCM.

      3. In the XTM Cloud language dropdown, select the language code for the same language, as defined in XTM Cloud.

      4. Repeat this process for all other OCM languages that you want to map to languages in XTM Cloud.

        Example: Map the OCM "English - en-US" language code to the XTM Cloud "English (US)" language code.

        You have finished specifying Language mapping settings in XTM Cloud. Now set Email notifications parameters.

    4. In the XTM CLOUD SETTINGS section, specify the optional Email notifications settings.

      You can configure these email notifications to ensure you are kept up to date with the state and progress of translation projects that are created using this connection profile.

      You can select the email addresses of all the end-users assigned to a specific profile.

      Notify users via email once the XTM Cloud job is finished and imported

      Select this if you want end-users to be notified by email when a translation job or project that has been automatically submitted for translation, by XTM Connect – Oracle Content Management, is finished and has been imported back into OCM.

      You can:

      • search for end-users by name.

      • Select all end-users, if you want all Translation requesters within this Profile to be notified.

      Notify users via email about the progress of the translation workflow in XTM Cloud

      Select this if you want end-users to be notified by email if there is a change in the workflow for an automatically submitted translation job, in XTM Cloud.

      You can:

      • search for end-users by name.

      • Select all end-users, if you want all Translation requesters within this Profile to be notified.

      You have finished specifying Email notifications settings in XTM Cloud. Now set the additional XTM Cloud parameters.

    5. In the XTM CLOUD SETTINGS section, specify the following additional XTM Cloud settings:

      • Enable users to change due dates in existing projects: select this optional setting to enable Translation requesters to change the due date that has been set for projects, once they have been created using this Profile. By default, Translation requesters cannot change these due dates, once they have been set. If you select the Enable users to change due dates in existing projects checkbox, Translation requesters will be able to change project due dates in the Translation Queue tab in the XTM Connect – Oracle Content Management User panel.

      • XTM project name prefix: if required, specify the prefix that will be always added to the translation project name in XTM Cloud,

      • In XTM Cloud: remove deleted CMS files after (in days): optionally, if required, set the number of days after which XTM Connect – Oracle Content Management deletes files that are no longer available in OCM, because they have been deleted.

      • In XTM Connect – Oracle Content Management: remove cancelled XTM Cloud jobs after (in days): optionally, if required, set the number of days after which XTM Connect – Oracle Content Management deletes jobs that have been cancelled in the XTM Connect – Oracle Content Management Translation queue.

      You have finished specifying additional XTM Cloud settings.

  6. You have now entered all the details for your new Profile.

    • To save the details for your new Profile, select Save at the bottom of the Add profile window. XTM Connect – Oracle Content Management checks all the values you have entered or selected.

    • If anything is missing or invalid, XTM Connect – Oracle Content Management will display a message to inform you. Correct any missing or invalid values you have entered or selected.

    • If you have corrected any values, select Save again. XTM Connect – Oracle Content Management checks all the values you have entered or selected again. Once they are complete and correct, the Add profile window closes and the Oracle Profiles list screen is displayed.

You have finished adding a new Oracle Profile.

If required, you can now configure XTM Connect – Oracle Content Management in Oracle Content Management, to enable Translation requesters to access it from Oracle Content Management.