24 Configuring EnterpriseOne with Oracle Content and Experience Cloud (Release 9.2.1.2)

This chapter contains the following topics:

24.1 Prerequisites

JD Edwards EnterpriseOne provides enterprise-level content and social collaboration through integration with Oracle Content and Experience Cloud. This integration enables real-time enterprise conversations and real-time access to content, connecting people and information in the cloud.

For more information about User Conversations, Users Documents, Contextual Conversations, and Contextual Documents, see "Using Oracle Content and Experience Cloud for JD Edwards EnterpriseOne" in the JD Edwards EnterpriseOne Tools Foundation Guide.

Before you can configure EnterpriseOne for Content and Experience Cloud, you must have installed a minimum of EnterpriseOne Tools 9.2.1 following the instructions in the JD Edwards EnterpriseOne Tools Release 9.2.X Upgrade and Automated Special Instructions (ASI) Supplement located at:

http://www.oracle.com/webfolder/technetwork/tutorials/jdedwards/Upgrade/JD%20Edwards%20EnterpriseOne%20Tools%20Release%209%202%20Upgrade%20Supplement.pdf

Complete the following prerequisites in order to enable the cloud document and conversation icons in the EnterpriseOne application:

  • Add the EnterpriseOne domain to Oracle Content and Experience Cloud.

  • Set up EnterpriseOne users to access Oracle Content and Experience Cloud.

24.2 Adding the EnterpriseOne Domain to Oracle Content and Experience Cloud

You have to add the EnterpriseOne domain in the Content and Experience Cloud Administrator setting. This will embed the Content and Experience Cloud interface in the EnterpriseOne application.

To add the JD Edwards EnterpriseOne domain to Oracle Content and Experience Cloud:

  1. Log in to the Oracle Content and Experience Cloud web application as an administrator.

  2. Open the user menu and click Administration.

  3. On the Security page, under Embedded Content, select Enabled.

    Note:

    If the Enabled option is not selected, the Content and Experience Cloud interface will not be displayed in EnterpriseOne.
  4. In the Allowed domains box, enter a list of permitted domains, separated by commas. For example, domains must be in the form jase1url.domain.com:port.

Note:

Business service calls and Foundation APIs for traditional media objects are not compatible with the cloud documents.

Currently, only the system function call from the event rules for "<Exist> check" is supported. For example, Media Object Structures(<MO Param>, <Exist>,<Param>, BC Address Number (F0101)) (Release 9.2.2)

To learn about embedding the Oracle Content and Experience Cloud web user interface, see "Embedding the Web User Interface" in the Developing for Oracle Content and Experience Cloud Guide.

24.3 Setting Up EnterpriseOne User Access to Oracle Content and Experience Cloud

To set up EnterpriseOne users to access Oracle Content and Experience Cloud, you need to:

  • Add EnterpriseOne users to Oracle Content and Experience Cloud.

  • Set up user connections to Oracle Content and Experience Cloud.

24.3.1 Adding EnterpriseOne Users to Oracle Content and Experience Cloud

Ensure that you add all required EnterpriseOne roles and users in Oracle Content and Experience Cloud. You can add the required users through the Users page of the Administration menu. See "Adding Users" in the Administering Oracle Content and Experience Cloud Guide.. Only valid Oracle Content and Experience Cloud users can access conversations in EnterpriseOne.

Oracle Content and Experience Cloud users are set up separately from EnterpriseOne users, but the Oracle Content and Experience Cloud user ID and EnterpriseOne user ID must be the same.

Recommendations: Use an EnterpriseOne user's long user ID for the Oracle Content and Experience Cloud user ID. For more information, see "Setting Up Long User IDs in EnterpriseOne" in the JD Edwards EnterpriseOne Tools Security Administration Guide. Create a Social Role in EnterpriseOne for grouping Cloud users. Creating roles grants a predefined set of privileges to a group of administrators. If you change a role, the changes are automatically propagated to all administrators assigned to that role.

24.3.2 Setting Up User Connections to Oracle Content and Experience Cloud

Connecting to Oracle Content and Experience Cloud is a two-step process. You must create:

  • Social connection template

  • Social connection records for users

24.3.2.1 Social Connection Template

A social connection template defines how the system connects to Content and Experience Cloud for any EnterpriseOne user. A social connection includes information about the Content and Experience Cloud user and password used to establish the connection and the parent folder. A social connection can be added for any valid EnterpriseOne user, role, or *PUBLIC.

A social connection template JDE_SOCIAL_CONNECTION is shipped with the JD Edwards EnterpriseOne product. You must use the JDE_SOCIAL_CONNECTION soft coding template to create soft coding records for social connections. Verify that this template exists in EnterpriseOne before creating social connection soft coding records.

