Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 What's in this Guide?

• 1.1 The Disc Framework
• 1.2 Toolkit Integration
• 1.3 Portlet Publishing
• 1.4 The REST API
• 1.5 The Dynamic Visitor Tools

2 Client-Side Development Technologies

• 2.1 Brief History of Client-Side Technology and the Portal
• 2.2 JavaScript
• 2.3 Ajax
• 2.4 Disc JavaScript Framework
• 2.5 Portal-Aware XMLHttpRequest
• 2.6 Web-Based and REST Style Services
• 2.7 JSON
• 2.8 Ajax Toolkits

3 The WLP Disc Framework

• 3.1 What is Disc?
• 3.2 Enabling Disc
  • 3.2.1 What Enabling Disc Means
  • 3.2.2 Enabling Disc in Oracle Enterprise Pack for Eclipse
  • 3.2.3 Enabling Disc in the Administration Console
  • 3.2.4 Using Disc Outside of a Portal
• 3.3 Using Portal-Aware XMLHttpRequest to Retrieve Data from a Non-Portal Source
  • 3.3.1 Use Case
  • 3.3.2 Example
• 3.4 Using Portal-Aware XMLHttpRequest to Update Portlets
  • 3.4.1 Use Cases
  • 3.4.2 Example
• 3.5 Using Context Objects
• 3.6 The XMLHttpRequest Interaction Engine
• 3.7 Event Handling
• 3.8 Manipulating URIs On the Client
  • 3.8.1 Background
  • 3.8.2 Using the URI API
• 3.9 Logging
  • 3.9.1 Example

4 Configuring JavaScript Libraries in a Portal Web Project

• 4.1 Creating a Simple Portal Project with Dojo
• 4.2 The Hello World JSP Portlet with Dojo
• 4.3 Creating a Render Dependencies File
  • 4.3.1 The Importance of Render Dependencies
  • 4.3.2 Creating the Sample Render Dependencies File

5 Portlet Publishing

• 5.1 What is Portlet Publishing?
  • 5.1.1 What is the Portlet Publishing Service?
  • 5.1.2 Asking the Portlet Publishing Service for Portlets
  • 5.1.3 Consuming a Published Portlet
• 5.2 Portlet Publishing URL Forms
  • 5.2.1 Library Instance URL Form
  • 5.2.2 Desktop Instance URL Form
• 5.3 Consuming Published Portlets
  • 5.3.1 Inline Frame Integration
    • 5.3.1.1 Example Code
    • 5.3.1.2 Embedding Static Portlets
    • 5.3.1.3 Embedding Dynamic Portlets
  • 5.3.2 DOM Integration
    • 5.3.2.1 Basic JavaScript Coding Steps
  • 5.3.3 Finding the Portlet Publishing Context
    • 5.3.3.1 Finding the Publishing Context for a Library Instance Portlet
    • 5.3.3.2 Finding the Publishing Context for a Desktop Instance Portlet
• 5.4 Advanced Topics
  • 5.4.1 Using the Decoration Parameter
  • 5.4.2 Integrating Multiple Portlets into the DOM
  • 5.4.3 Integrating Portlets from Multiple Publishing Contexts
  • 5.4.4 Specifying URL Redirect Options
• 5.5 Portlet Publishing vs. WSRP
• 5.6 Using JSP and HTML Portlet Publishing Templates
  • 5.6.1 Using the JSP Template
  • 5.6.2 Using the HTML Template
• 5.7 Limitations

6 Client-Side Development Best Practices

• 6.1 Namespacing
  • 6.1.1 A Simple Dynamic Table Portlet
  • 6.1.2 Namespace Collisions
  • 6.1.3 The Mysterious Table Row
• 6.2 Avoiding Namespace Collisions
  • 6.2.1 Using Ad Hoc Namespacing
  • 6.2.2 Using Rewrite Tokens
  • 6.2.3 Parameterizing Your JavaScript Functions
  • 6.2.4 Using the Disc APIs

7 The WebLogic Portal REST API

• 7.1 What is REST?
• 7.2 What is the WLP REST API?
  • 7.2.1 WLP REST API Reference Documentation
  • 7.2.2 REST API Use Cases
  • 7.2.3 REST Command Format
  • 7.2.4 Commonly Used REST Command Parameters
    • 7.2.4.1 The webapp Parameter
    • 7.2.4.2 The format Parameter
    • 7.2.4.3 The scope Parameter
  • 7.2.5 REST Command Example
• 7.3 Disabling REST Commands
• 7.4 Basic WLP REST API Examples
  • 7.4.1 Retrieving Information About a Single Portlet
  • 7.4.2 Changing the Title of a Portlet
  • 7.4.3 Moving a Book or Page
• 7.5 Using REST and Disc
  • 7.5.1 Constructing a REST URL Using Disc Context Objects
  • 7.5.2 Open and Send an XHR Request
  • 7.5.3 Handle the REST Response
  • 7.5.4 Putting It All Together