Obscure Data - Reveal Primary Document Service

The Obscure Data - Reveal Primary Document service restores primary document content previously obscured by using the Obscure Data - Obscure Primary Document service to a plain text form.

The following table provides an overview of the Obscure Data - Reveal Primary Document service:

Category	Description
System name	Reveal Document
Graphical Process Modeler (GPM) category	All Services (as RevealDocument)
Description	The Obscure Data - Reveal Primary Document service is used to restore primary document content previously obscured by using the Obscure Data - Obscure Primary Document service to a plain text form.
Business usage	In Sterling B2B Integrator, data processed by a business process (such as the contents of process data and the primary document), while or after, it is executed is normally available in plain text and is easily viewable. You can use the Obscure Data - Obscure Primary Document service to help restrict access to sensitive data, such as passwords, by masking the data into an unintelligible form. You will use the Obscure Data - Reveal Primary Document service to restore the previously obscured content of the primary document to a plain text form.
Usage example	Assume that you use Sterling B2B Integrator to process and transmit payroll information to your payroll service provider. To prevent your system management personnel from having access to it, your business process placed the sensitive payroll information in the primary document and used the Obscure Data - Obscure Primary Document service to obscure the entire content of the primary document. You will use the Obscure Data - Reveal Primary Document service to restore the information to a plain text version in the primary document, before transmitting it to the payroll service provider.
Preconfigured?	Yes. A preconfigured instance of the Obscure Data - Reveal Primary Document service named RevealDocument_Instance is available. There are no configuration parameters and no configuration is required. To use the service, just place RevealDocument_Instance in a business process.
Requires third-party files?	No
Platform availability	All supported Sterling B2B Integrator platforms
Related services	This service is designed to work in conjunction with the Obscure Data - Obscure Primary Document service. The content of the primary document obscured by the Obscure Data - Obscure Primary Document service can be restored to its original intelligible form with the Obscure Data - Reveal Primary Document service. Note: If you want to unobscure the contents of the primary document while extracting it to the file system, you may be able to use the unobscure parameter in the File System adapter. For more information, see File System Adapter.
Application requirements	None
Initiates business processes?	No
Invocation	This service is invoked from within a business process.
Business process context considerations	This service takes the obscured primary document as the input and replaces it with a plain text version of the primary document.
Returned status values	N/A
Restrictions	None
Persistence level	System default
Testing considerations	Test as part of a business process

Example Business Process

The following BPML demonstrates the use of the preconfigured instances of the Obscure Data - Obscure Primary Document service and the Obscure Data - Reveal Primary Document service.

<process name="myBusinessProcess">
  <sequence>
    <operation name="ObscureDocument">
    <participant name="ObscureDocument_Instance"/>
    <output message="ObscureDocumentInputMessage">
      <assign to="." from="*"></assign>
    </output>
    <input message="inmsg">
    </input>
  </operation>
INSERT OTHER BUSINESS PROCESS OPERATIONS HERE
    <operation name="RevealDocument">
    <participant name="RevealDocument_Instance"/>
    <output message="RevealDocumentInputMessage">
       <assign to="." from="*"></assign>
    </output>
    <input message="inmsg">
      <assign to="." from="*"></assign>
    </input>
    </operation>
INSERT OTHER BUSINESS PROCESS OPERATIONS HERE
  </sequence> 
</process>

For more examples of obscuring and unobscuring the primary document, see the examples in Obscure Data - Obscure Primary Document Service.