Unify RESTful API for Patient Management services for own and external archives

[gunterze]

• Collapse services

  Method	Path	Name
  PUT	​/hl7apps​/{hl7App}​/hl7​/{externalHL7AppName}​/patients	Update Patient in external archive
  POST	/hl7apps​/{hl7App}​/hl7​/{externalHL7AppName}​/patients​/{priorPatientID}​/merge	Merge Patients in external archive
  POST	​/hl7apps​/{hl7App}​/hl7​/{externalHL7AppName}​/patients​/{priorPatientID}​/changeid	Change Patient ID in external archive

  to

  Method	Path	Name
  PUT	​/hl7apps​/{hl7App}​/hl7​/{externalHL7AppName}​/patients/{PatientID}	Update Patient in external archive

  where the emitted HL7 message depends

  • if the Patient ID in the path matches with the Patient ID in the dicom+json body
  • on Query Parameter merge (default: false)

  Patient ID	Query Parameter merge	Emitted HL7 message
  equals	false	ADT^A31^ADT_A05
  equals	true	400 Bad Request
  differs	false	ADT^A47^ADT_A30
  differs	true	ADT^A40^ADT_A39

• For existing create a new Patient service, use Patient ID (if available) in dicom+json body to create the new patient instead of throwing 400 - Bad Request (Patient ID in message body), else create system generated Patient ID (current behavior)

  Method	Path	Name
  POST	​/aets​/{aet}​/rs​/patients​	Create patient

• Change service

  Method	Path	Name
  PUT	​/aets​/{aet}​/rs​/patients/{PatientID}​	Update patient

  • perform create patient if the Patient ID in the path matches with Patient ID in the dicom+json body and merge=false and there is no such patient in database (current behaviour)
  • perform update patient if the Patient ID in the path matches with Patient ID in the dicom+json body and merge=false
  • perform a merge of two patients, if the Patient ID in the path differs from the Patient ID in the dicom+json body and Query Parameter merge=true
  • return 400 Bad Request, if the Patient ID in the path matches with the Patient ID in the dicom+json body and Query Parameter merge=true
  • perform change patient ID, if the Patient ID in the path differs with the Patient ID in the dicom+json body and Query Parameter merge=false

Required for #1802