Configuring the XDS Connector for Oracle WebCenter Content
12c (12.2.1.2.0)
E47922-01
October 2016
Cross Enterprise Document Sharing (XDS) is a standard used by the Integrating The Healthcare Enterprise (IHD) initiative to help medical devices that create documents, such as MRI machines, to better communicate with content repositories. For more information about the initiative, including details about the XDS specification, see http://wiki.ihe.net
.
XDS is a data exchange specification composed of the following elements which communicate with each other using standard SOAP-based web services:
Patient Identity Source: identity management used to determine the user.
Document Registry: used to store metadata for a medical document and used for searching. The location of the registry is set during the configuration of the WebCenter Content XDS Connector.
Document Consumer: a web interface or other type of viewer used to view the medical content.
Document Source: the creator of the medical content. This is typically an X-ray or MRI machine that creates medical images. The unique ID for the document is supplied by the Document Source. It is not generated by WebCenter Content.
Document Repository: the content repository used to store the medical content.
Activity must be logged to an Audit Trail and Node Authentication (ATNA) compatible server in order to be compliant.
The WebCenter Content XDS Connector is used to allow Oracle WebCenter Content and the content server to act as a repository in an XDS exchange.
With the WebCenter Content XDS Connector enabled, documents are downloaded to the repository in WebCenter Content. The downloading is based on a unique XDS-specific document ID supplied by the Document Source.
The WebCenter Content XDS Connector is an XDS repository that must be integrated with a separate XDS registry. Any calls that are only for a registry are not implemented. Any call that requires both a registry and a repository, such as the Provide and Register Document Set-b, use WebCenter Content as the XDS repository and a remote XDS registry for the metadata.
The WebCenter Content XDS Connector listens for requests from Document Sources and performs one of two actions:
store a document with its metadata: the document is stored and the metadata is forwarded to a central Document Registry.
store a document: the document and its unique ID are stored.
The following figure shows the general flow of information in an XDS data exchange system.
The XDS repository is specified in two Web Service Description Language (WSDL) documents:
XDS.b_DocumentRepository.wsdl
XDS-I.b_ImagingDocumentSource.wsdl
These WSDLs provide implementation requirements for the following XDS-compatible web services:
XDS.b Provide and Register Document Set-b [ITI-41]
XDS.b Retrieve Document Set [ITI-43]
XDS-I.b Provide and Register Image Document Set [RAD-68]
XDS-I.b Retrieve Imaging Document Set [RAD-69]
The XDS.b Register Document Set-b [ITI-42] registry service is included but is not implemented. Even though this implementation does not support the XDS Registry service calls, it stores the metadata from a Provide and Register request, bundling the data into an XML file which is checked into WebCenter Content with the image document. If you should lose your XDS registry, the entire history can thus be restored using the XDS repository in WebCenter Content.
Note that the WSDL definition for the Provide and Register transaction sent by the Imaging Document Source [RAD-68] is no different than the transaction sent by the XDS.b Document Source in [ITI-41].
The following figure demonstrates how the WebCenter Content XDS Connector works with the WebCenter Content repository to store information.
In order to use the WebCenter Content XDS Connector with WebCenter Content, you must create a profile as well as create a local user.
You should create the custom metadata field xXdsDocUid
before creating the profile. This metadata field is used to store the unique ID of an XDS document.
For details about creating profiles, see Creating, Editing, or Deleting a Profile in Oracle Fusion Middleware Managing Oracle WebCenter Content. For details about adding users, see Managing User Types, Logins, and Aliases in Oracle Fusion Middleware Administering Oracle WebCenter Content.
The following steps describe the procedure to create a local user:
Note:
Example names are given in the following text. You can use other names if needed.
The information about how to connect to WebCenter Content is bundled into this WAR file in the web.xml file.
For a production deployment, make changes to the WAR file with a Deployment Plan. For a development installation, changes can be made manually.
Locate the Web Application Archive (WAR) file in the ucm/Distribution/XDS directory.
The following steps describe the procedure to configure the file:
After configuring the WAR file, deploy the application. This documentation assumes that you are familiar with the process for deploying applications on Oracle WebLogic Server.
The WebCenter Content XDS Connector has no user interface per se. It is a SOAP web service endpoint for the services that are used, and a Java Server Page (JSP) that provides the URLs to the WSDLs. An introductory overview web page is available which lists information about the current configuration and provides a summary of setup instructions.
To integrate with the WebCenter Content XDS Connector, you need an XDS-compatible agent. It must point to the SOAP endpoints in the WebCenter Content XDS Connector. There is one endpoint for an XDS.b compatible repository and one for an XDS-I.b compatible repository, as in this example:
http://example.com:13200/ucmxds/DocumentRepositoryB http://example.com:13200/ucmxds/ImagingDocumentSource
These locations will vary depending on the how the WAR file was deployed. After deployment, the root home page has links to these endpoints.
You can monitor the component by enabling tracing. To enable tracing:
Tracing is enabled if the TracingEnabled flag is set to true when you deploy the UCMXDS application. For more information, see Configuring the WebCenter Content XDS Connector WAR File.
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
Access to Oracle Support
Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.
Oracle® Fusion Middleware Configuring the XDS Connector for Oracle WebCenter Content, 12c (12.2.1.2.0)
E47922-01
Copyright © 2013, 2016, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.