patient

Patient

The Patient project provides Web APIs specific to the patient. Currently only HDID to PHN translation has been written and is documented via OpenAPI.

Patient Service Configuration

Secrets Configuration

You will need to obtain a current secrets file from a team member.

On MacOs/Linux perform the following

mkdir -p ~/.microsoft/usersecrets/84e2fe9a-a1f5-4de7-bef6-4518a33fa8b9
cp [PATH TO SECRETS]/secrets.json ~/.microsoft/usersecrets/84e2fe9a-a1f5-4de7-bef6-4518a33fa8b9

On Windows, create the following folder path

%APPDATA%\Microsoft\UserSecrets\84e2fe9a-a1f5-4de7-bef6-4518a33fa8b9\secrets.json

and then copy the secrets file into that folder.

To verify the secrets file has been created properly

cd $GATEWAYHOME/Apps/Patient/src/
dotnet user-secrets list

Which should display a flattened list of secrets.

Certificate installation

You will need your IDIR to download the Client Registries Auth zip package.

Unzip to a secure location on your local machine.

Edit the project secrets file and update the ClientCertificate path to the appropriate location

{
    "PatientService": {
      "ClientRegistry":{
        "ClientCertificate": {
          "Path": "[YOUR PATH]/HGWAY_HI1.pfx",
        }
      }
    }
}

Run Patient Service

Command line

cd $GATEWAYHOME/Apps/Patient/src/
dotnet run

VS Code

• Select the Patient project
• Say Yes or Accept any popups regarding adding assets for debugging
  • Select the Patient Solution and click Enter which should create a .vscode/launch.json
• Click F5 or Run/Start Debugging

Visual Studio

• Right Click on the solution and select Properties
• Select Multiple startup projects
• Set Patient action to Start
• Click Ok
• Click F5 or Debug/Start Debugging

Visual Studio for Mac

• Right Click on the solution and select set startup project
• Ensure that the Patient solution item is checked
• Click Ok
• Select Run Menu then Start Debugging

Patient Service Verification

• Ensure WebClient is running
• Open a Chrome session to http://localhost:5000
• Open Developer tools.
• Logon to WebClient
• In the console make note of the HDID or you can likely use: P6FFO433A5WPMVTGM7T4ZVWBKCSVNAYGTWTU3J2LWMGUMERKI72A
• Go to the network tab and refresh the page.
• You will want to look for a failed call to Medication or Immunization go to the Headers tab and copy the text after Authorization: Bearer

You should be able to open a new Browser window and connect to http://localhost:3002/swagger

• Click on the Authorize button and paste in the bearer token, then click Authorize and Close.
• Click on the Patient Get API to expand it.
• Click on Try it out button.
• Paste the HDID into the text input.
• Click on Execute

You should see a response of 200 and a body similar to:

{
  "hdid": "P6FFO433A5WPMVTGM7T4ZVWBKCSVNAYGTWTU3J2LWMGUMERKI72A",
  "personalhealthnumber": "9735353315",
  "firstname": "BONNET",
  "lastname": "PROTERVITY",
  "birthdate": "1967-06-02T00:00:00",
  "email": ""
}

If you encounter an error similar to socket reset, then you need to contact the PO to have CGI add your IP to the authorized whitelist.