CentraSite Developer's Guide Innovation Release Version 10.0 April 2017 This document applies to CentraSite Version 10.0 and to all subsequent releases. Specifications contained herein are subject to change and these changes will be reported in subsequent release notes or new editions. Copyright © 2005-2017 Software AG, Darmstadt, Germany and/or Software AG USA Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors. The name Software AG and all Software AG product names are either trademarks or registered trademarks of Software AG and/or Software AG USA Inc. and/or its subsidiaries and/or its affiliates and/or their licensors. Other company and product names mentioned herein may be trademarks of their respective owners. Detailed information on trademarks and patents owned by Software AG and/or its subsidiaries is located at hp://softwareag.com/licenses. Use of this software is subject to adherence to Software AG's licensing conditions and terms. These terms are part of the product documentation, located at hp://softwareag.com/licenses and/or in the root installation directory of the licensed product(s). This software may include portions of third-party products. For third-party copyright notices, license terms, additional rights or restrictions, please refer to "License Texts, Copyright Notices and Disclaimers of Third Party Products". For certain specific third-party license restrictions, please refer to section E of the Legal Notices available under "License Terms and Conditions for Use of Software AG Products / Copyright and Trademark Notices of Software AG Products". These documents are part of the product documentation, located at hp://softwareag.com/licenses and/or in the root installation directory of the licensed product(s). Use, reproduction, transfer, publication or disclosure is prohibited except as specifically provided for in your License Agreement with Software AG. Document ID: CS-DG-100-20180418 M Table of Contents Table of Contents About this Guide..............................................................................................................................9 Document Conventions.............................................................................................................. 9 Online Information.................................................................................................................... 10 API for JAXR.................................................................................................................................. 11 Introduction to the CentraSite API for JAXR............................................................................12 Creating a JAXR-based Connection........................................................................................ 12 Closing a JAXR-based Connection..........................................................................................13 Defining a Service.................................................................................................................... 14 Service that Uses Another Service.......................................................................................... 14 Service with Additional Information.......................................................................................... 15 Pre-defined Classification Schemes (Taxonomies).................................................................. 15 CentraSite API for JAXR Reference Information..................................................................... 17 Creating User-Defined Objects......................................................................................... 17 Direct XQuery Access to the Stored Data........................................................................ 17 Unique Keys...................................................................................................................... 18 Simultaneous Database Access and Locking...................................................................18 Caller..................................................................................................................................20 Semantics of Remove Operations.................................................................................... 20 Delete Operation............................................................................................................... 21 Unsupported Methods....................................................................................................... 24 Unsupported FindQualifiers...............................................................................................24 Using Wildcards.................................................................................................................24 Using Namespaces........................................................................................................... 24 Method createSlot............................................................................................................. 25 Caching Considerations.....................................................................................................25 Web Service Interfaces................................................................................................................. 27 Introduction to the Web Service Interfaces..............................................................................28 Approval Service.......................................................................................................................28 Invoking Operations from the Approval Service................................................................29 Retrieving the List of Approval Requests that a User Has Submitted...............................29 Approving or Rejecting Approval Requests...................................................................... 31 Scrolling Through the List of Returned Approval Requests..............................................31 Reverting a Pending Approval Request............................................................................32 Operations......................................................................................................................... 33 Java Management Interface..........................................................................................................45 Introduction to Java Management Interface.............................................................................46 Attributes and Operations.........................................................................................................47 Customizing CentraSite.................................................................................................................51 CentraSite Developer's Guide Version 10.0 (Innovation Release) 3 M Table of Contents Customization of CentraSite Business UI................................................................................ 52 CentraSite Business UI Configuration Files......................................................................53 Customizing CentraSite Login Page................................................................................. 53 CentraSite Login Page Configuration.........................................................................55 Customizing CentraSite Welcome Page........................................................................... 59 CentraSite Welcome Page Configuration.................................................................. 61 Customizing CentraSite Content Page..............................................................................67 Log on to CentraSite Business UI............................................................................. 67 Request an Account...................................................................................................68 Extending Activity Menu.............................................................................................68 Implement Activity as an Extension....................................................................69 Enable Activity through Configuration.................................................................69 Replace Standard Search Widget..............................................................................73 Advanced Search Criteria.......................................................................................... 73 Browse Link................................................................................................................74 Browse Search Criteria.............................................................................................. 74 Extend Search View...................................................................................................75 Replace Standard Asset Detail Page........................................................................ 75 Extending Action Menu.............................................................................................. 75 Implement Action as an Extension..................................................................... 76 Enable Action through Configuration.................................................................. 77 Sample Custom Actions......................................................................................79 Adding Portlets........................................................................................................... 82 Implement Portlet as an Extension.....................................................................82