Skip Headers
Oracle® Fusion Middleware Developer's Guide for Oracle WebCenter
11g Release 1 (11.1.1.4.0)

Part Number E10148-12
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

29 Integrating the Documents Service

Oracle WebCenter provides several ways to integrate content into a WebCenter Portal application. For more information, see Chapter 25, "Introduction to Integrating and Publishing Content."

This chapter describes how to integrate the Documents service into a WebCenter Portal application to both add content to the application, and to provide end users with content and Documents service task flows built into the application to manage, display, and search documents at runtime.

This chapter includes the following sections:

29.1 Introduction to the Documents Service

The Documents service provides features for accessing, adding, and managing folders and files; configuring file and folder properties; and searching file and folder content in the connected content repositories. It provides these features through Documents service task flows, document components (links, inline frames, and images), wikis, and blogs.

When you set up a content repository connection to integrate the Documents service into a WebCenter Portal application, you can add content to the pages of the application, as described in Chapter 30, "Adding Content Task Flows and Document Components to a Portal Page". This also provide end users who have appropriate permissions with the ability to add and manage folders and files at runtime.

To use the Documents service, you must have access to a content repository that contains the documents you want to manage. If the content repository you wish to use requires authentication, ensure that you set up an external application when you configure the connection to your content repository, as discussed in Section 29.2, "Setting Up Connections."

29.2 Setting Up Connections

Before you can use the Documents service and task flows, you must first set up the connection to a content repository. You can reuse connections you've created or create new ones. For information on creating a connection, refer to Section 26.2, "Configuring Content Repository Connections."

Note:

While you can set up the connections to back-end servers at design time in Oracle JDeveloper, you can later add, delete, or modify connections in your deployed environment using Enterprise Manager Fusion Middleware Control. For more information, refer to the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

When you use Oracle Content Server as your content repository, the security settings depend on the connection configuration. If the connection uses External Application Service Public Credentials, there is no need to set up application security. If the connection uses Identity Propagation, follow the steps in Section 7.2.1.1, "Implementing Security for Services." For information on installing the back-end content repository, see "Oracle Content Server Requirements" in the Oracle Fusion Middleware Installation Guide for Oracle WebCenter.

29.3 Setting Security for the Documents Service

The Documents service task flows support the same security options that are supported by the content repository connections. This service can also use an external application with dedicated user accounts to access remote content repositories, such as an Oracle Content Server or Oracle Portal. For more information about using security with content repositories, see Section 27.4, "Securing a Content Repository Data Control." For information about using external applications, see Section 63.13, "Working with External Applications."

If you are using a content repository that handles its own authentication, such as Oracle Portal or Oracle Content Server, you can associate that content repository with an external application definition to allow for credential provisioning. You can modify your connection to your content repository to use an external application without shared or public credentials. When you do this, the External Application - Change Password task flow is automatically integrated to allow your end users to provide their credentials.

To register an external application for an existing content repository connection:

  1. In the Application Resources pane, right-click your connection name and choose Properties.

  2. In the Edit Content Repository Connection dialog box, under Authentication, select External Application (Figure 29-1).

    Figure 29-1 Selecting External Application in the Content Repository Connection Dialog

    Selecting External Application
  3. Click the green + (plus) sign to start the Register External Application wizard.

  4. On the Name page, enter an Application Name and Application Display Name, (Figure 29-2) then click Next.

    Figure 29-2 Naming the External Application

    Naming the External Application
  5. On the General page, under Authentication Details, choose BASIC from the Authentication Method list (Figure 29-3), then click Next.

    Figure 29-3 Choosing the BASIC Authentication Method

    Choosing the BASIC Authentication Method
  6. On the Additional Fields page, click Next.

  7. On the Shared Credentials page, click Next.

  8. On the Public Credentials page, select Specify Public Credentials, then enter the Username and Password for the content repository (Figure 29-4).

    Figure 29-4 Specifying the Public Credentials

    Specifying the Public Credentials
  9. Click Finish. You'll notice that your connection now uses the external application for authentication (Figure 29-5).

    Figure 29-5 Using the New External Application

    Using the New External Application
  10. In the Edit Content Repository Connection dialog box, click OK. In the Application Resources panel, you'll notice the external application now displays (Figure 29-6).

    Figure 29-6 External Application in the Application Resources Panel

    External Application in the Application Resources Panel
    Description of "Figure 29-6 External Application in the Application Resources Panel"

If you do not apply security, and the content repository requires a login to access the content, the user will not be able to authenticate, and thus will see only public content at runtime.

29.4 Using the Documents Service with Other WebCenter Services

You can use the Documents service with a variety of other WebCenter services. For example, you can add tags to documents in your content repository, search across your application and retrieve documents in the results, or track recent changes to the content repository.

You can see an example of how to use the Documents service with the Tags service in Section 39.3.3, "Optional Way to Show Tags on Pages."

To learn more about how you can use these services together, refer to Section 2.4, "Introducing Oracle WebCenter Services."

Note:

When you integrate the Documents service with the Search service, the Search service returns results from all content repository connections.

29.5 Setting Parameters to Upload Files to Content Repositories

The Document Manager task flow allows you to upload files into content repositories. Oracle WebCenter Framework uses Apache MyFaces Trinidad to handle file upload from a browser to the application server.

To change the default settings of Apache MyFacesTrinidad, you can add three parameters to the web.xml file. To edit this file, open the ViewController project of your application. Under Web Content, open the web.xml file. In the Overview, navigate to Application > Context Initialization Parameters, then click the green plus (+) sign to add the parameters and their values (as described in Table 29-1) or simply update the code in the Source view. After you've made your changes, save the web.xml file, then restart Oracle JDeveloper.

Table 29-1 Apache MyFaces Trinidad Parameters

Parameter Description
UPLOAD_MAX_MEMORY

The maximum amount of memory in kilobytes that a single file can use when uploaded.

UPLOAD_MAX_DISK_SPACE

The maximum amount of disk space in kilobytes that a single file can use when uploaded.

UPLOAD_TEMP_DIR

The directory in which the file being uploaded is temporarily stored.


For more information, see the Apache MyFaces Trinidad documentation, located at http://myfaces.apache.org/trinidad/devguide/fileUpload.html.

29.6 Using Adapters with the Documents Service

To learn more about using existing adapters for the content repository connections, see Chapter 26, "Configuring Content Repository Connections."