If EnterpriseOne does not have a JDE_SOCIAL_CONNECTION soft coding template, you must create one. To create a JDE_SOCIAL_CONNECTION template:

  1. Access the P953000 application.

  2. Click Add.

  3. Enter JDE_SOCIAL_CONNECTION in the Template Name field.

  4. Enter JDE Social Connection Template in the Description field.

  5. Enter JDE_SOCIAL_CONN in the SoftCoding Key field.

    Note:

    The value for SoftCoding Key must be JDE_SOCIAL_CONN. You cannot use any other value for this field.
  6. Enter the following in the Value field:

    <docs>
    <endpoint>https:// cloudserviceurl</endpoint>
    <username>user id</username>
    <password>_||_password_||_</password>
    <properties>
    <property><name>parent folder</name><value>folder id</value></property>
    </properties>
    </docs>
    

    For more information on the guidelines for the soft coding value parameters, see Soft Coding Value Guidelines in this guide.

    Note:

    Do not make any changes to the "<name>parent folder</name>" string. Enter the folder ID only in the "<value>folder id</value>" string. For example, if the parent folder ID is F0239D34, the parent folder parameter will be: <property><name>parent folder</name><value>F0239D34</value></property>
  7. Enter the Mask Fields in the grid.

    Mask fields are the fields that have _ | | _ as a prefix and suffix. However, you do not include the prefix and suffix when entering the mask field in the grid. The system adds the prefix and suffix for you.

  8. Click OK to save the template.

24.3.2.2 Social Connection Record

Use the Soft Coding Records (P954000) application to create a connection to Content and Experience Cloud. You set up soft coding records by environment and by user (or role, or *PUBLIC). When a soft coding record is set up for *PUBLIC and a particular environment, all users logged in to the environment will use the same soft coding record to locate and connect to the Content and Experience Cloud server.

Note:

While creating a record for *PUBLIC, ensure all the EnterpriseOne users have the corresponding Content and Experience Cloud user accounts.

To create a Content and Experience Cloud connection record:

  1. Type P954000 in the Fast Path. Alternatively, from the Navigator drop-down menu, select EnterpriseOne Menus, EnterpriseOne Life Cycle Tools, System Administration Tools, Soft Coding Administration, Soft Coding Records.

  2. Click Add to add a record.

  3. In the User/Role field, enter the EnterpriseOne user, role, or *PUBLIC.

  4. In the Environment Name field, enter the EnterpriseOne environment for which you are creating this soft coding record.

  5. In the Template Name field, enter JDE_SOCIAL_CONNECTION.

  6. In the Soft Coding Key field, enter JDE_SOCIAL_CONN.

    Note:

    The value for Soft Coding Key must be JDE_SOCIAL_CONN. You cannot use any other value for this field.
  7. Click Populate Soft Coding Value to populate the Soft Coding Description and Soft Coding Value fields with the information from the JDE_SOCIAL_CONNECTION template.

  8. Change the user name and root folder in the Soft Coding Value for your connection.

  9. Enter the Mask Value for any Mask Fields.

    The following example shows the JDE SOCIAL CONNECTION softcoding record:

    Figure 24-1 Softcoding Record

    Description of Figure 24-1 follows
    Description of ''Figure 24-1 Softcoding Record''

  10. Click OK to save the record.

    After the record is saved, the password is encrypted and will appear as *** when updating the record.

24.3.3 Soft Coding Value Guidelines

When updating the Content and Experience Cloud social connection template, use the following guidelines to ensure valid soft coding value parameters:

Endpoint

The endpoint must be a valid, fully qualified Oracle Content and Experience Cloud service instance url.

Username

The user name must be a valid Oracle Content and Experience Cloud administrator user ID. Note that the contextual documents will be stored in the administrator's storage space.

_||_password_||_

The administrator has two ways to supply the password for the Oracle Content and Experience Cloud user:

  • Use a placeholder parameter (masked parameter) in the soft coding value and assign the value to the parameter in the grid. The previous example used a placeholder parameter called "password" and defined the password variable in the grid. The "_||_" prefix and suffix are markers for placeholder variables.

    When used this way, the value will be encrypted before it is saved to the database and is masked for future display.

  • Use plain text directly in the soft coding value.

Parent Folder

To define the EnterpriseOne parent folder:

  1. Log into the Content and Experience Cloud and click the Documents tab.

  2. In the Documents window, click the folder you want to use as the parent folder for the EnterpriseOne user. Find the folder location from the URL. It is the EnterpriseOne folder ID in Content and Experience Cloud. For example, the parent folder is highlighted in the following URL:

    https://example.documents.us2.oraclecloud.com/documents/folder/F0239D348400CF75F613A297FEF908247711A9CD99FB/_JDE/nameasc

  3. Enter the folder ID as the soft coding value for parent folder. The folder ID is case sensitive. Ensure that you type the exact folder ID. If the folder ID is misspelled, EnterpriseOne fails to open the folder. If you need to change the value of the parent folder, you must edit the value in P954000.

    Note:

    All the Contextual documents from EnterpriseOne will be stored in this parent folder.

See Also "Working with Softcoding" in the JD Edwards EnterpriseOne Tools Business Services Development Guide