CONNECT 5.1.2 patch Release Notes

Overview

The following  improvements were added in this patch to the CONNECT 5.1.2 release:

Exchange Manager

  • Multiple exchange community targeting - send requests to non-default exchange endpoints
  • Organizational endpoint override - replace existing endpoints with user-specified URLs

AdminGUI Test Data Loader

  • Document Tab – CreationDateTime is optional for OnDemand documents.

DocumentQuery Reference Adapter:

  • Filtering Document Query response by serviceStartTime and serviceStopTime, only if they are know to the responding system.

This patch can be downloaded from the CONNECT Binaries by Release page.

The following Exchange Manager improvements were previously added to the CONNECT 5.1.1 patch and are also included in CONNECT 5.1.2:

  • Multiple exchange community targeting - send requests to non-default exchange endpoints
  • Organizational endpoint override - replace existing endpoints with user-specified URLs

Patch release testing

The CONNECT 5.1.2 patch was vetted prior to release via successful execution of the following release testing procedures:

  • Installation testing on all supported application servers
  • Interop testing bidirectionally with CONNECT 5.1.2 and CONNECT 5.0 (WildFly to all other application servers)
  • Admin GUI smoke testing on all application servers
  • Full Exchange Manager GUI testing on all application servers
  • Manual re-testing of exchange targeting 
  • Manual re-testing of endpoint override

Multiple exchange community targeting

A new <exchangeName> element has been added to the <NhinTargetCommunities> block to enable users to specify a particular exchange for targeting. If no exchange is specified, the default exchange will be used. Also see /wiki/spaces/CONNECTWIKI/pages/542769185.

Sample exchange community targeting
		<urn:NhinTargetCommunities>
        	<urn1:exchangeName>TestExchange</urn1:exchangeName>
            <urn1:nhinTargetCommunity>
               <urn1:homeCommunity>
                  <urn1:description>TARGET ORGANIZATION</urn1:description>
                  <urn1:homeCommunityId>TARGET HCID</urn1:homeCommunityId>
                  <urn1:name>TARGET ENDPOINT</urn1:name>
               </urn1:homeCommunity>
            </urn1:nhinTargetCommunity>
		</urn:NhinTargetCommunities>

Organizational endpoint override

A new exchange type (overrides) has been added to enable users to override existing endpoints or instantiate non-existing ones at runtime. This feature is only for NwHIN endpoints and available only in exchangeInfo.xml.  The below snippet shows the overrides exchange as defined in exchangeInfo.xml. Also see /wiki/spaces/CONNECTWIKI/pages/278528020.

sample exchangeInfo with overrides
    <exchange type="overrides">
      <url>https://testurl/uddi/list</url>
      <organizationList>
        <organization>
          <ns2:name>Gateway 2</ns2:name>
          <ns2:hcid>urn:oid:2.2</ns2:hcid>
          <ns2:endpointList>
            <ns2:endpoint>
              <ns2:name>QueryForDocuments</ns2:name>
              <ns2:endpointConfigurationList>
                <ns2:endpointConfiguration>
                  <ns2:url>https://localhost:8181/YourOverride-URL</ns2:url>
                  <ns2:version>2.0</ns2:version>
                </ns2:endpointConfiguration>
                <ns2:endpointConfiguration>
                  <ns2:url>https://localhost:8181/YourOverride-URL</ns2:url>
                  <ns2:version>3.0</ns2:version>
                </ns2:endpointConfiguration>
              </ns2:endpointConfigurationList>
            </ns2:endpoint>
            <ns2:endpoint>
              <ns2:name>RetrieveDocuments</ns2:name>
              <ns2:endpointConfigurationList>
                <ns2:endpointConfiguration>
                  <ns2:url>https://localhost:8181/YourOverride-URL</ns2:url>
                  <ns2:version>2.0</ns2:version>
                </ns2:endpointConfiguration>
              </ns2:endpointConfigurationList>
            </ns2:endpoint>
          </ns2:endpointList>
          <ns2:targetRegion>US-NY</ns2:targetRegion>
          <ns2:targetRegion>US-VA</ns2:targetRegion>
        </organization>
      </organizationList>
    </exchange>