C-CDA Ingestion Into Data Cloud

(0 reviews)

Setup

Prerequisites:

  1. Sign up for an EMR Account and create a client application in the EMR system.
  2. Set up Data Cloud:

    • Log in to your Salesforce Data Cloud instance.
    • Install the MuleSoft Direct for Health Data Kit
    • Go to Setup and click Data Cloud Setup.
    • Click Ingestion API, and then click New.
    • Name the Ingestion API CCDA, and click SAVE.
    • Click App Launcher and select Data Cloud.
    • Click Data Streams and click NEW.
    • Select Installed Data Kits and Packages.

    • Select the Ingestion API name from the dropdown (this is the source API name you created in the previous steps), and then select the object names and click Next.

    • On the next page, verify the details, like the data stream name and object, and then click Deploy.

      • The data streams and the associated mappings to the Data Model Objects are created.
    • To set up a connected app:

Steps:

Set up the CCDA application on MuleSoft:
  • Log in to Salesforce and navigate to the setup page.
  • Search for the ‘Integrations Setup’ page.
  • Select the C-CDA Ingestion Into Data Cloud application and click Enable.
  • Enter the application display name, target business group, and environment for deployment, and click Next.
  • Click C-CDA Ingestion Into Data Cloud to add the properties.
Key nameSample valueDescription
1Client ID for Data Cloud instance-Client ID for Data Cloud instance
2Client secret for Data Cloud instance-Client secret for Data Cloud instance
3Username for Data Cloud instance-Username for Data Cloud instance
4Password for Data Cloud instance-Password for Data Cloud instance
5Data Cloud instance Urlhttps://test-instance.salesforce.comData Cloud instance Url
6Data Cloud source API nameCCDAData Cloud source API name
  • To add an optional configuration, click the Add Additional parameters and enter the required details. For configuration details, refer to the following table:
SNoApplication property name(Key name)DescriptionSample value
1healthCloudSAPI.hostHealth Cloud APIs hostapi.healthcloud.salesforce.com
2hcOrg.tokenUrlToken URL for Salesforce Health Cloud Instancehttps://salesforce.com/services/oauth2/token
3hcOrg.client_idClient ID for Salesforce Health Cloud Instance. Select “Protect value" on the Anypoint interface in CloudHub 2.0-
4hcOrg.client_secretClient Secret for Salesforce Health Cloud Instance-
5emr.scopeScopes to access resources in EMR
Default value: system/Patient.read system/DocumentReference.read system/Binary.read
-

Note - healthCloudSAPI.host, hcOrg.tokenUrl, hcOrg.client_id and hcOrg.client_secret. These properties must be configured to sync CCDA documents from Salesforce Health Cloud into Data Cloud.

  • Select the Generic FHIR Client tab and select the Authorization protocol as appropriate.
  • Here’s an example of JWT Authorization Protocol with Cerner sandbox for a generic FHIR client application:
Key nameSample valueDescription
1Base URLhttps://fhir-ehr-code.cerner.com/r4/123abc-5678-9123Base URL of the end system.
2Token URLhttps://authorization.cerner.com/tenants/123abc-5678-9123/protocols/oauth2/profiles/smart-v1/tokenToken URL of the end system.
3Client ID-Client ID for the end system.
4Private Key-Upload the private key file
5File Password-Private Key file password
  • To add an optional configuration, click the Add Additional parameters and enter the required details. For configuration details, refer to the following table:
SNoApplication property name(Key name)Sample valueDescription
1lob.JWT.algorithmRS256Preferred algorithm for JWT Authentication. Default value: RS256.
Supported Algorithms: RS256, RS384, RS512
2lob.JWT.exp5Expiration time for JWT (In Minutes)
Default: 5
3lob.JWT.kid-Key Identifier for JWT
  • Click Proceed to deploy the application.

Post-Deployment:

Trigger the MuleSoft endpoints as described in the API Documentation.

Note: The base path for all the endpoints is: /ccda-datacloud/v1/. For example, the URL for the /$sync endpoint is https://{hostname}/{basePath}/$sync where the base path is /ccda-datacloud/v1/.


Reviews

TypeApplication
OrganizationMuleSoft
Published by
MuleSoft Organization
Published onFeb 11, 2025
Asset overview
Industries CloudHealth
Custom fields

Asset versions for 1.0.x

Asset versions
VersionActions
1.0.1
1.0.0