/// <summary>
/// Perform a identifier search on the organisation search service.
/// </summary>
/// <param name="request">
/// The search criteria. The following fields are expected:
/// <list type="bullet">
/// <item><description>hpioNumber (Mandatory)</description></item>
/// <item><description>linkSearchType (Conditional)</description></item>
/// </list>
/// All other fields are to be null.
/// </param>
/// <returns>
/// A response instance containing the result of the search:
/// <list type="bullet">
/// <item><description>serviceMessages</description></item>
/// <item>
/// <description><b>organisationProviderDirectoryEntries</b>
/// <list type="bullet">
/// <item><description>hpioNumber</description></item>
/// <item><description>organisationName</description></item>
/// <description><b>organisationDetails</b>
/// <list type="bullet">
/// <item><description>australianBusinessNumber</description></item>
/// <item><description>australianCompanyNumber</description></item>
/// </list>
/// </description>
/// <item><description>organisationService</description></item>
/// <item><description>address</description></item>
/// <item><description>electronicCommunicationRecord</description></item>
/// <item><description>endpointLocatorService</description></item>
/// <item><description>linkedProviders</description></item>
/// <item><description>linkedOrganisations</description></item>
/// <item><description>additionalComments</description></item>
/// <item><description>priorityNumber</description></item>
/// </list>
/// </description>
/// </item>
/// </list>
/// </returns>
public searchHIProviderDirectoryForOrganisationResponse IdentifierSearch(searchHIProviderDirectoryForOrganisation request)
{
Validation.ValidateArgumentRequired("request.hpioNumber", request.hpioNumber);
Validation.ValidateArgumentNotAllowed("request.australianAddressCriteria", request.australianAddressCriteria);
Validation.ValidateArgumentNotAllowed("request.internationalAddressCriteria", request.internationalAddressCriteria);
Validation.ValidateArgumentNotAllowed("request.name", request.name);
Validation.ValidateArgumentNotAllowed("request.organisationDetails", request.organisationDetails);
Validation.ValidateArgumentNotAllowed("request.organisationType", request.organisationType);
Validation.ValidateArgumentNotAllowed("request.serviceType", request.serviceType);
Validation.ValidateArgumentNotAllowed("request.unitType", request.unitType);
return(HISearch(request));
}
/// <summary>
/// Perform the service call.
/// </summary>
/// <param name="request">The search criteria in a searchHIProviderDirectoryForOrganisation object.</param>
/// <returns>The search results in a searchHIProviderDirectoryForOrganisationResponse object.</returns>
private searchHIProviderDirectoryForOrganisationResponse HISearch(searchHIProviderDirectoryForOrganisation request)
{
searchHIProviderDirectoryForOrganisationRequest envelope = new searchHIProviderDirectoryForOrganisationRequest();
envelope.searchHIProviderDirectoryForOrganisation = request;
envelope.product = product;
envelope.user = user;
envelope.hpio = hpio;
envelope.signature = new SignatureContainerType();
envelope.timestamp = new TimestampType()
{
created = DateTime.Now,
expires = DateTime.Now.AddDays(30),
expiresSpecified = true
};
// Set LastSoapRequestTimestamp
LastSoapRequestTimestamp = envelope.timestamp;
searchHIProviderDirectoryForOrganisationResponse1 response1 = null;
try
{
response1 = providerSearchHIProviderDirectoryForOrganisationClient.searchHIProviderDirectoryForOrganisation(envelope);
}
catch (Exception ex)
{
// Catch generic FaultException and call helper to throw a more specific fault
// (FaultException<ServiceMessagesType>
FaultHelper.ProcessAndThrowFault <ServiceMessagesType>(ex);
}
if (response1 != null && response1.searchHIProviderDirectoryForOrganisationResponse != null)
{
return(response1.searchHIProviderDirectoryForOrganisationResponse);
}
else
{
throw new ApplicationException(Properties.Resources.UnexpectedServiceResponse);
}
}
/// <summary>
/// Perform a demographic details search on the organisation search service.
/// </summary>
/// <param name="request">
/// The search criteria. The following fields can be provided:
/// <list type="bullet">
/// <item><description>name (Conditional)</description></item>
/// <item><description>organisationType (Optional)</description></item>
/// <item><description>serviceType (Optional)</description></item>
/// <item><description>unitType (Optional)</description></item>
/// <item><description>organisationDetails (Optional)</description></item>
/// <item>
/// <description><b>australianAddressCriteria</b> (Conditional)
/// <list type="bullet">
/// <item>
/// <description><b>unitGroup</b> (Optional)
/// <list type="bullet">
/// <item><description>unitType (Conditional)</description></item>
/// <item><description>unitNumber (Conditional)</description></item>
/// </list>
/// </description>
/// </item>
/// <item>
/// <description><b>levelGroup</b> (Optional)
/// <list type="bullet">
/// <item><description>levelType (Conditional)</description></item>
/// <item><description>levelNumber (Optional)</description></item>
/// </list>
/// </description>
/// </item>
/// <item><description>addressSiteName (Optional)</description></item>
/// <item><description>streetNumber (Optional)</description></item>
/// <item><description>lotNumber (Optional)</description></item>
/// <item><description>streetName (Optional)</description></item>
/// <item><description>streetType (Conditional on if streetTypeSpecified is set to true)</description></item>
/// <item><description>streetTypeSpecified (Mandatory)</description></item>
/// <item><description>streetSuffix (Conditional on if streetSuffixSpecified is set to true)</description></item>
/// <item><description>streetSuffixSpecified (Mandatory)</description></item>
/// <item>
/// <description><b>postalDeliveryGroup</b> (Optional)
/// <list type="bullet">
/// <item><description>deliveryType (Mandatory)</description></item>
/// <item><description>deliveryNumber (Optional)</description></item>
/// </list>
/// </description>
/// </item>
/// <item><description>unstructuredAddressLine (Conditional)</description></item>
/// <item><description>suburb (Mandatory)</description></item>
/// <item><description>state (Mandatory)</description></item>
/// <item><description>postcode (Mandatory)</description></item>
/// </list>
/// </description>
/// </item>
/// <item>
/// <description><b>internationalAddress</b> (Optional)
/// <list type="bullet">
/// <item><description>internationalAddressLine (Mandatory)</description></item>
/// <item><description>internationalStateProvince (Mandatory)</description></item>
/// <item><description>internationalPostcode (Mandatory)</description></item>
/// <item><description>country (Mandatory)</description></item>
/// </list>
/// </description>
/// </item>
/// </list>
/// All other fields are to be null.
/// </param>
/// <returns>
/// A response instance containing the result of the search:
/// <list type="bullet">
/// <item><description>serviceMessages</description></item>
/// <item>
/// <description><b>organisationProviderDirectoryEntries</b>
/// <list type="bullet">
/// <item><description>hpioNumber</description></item>
/// <item><description>organisationName</description></item>
/// <description><b>organisationDetails</b>
/// <list type="bullet">
/// <item><description>australianBusinessNumber</description></item>
/// <item><description>australianCompanyNumber</description></item>
/// </list>
/// </description>
/// <item><description>organisationService</description></item>
/// <item><description>address</description></item>
/// <item><description>electronicCommunicationRecord</description></item>
/// <item><description>endpointLocatorService</description></item>
/// <item><description>linkedProviders</description></item>
/// <item><description>linkedOrganisations</description></item>
/// <item><description>additionalComments</description></item>
/// <item><description>priorityNumber</description></item>
/// </list>
/// </description>
/// </item>
/// </list>
/// </returns>
public searchHIProviderDirectoryForOrganisationResponse DemographicSearch(searchHIProviderDirectoryForOrganisation request)
{
Validation.ValidateArgumentNotAllowed("request.hpioNumber", request.hpioNumber);
Validation.ValidateArgumentNotAllowed("request.linkSearchType", request.linkSearchType);
if (request.australianAddressCriteria != null)
{
Validation.ValidateArgumentNotAllowed("request.internationalAddressCriteria", request.internationalAddressCriteria);
Validation.ValidateArgumentRequired("request.australianAddressCriteria.suburb", request.australianAddressCriteria.suburb);
Validation.ValidateArgumentRequired("request.australianAddressCriteria.state", request.australianAddressCriteria.state);
Validation.ValidateArgumentRequired("request.australianAddressCriteria.postcode", request.australianAddressCriteria.postcode);
}
if (request.internationalAddressCriteria != null)
{
Validation.ValidateArgumentNotAllowed("request.australianAddressCriteria", request.australianAddressCriteria);
Validation.ValidateArgumentRequired("request.internationalAddressCriteria.internationalAddressLine", request.internationalAddressCriteria.internationalAddressLine);
Validation.ValidateArgumentRequired("request.internationalAddressCriteria.internationalStateProvince", request.internationalAddressCriteria.internationalStateProvince);
Validation.ValidateArgumentRequired("request.internationalAddressCriteria.internationalPostcode", request.internationalAddressCriteria.internationalPostcode);
Validation.ValidateArgumentRequired("request.internationalAddressCriteria.country", request.internationalAddressCriteria.country);
}
return(HISearch(request));
}
public void Sample()
{
// ------------------------------------------------------------------------------
// Set up
// ------------------------------------------------------------------------------
// Obtain the certificate by serial number
X509Certificate2 tlsCert = X509CertificateUtil.GetCertificate(
"Serial Number",
X509FindType.FindBySerialNumber,
StoreName.My,
StoreLocation.CurrentUser,
true
);
// The same certificate is used for signing the request.
// This certificate will be different to TLS cert for some operations.
X509Certificate2 signingCert = tlsCert;
// Set up client product information (PCIN)
// Values below should be provided by Medicare
ProductType product = new ProductType()
{
platform = "Your system platform (Eg. Windows XP SP3)", // Can be any value
productName = "Product Name", // Provided by Medicare
productVersion = "Product Version", // Provided by Medicare
vendor = new QualifiedId()
{
id = "Vendor Id", // Provided by Medicare
qualifier = "Vendor Qualifier" // Provided by Medicare
}
};
// Set up user identifier details
QualifiedId user = new QualifiedId()
{
id = "User Id", // User ID internal to your system
qualifier = "http://<anything>/id/<anything>/userid/1.0" // Eg: http://ns.yourcompany.com.au/id/yoursoftware/userid/1.0
};
// Set up user identifier details
QualifiedId hpio = new QualifiedId()
{
id = "HPIO", // HPIO internal to your system
qualifier = "http://<anything>/id/<anything>/hpio/1.0" // Eg: http://ns.yourcompany.com.au/id/yoursoftware/userid/1.0
};
// ------------------------------------------------------------------------------
// Client instantiation and invocation
// ------------------------------------------------------------------------------
// Instantiate the client
ProviderSearchHIProviderDirectoryForOrganisationClient client = new ProviderSearchHIProviderDirectoryForOrganisationClient(
new Uri("https://HIServiceEndpoint"),
product,
user,
hpio,
signingCert,
tlsCert);
// Set up the request
searchHIProviderDirectoryForOrganisation request = new searchHIProviderDirectoryForOrganisation();
request.hpioNumber = HIQualifiers.HPIOQualifier + "8003624166667003";
try
{
// Invokes an identifier search
searchHIProviderDirectoryForOrganisationResponse response = client.IdentifierSearch(request);
}
catch (Exception ex)
{
// If an error is encountered, client.LastSoapResponse often provides a more
// detailed description of the error.
string soapResponse = client.SoapMessages.SoapResponse;
}
}
