<!doctype html>
<html>
<head>
<title>Adding a Group</title>
<link rel="stylesheet" href="styles/site.css" type="text/css">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" href="styles/icons.css" type="text/css">
<script src="js/jquery.min.js"></script>
<script src="tree/collapsibleTreeMenu.js"></script>
<link href="tree/collapsibleTreeMenu.css" rel="stylesheet" type="text/css">
</head>
<body class="theme-default aui-theme-default">
<div id="page">
<div id="main" class="aui-page-panel">
<div id="main-header">
<div id="breadcrumb-section">
<ol id="breadcrumbs">
<li> <span><a href="Rhapsody-Integration-Engine-6.5_133160975.html">Rhapsody Integration Engine 6.5</a></span> </li>
<li> <span><a href="Developing-Rhapsody_133161055.html">Developing Rhapsody</a></span> </li>
<li> <span><a href="Rhapsody-Objects_133161790.html">Rhapsody Objects</a></span> </li>
<li> <span><a href="Rhapsody-Components_133161994.html">Rhapsody Components</a></span> </li>
<li> <span><a href="Filters_133162681.html">Filters</a></span> </li>
<li> <span><a href="Filter-Types_133162712.html">Filter Types</a></span> </li>
<li> <span><a href="HL7-Filters_133163076.html">HL7 Filters</a></span> </li>
<li> <span><a href="HL7-Message-Modifier_133163077.html">HL7 Message Modifier</a></span> </li>
<li> <span><a href="Configure_133163111.html">Configure</a></span> </li>
</ol>
</div>
<h1 id="title-heading" class="pagetitle"> <span id="title-text">Adding a Group</span> </h1>
</div>
<div id="content" class="view">
<div id="main-content" class="wiki-content group">
<p> <map id="gliffy-map-133163254-5439" name="gliffy-map-133163254-5439"></map> </p>
<table width="100%" class="gliffy-macro-table">
<tbody>
<tr>
<td>
<table class="gliffy-macro-inner-table">
<caption align="bottom">
</caption>
<tbody>
<tr>
<td> <img style="border: none; width: 602px;" usemap="#gliffy-map-133163254-5439" src="attachments/133163250/133163253.png" alt="" class="gliffy-macro-image"> </td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
</table>
<p></p>
<p>When you enter the HL7 Message Modifier filter's configuration options for the first time, you are presented with a page that prompts you to <a href="#AddingaGroup-LoadingaSampleMessage">load sample messages</a>.</p>
<p> <map id="gliffy-map-133163256-757" name="gliffy-map-133163256-757"></map> </p>
<table width="100%" class="gliffy-macro-table">
<tbody>
<tr>
<td>
<table class="gliffy-macro-inner-table">
<caption align="bottom">
</caption>
<tbody>
<tr>
<td> <img style="border: none; width: 1224px;" usemap="#gliffy-map-133163256-757" src="attachments/133163250/133163255.png" alt="" class="gliffy-macro-image"> </td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
</table>
<p></p>
<h2 id="AddingaGroup-LoadingaSampleMessage">Loading a Sample Message</h2>
<p>You can manage sample messages by performing the following actions:</p>
<ul>
<li><a href="#AddingaGroup-AddingaSampleMessage">Adding a Sample Message</a></li>
<li><a href="#AddingaGroup-SelectingaSampleMessage">Selecting a Sample Message</a></li>
<li><a href="#AddingaGroup-EditingaSampleMessage">Editing a Sample Message</a></li>
<li><a href="#AddingaGroup-CloningaSampleMessage">Cloning a Sample Message</a></li>
<li><a href="#AddingaGroup-DeletingaSampleMessage">Deleting a Sample Message</a></li>
</ul>
<h3 id="AddingaGroup-AddingaSampleMessage">Adding a Sample Message</h3>
<p>To add a new sample message:</p>
<ol>
<li><p>Click the <strong>Sample Messages</strong> link at the top or select the <span class="confluence-embedded-file-wrapper confluence-embedded-manual-size"><img class="confluence-embedded-image confluence-thumbnail" width="18" src="attachments/133163250/133163262.png" data-image-src="attachments/133163250/133163262.png" data-unresolved-comment-count="0" data-linked-resource-id="133163262" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="AddIconLarge.png" data-base-url="https://docs.rhapsody.health" data-linked-resource-content-type="image/png" data-linked-resource-container-id="133163250" data-linked-resource-container-version="1"></span> icon (if no message has been selected) to display the <strong>Sample Message Manager</strong> dialog: </p><p> <map id="gliffy-map-133163259-5952" name="gliffy-map-133163259-5952"></map> </p>
<table width="100%" class="gliffy-macro-table">
<tbody>
<tr>
<td>
<table class="gliffy-macro-inner-table">
<caption align="bottom">
</caption>
<tbody>
<tr>
<td> <img style="border: none; width: 968px;" usemap="#gliffy-map-133163259-5952" src="attachments/133163250/133163258.png" alt="" class="gliffy-macro-image"> </td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
</table> <p></p></li>
<li>Enter a message name in the <strong>Message Name</strong> field.</li>
<li>Either upload a sample message file using the <strong>Filename Browser</strong> or enter the message contents manually in the <strong>Sample Message Contents</strong> field.</li>
<li>Click the <strong>Add as a New Message</strong> link to add the message to the sample message list.</li>
<li>Select the <strong>Close</strong> button to exit the <strong>Sample Message Manager</strong> dialog.</li>
</ol>
<h3 id="AddingaGroup-SelectingaSampleMessage">Selecting a Sample Message</h3>
<p>To select a sample message to test your changes, select the message name from the drop-down list next to the <strong>Sample Messages</strong> link.</p>
<h3 id="AddingaGroup-EditingaSampleMessage">Editing a Sample Message</h3>
<p>To edit a sample message:</p>
<ol>
<li>In the <strong>Sample Message Manager</strong>, click the message name in the <strong>Loaded Sample Messages Table</strong>. The <span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image" src="attachments/133163250/133163263.gif" data-image-src="attachments/133163250/133163263.gif" data-unresolved-comment-count="0" data-linked-resource-id="133163263" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="signoff.gif" data-base-url="https://docs.rhapsody.health" data-linked-resource-content-type="image/gif" data-linked-resource-container-id="133163250" data-linked-resource-container-version="1"></span> icon appears next to the name to indicate it is being edited.</li>
<li>Edit the sample message in the <strong>Sample Message Contents</strong> field or change the message name in the <strong>Message Name</strong> field.</li>
<li>Click the <strong>Apply changes to Message</strong> link to save the changes in the message.</li>
<li>Select the <strong>Close</strong> button to exit the <strong>Sample Message Manager</strong> dialog.</li>
</ol>
<h3 id="AddingaGroup-CloningaSampleMessage">Cloning a Sample Message</h3>
<p>To clone an existing sample message:</p>
<ol>
<li>In the <strong>Sample Message Manager</strong>, click the message name in the <strong>Loaded Sample Messages Table</strong>. The <span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image" src="attachments/133163250/133163263.gif" data-image-src="attachments/133163250/133163263.gif" data-unresolved-comment-count="0" data-linked-resource-id="133163263" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="signoff.gif" data-base-url="https://docs.rhapsody.health" data-linked-resource-content-type="image/gif" data-linked-resource-container-id="133163250" data-linked-resource-container-version="1"></span> icon appears next to the name to indicate it is being edited.</li>
<li>Change the message name in the <strong>Message Name</strong> field.</li>
<li>Edit the message in the <strong>Sample Message Contents</strong> field if required.</li>
<li>Click the <strong>Add as a New Message</strong> link to add the message to the sample message list.</li>
<li>Select the <strong>Close</strong> button to exit the <strong>Sample Message Manager</strong> dialog.</li>
</ol>
<h3 id="AddingaGroup-DeletingaSampleMessage">Deleting a Sample Message</h3>
<p>To delete a sample message, select the <span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image" src="attachments/133163250/133163264.gif" data-image-src="attachments/133163250/133163264.gif" data-unresolved-comment-count="0" data-linked-resource-id="133163264" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="remove.gif" data-base-url="https://docs.rhapsody.health" data-linked-resource-content-type="image/gif" data-linked-resource-container-id="133163250" data-linked-resource-container-version="1"></span> icon.</p>
<h2 id="AddingaGroup-ModifyingaChangeGroup">Modifying a Change Group</h2>
<p>After you have loaded (or selected) a sample message, the sample input message and its modified version (sample result) are displayed. You can then add or modify change groups by performing the following actions:</p>
<ul>
<li><a href="#AddingaGroup-AddingaChangeGroup">Adding a Change Group</a></li>
<li><a href="#AddingaGroup-ViewingaChangeGroup">Viewing a Change Group</a></li>
<li><a href="#AddingaGroup-EditingaChangeGroup">Editing a Change Group</a></li>
<li><a href="#AddingaGroup-DeletingaChangeGroup">Deleting a Change Group</a></li>
</ul>
<p> <map id="gliffy-map-133163252-7229" name="gliffy-map-133163252-7229"></map> </p>
<table width="100%" class="gliffy-macro-table">
<tbody>
<tr>
<td>
<table class="gliffy-macro-inner-table">
<caption align="bottom">
</caption>
<tbody>
<tr>
<td> <img style="border: none; width: 1266px;" usemap="#gliffy-map-133163252-7229" src="attachments/133163250/133163251.png" alt="" class="gliffy-macro-image"> </td>
</tr>
</tbody>
</table> </td>
</tr>
</tbody>
</table>
<p></p>
<div class="table-wrap">
<table class="confluenceTable">
<tbody>
<tr>
<th class="confluenceTh"><p>Configuration Element</p></th>
<th class="confluenceTh"><p>Description</p></th>
</tr>
<tr>
<td class="confluenceTd"><p>Navigation Panel</p></td>
<td class="confluenceTd"><p>Contains the <strong>All Changes</strong> link, <strong>Add New Change Group</strong> button and user-created change groups.</p></td>
</tr>
<tr>
<td class="confluenceTd"><p>Sample Input Message Panel</p></td>
<td class="confluenceTd"><p>If <strong>Message</strong> is toggled on, a read-only version of the input sample message is displayed.</p><p>If <strong>Properties</strong> is toggled on, then a list of properties and variables referenced in your changes (<a href="Adding-a-Rule_133163114.html#AddingaRule-Rules">rules</a>) is displayed along with input boxes alongside them enabling you to modify the test values they store.</p></td>
</tr>
<tr>
<td class="confluenceTd"><p>Sample Result Panel</p></td>
<td class="confluenceTd"><p>If <strong>Message</strong> is toggled on, the result of applying all changes defined under the selected change group to the sample message in the <strong>Sample Input Message Panel</strong>. Changes are highlighted in green.</p>
<div class="confluence-information-macro confluence-information-macro-note">
<span class="aui-icon aui-icon-small aui-iconfont-warning confluence-information-macro-icon"></span>
<div class="confluence-information-macro-body">
<p>If you modify a field to a value which includes the field separator (in other words, turning one field into multiple fields, for example, <code>value1|value2|value3</code>), the highlighting will not work properly from that point onwards. This limitation does not apply to values that include only component and sub-component separators.</p>
</div>
</div><p>If <strong>Properties</strong> is toggled on, then a read-only list of modified properties is displayed.</p></td>
</tr>
<tr>
<td class="confluenceTd"><p>Change Group Name Field</p></td>
<td class="confluenceTd"><p>Mandatory field used to enter the change group name.</p></td>
</tr>
<tr>
<td class="confluenceTd"><p>Change Group Description Field</p></td>
<td class="confluenceTd"><p>Recommended field used to enter a change group description.</p></td>
</tr>
<tr>
<td class="confluenceTd"><p>Define A Segment to Modify Link</p></td>
<td class="confluenceTd"><p>Click to display the <strong>Define A Segment to Modify</strong> dialog. Refer to <a href="Adding-a-Segment_133163222.html">Defining a Segment</a> for details.</p></td>
</tr>
<tr>
<td class="confluenceTd"><p>Sample Messages Link</p></td>
<td class="confluenceTd"><p>Click to display the <strong>Sample Message Manager</strong>. Refer to <a href="#AddingaGroup-LoadingaSampleMessage">Loading a Sample Message</a> for details.</p></td>
</tr>
<tr>
<td class="confluenceTd"><p>Sample Messages Selector</p></td>
<td class="confluenceTd"><p>A drop-down list that allows you to select a loaded sample message.</p></td>
</tr>
<tr>
<td class="confluenceTd"><p>Add New Change Group Button</p></td>
<td class="confluenceTd"><p>Select to add a new change group.</p></td>
</tr>
</tbody>
</table>
</div>
<h3 id="AddingaGroup-AddingaChangeGroup">Adding a Change Group</h3>
<p>To create a new change group:</p>
<ol>
<li>Select the <span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image" src="attachments/133163250/133163265.png" data-image-src="attachments/133163250/133163265.png" data-unresolved-comment-count="0" data-linked-resource-id="133163265" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="folder-add-closed.png" data-base-url="https://docs.rhapsody.health" data-linked-resource-content-type="image/png" data-linked-resource-container-id="133163250" data-linked-resource-container-version="1"></span> button. A new change group called <strong>Untitled</strong> is added to the <strong>Navigation Panel</strong>.</li>
<li>Enter a change group name into the <strong>Change Group Name</strong> field.</li>
<li>It is recommended you enter a description of the change group in the <strong>Description</strong> field.</li>
<li>If this is the first change group being added to the filter, add a sample message. Refer to <a href="#AddingaGroup-AddingaSampleMessage">Adding a Sample Message</a> for details.</li>
<li>Click the <strong>Ok</strong> link to save your changes or the <strong>Cancel</strong> link to discard them. A page that lists the change group's details (in read-only mode) is displayed.</li>
<li>To add a segment to your change group for modification, refer to <a href="Adding-a-Segment_133163222.html">Adding a Segment</a> for details.</li>
</ol>
<h3 id="AddingaGroup-ViewingaChangeGroup">Viewing a Change Group</h3>
<p>To view a change group, click on its name in the <strong>Navigation Panel</strong>.</p>
<h3 id="AddingaGroup-EditingaChangeGroup">Editing a Change Group</h3>
<p>To edit the change group name or description, click the <strong>Edit</strong> link.</p>
<h3 id="AddingaGroup-DeletingaChangeGroup">Deleting a Change Group</h3>
<p>To delete a change group, select the <span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image" src="attachments/133163250/133163264.gif" data-image-src="attachments/133163250/133163264.gif" data-unresolved-comment-count="0" data-linked-resource-id="133163264" data-linked-resource-version="1" data-linked-resource-type="attachment" data-linked-resource-default-alias="remove.gif" data-base-url="https://docs.rhapsody.health" data-linked-resource-content-type="image/gif" data-linked-resource-container-id="133163250" data-linked-resource-container-version="1"></span> icon which appears when you hover the mouse over the change group name in the <strong>Navigation Panel</strong>.</p>
<p> </p>
</div>
</div>
</div>
</div>
</body>
</html>