3 Navigation and Help

This chapter describes the navigation steps in the Oracle Retail Integration Bus Hospital Administration or RIB Hospital Administration (RIHA) application.

Log in to RIHA

This procedure explains how to log in to the application.

1. Enter the application URL http://<host>:<port>/riha-web in the address bar of the browser.

   
   

   Note: Using Mozilla Firefox Web browser is recommended.

   
   
   
   Description of the illustration ''login.gif''
   
   

2. In the User Name field, enter the user name configured at the time of installation of the application.

3. In the Password field, enter the password.

4. Select the application name from the drop down to go the error hospital details of a particular application.

5. Click Login. The application home page appears.

   
   Description of the illustration ''homepage.gif''
   
   

Search for a Hospital Record

This procedure explains how to search for a hospital record in RIHA.

Basic Search

By default, the basic search option is enabled. Basic search is done using the Equal to operator against the given search values.

Click Reset to clear the data from search fields.

To perform a Basic Search:

1. Log in to the application.

   
   Description of the illustration ''search_criteria.gif''
   
   

2. In the Search Criteria section, enter or select the criteria to limit your search in one or more of the following fields:

   • Family

   • ID

   • Publish Time

   • RIB Message ID

   • Message Type

     
     

     Note: Select All to match all fields in the search. Select Any to match any field in the search criteria.

     
     

3. Click Search. The hospital records that match the search criteria are populated in the search results table.

   
   Description of the illustration ''search_results.gif''
   
   

Advanced Search

By default, the basic search option is selected in the application. In the search panel, click Advanced to switch to advanced search option. Advanced search allows you to add more search fields to the search criteria. Click Add Fields to add more fields.In the advanced search, the operators of each search field can be changed to other available options.Click Basic to switch back to the basic search option.Click Reset to clear the data from search fields.

To perform an Advanced Search:

1. Log in to the application.

2. Click Advanced in the search panel.

   
   Description of the illustration ''advanced_search.gif''
   
   

3. Click Add Fields. Additional fields are listed. Select the required fields to add to the search criteria.

   • Click the red cross mark icon besides the field to remove the field from the search criteria.

4. Enter values in the respective fields and click Search. The hospital records that match the search criteria are populated in the search results table.

Delete a Message

This procedure explains how to mark a message for deletion from the RIB Hospital.

1. Log in to the application.

2. Search for hospital records.

3. Select a row that represents a hospital record.

4. Click Delete. A confirmation dialog box appears.

   
   

5. The message is deleted when the hospital retry adapters and/or process checks for messages to be deleted from the RIB Hospital.

Note: A message that is in queue (as indicated when the check box in the In Queue column is selected) cannot be deleted.

Stop a Message

This procedure explains how to stop a retry adapter and/or a process from attempting to retry a message.

1. Log in to the application.

2. Search for a message.

3. Select a row that represents a hospital record.

4. Click Stop. The retry adapter and/or a process does not attempt to reprocess the message until you select the message for Retry.

Note: A message that is in queue (as indicated when the check box in the In Queue column is selected) cannot be stopped.

Retry a Message

This procedure explains how to retry a message after you have stopped the retry adapter and/or process from re-processing it.

1. Log in to the application.

2. Search for a message.

3. Select a row that represents a hospital record.

4. Click one of the following buttons:

   • RetryAllEligibleRecordsInPage - This option will retry all the eligible records in current page which is being displayed. (See note below for delete criteria)

   • RetryAllEligibleRecords - This option will retry all the eligible records in all of the pages.

   • RetrySelectedRecords - This will retry records that are selected using the multi-select option.

Note: A message that is in queue (as indicated by the check box in the In Queue column is selected) or pending deletion (as indicated by the check box in the Delete Pending column is selected) cannot be retried.

View and Edit a Message

This procedure explains how to view a message.

1. Log in to the application.

2. Search for hospital records.

3. Click the Load Message Details on Selection check box located in the search results table.

4. Select a row to view the payload of hospital records.

5. Click the Message Viewer tab. The message viewer displays the payload in text mode.

   
   

6. You can edit the message shown and click Save to save the message.

Save a Message Locally

This procedure explains how to save a message locally.

1. Search for a message and select a row.

2. Click Save To File. The message is saved to a RibMessage.xml, a text file named by default.

Import a New Hospital Record to Hospital Tables

This procedure explains how to retrieve a message from a local location.

1. Click Import.

2. Search for a message and select a row.

   • A popup browser opens with an option to browse for a hospital entry to be loaded.

The message must be in the following specified format.

<HospitalEntry>
<AdapterClassLocation>AdapterClassLocation</AdapterClassLocation>
<Family>Family</Family>
<Type>Type</Type>
<TopicName>TopicName</TopicName>
<CustomFlag>F</CustomFlag>
<CustomData> <![CDATA[ CustomData ]]> </CustomData>
<ReasonCode>ReasonCode</ReasonCode>
<RibMessagePayloadView>
<RibMessagePayload>
<MessageData> <![CDATA[ <Message Xml> ]]> </MessageData>
</RibMessagePayload>
</RibMessagePayloadView>
<RibMessageRoutingInfoView>
<RibMessageRoutingInfo>
<SeqNumber>0</SeqNumber>
<Name>Name</Name>
<Value>Value</Value>
<Detail1Name>DetailName</Detail1Name>
<Detail1Value>DetailValue</Detail1Value>
</RibMessageRoutingInfo>
</RibMessageRoutingInfoView>
</HospitalEntry>

Update an Existing Hospital Record

This procedure explains how to update an existing hospital record location.

1. Search for a message and select a row (see View and Edit a Message).

2. Save the hospital entry locally (See Save a Message Locally).

3. Edit the hospital entry file.

   • Do not edit or remove any of the <MessageNum> attributes.

4. Click Import.

   • A popup browser window opens with an option to browse for the edited hospital entry to be loaded.

     
     

The message must be in the same format in which it was saved.

Format the hospital entry to be updated.

<HospitalEntry>
   <MessageNum>12345</MessageNum>
   <AdapterClassLocation>AdapterClassLocation</AdapterClassLocation>
   <Family>Family</Family>
   <Type>Type</Type>
   <RibMessageId>RibMessageId</RibMessageId>
   <Id>Id</Id>
   <PublishTime>YYYY-MM-DD HH:MM:SS</PublishTime>
   <TopicName>TopicName</TopicName>
   <ThreadValue>Threadvalue</ThreadValue>
   <JmsQueueId>jmsId</JmsQueueId>
   <CustomFlag>F</CustomFlag>
   <CustomData>    <![CDATA[  CustomData   ]]>   </CustomData>
   <ReasonCode>ReasonCode</ReasonCode>
   <RibMessagePayloadView>
      <RibMessagePayload>
         <MessageNum>12345</MessageNum>
         <MessageData> <![CDATA[ <Message Xml> ]]>  </MessageData>
      </RibMessagePayload>
   </RibMessagePayloadView>
   <RibMessageRoutingInfoView>
      <RibMessageRoutingInfo>
         <SeqNumber>0</SeqNumber>
         <Name>Name</Name>
         <Value>Value</Value>
         <Detail1Name>DetailName</Detail1Name>
         <Detail1Value>DetailValue</Detail1Value>
      </RibMessageRoutingInfo>
   </RibMessageRoutingInfoView>
</HospitalEntry>

View Hospital Record Details

This procedure explains how to see detailed information about a hospital record.

Description of the illustration ''hos_rec_details.gif''

1. Search for a message (see "View and Edit a Message").

2. Select a row that represents a hospital record.

   • By default, the Hospital Records Detail tab is active and displays the selected row's hospital record details.

   • The size of the pane can be adjusted by using the arrow mark located in the right side of the pane.

View the Error History of a Message

This procedure explains how to view a message's error history.

1. Search for a message (see "View and Edit a Message").

2. Select a row that represents a hospital record.

   • By default the Hospital Records Details tab is active and displays hospital record details for the selected row.

   • Click on the arrow located near the error history. This will expand the pane and display errors associated with each of the possible retry attempts.

View the Hospital Reference Information of a Message

This procedure explains how to view a message's hospital reference information.

Note: This pane contains data that applies only to retailers who have access to the custom code.

This pane displays records that are already in the RIB_MESSAGE table but are prevented from being retried until another record has been successfully retried. Once the other record has been successfully retried, the Reason Code in the RIB_MESSAGE table for the record being referenced in the Hospital Reference column is set to the new Reason Code to make it available for retry. View the hospital record details for a message (see View Hospital Record Details).

Description of the illustration ''hos_rec_hos_ref_info.gif''

1. Search for a message (see View and Edit a Message).

2. Select a row that represents a hospital record.

   • By default the Hospital Records Details tab is active and displays hospital record details of the selected row.

   • Click on the arrow located near the hospital reference information. This will expand the pane and display associated reference information.

View the Routing Information of a Message

Description of the illustration ''hos_rec_routing_info.gif''

This procedure explains how to view a message's routing information.

1. Search for a message (see View and Edit a Message).

2. Select a row that represents a hospital record.

   • By default the Hospital Records Details tab is active and displays hospital record details of the selected row.

   • Click on the arrow located near the routing information. This will expand the pane and display associated reference information.