All Collections
Developer Integrations
Ocean
Caredove-Ocean integration: Mapping User Preferred Language Information in Referrals
Caredove-Ocean integration: Mapping User Preferred Language Information in Referrals

User language preferences must be accurately recorded and transmitted as part of the Caredove-Ocean referral process.

Juan Ospina avatar
Written by Juan Ospina
Updated over a week ago

In Caredove, we have established specific rules and procedures for mapping user-preferred language information from Ocean forms to Caredove, and downstream systems. This ensures that user language preferences are accurately recorded and transmitted as part of the referral process. This guide will help you understand the requirements and how this information is handled.

Requirements for Ocean Forms

To have user-preferred language information mapped to Caredove's downstream systems and third-party FHIR integrations, Ocean forms must adhere to the following rules:

Main Preferred Language Question

  • English Forms:

    • Form changes - Item name:

    • FHIR payload changes resulting from the Item name update described above:

      • linkId element will be named as: user_preferred_language_en

      • text element (possible value): "Main spoken language:"

      • answer element (possible available options upon answering the question):

        • "valueString": "English"

        • "valueString": "French"

        • "valueString": "Other"

  • French Forms:

    • Form changes - Item name:

    • FHIR payload changes resulting from the Item name update described above:

      • linkId element will be named as: user_preferred_language_fr

      • text element (possible value): "Principale langue parlée:"

      • answer element (possible available options upon answering the question):

        • "valueString": "Anglais"

        • "valueString": "Français"

        • "valueString": "Autre"

Follow-up Question for "Other" or "Autre" Answers

In case the user chooses "Other" or "Autre" as their preferred language in the main question, the form must contain a follow-up question with the following requirements:

  • English Forms:

    • Form changes - Item name:

    • FHIR payload changes resulting from the Item name update described above:

      • linkId element will be named as: user_preferred_language_other_en

      • text element (possible value): "Please specify:"

      • answer element (possible available options upon answering the question):

        • "valueString": "Spanish"

        • "valueString": "Klingon"

  • French Forms:

    • Form changes - Item name:

    • FHIR payload changes resulting from the Item name update described above:

      • linkId element will be named as: user_preferred_language_other_fr

      • text element (possible value): "Veuillez préciser:"

      • answer element (possible available options upon answering the question):

        • "valueString": "Espagnol"

        • "valueString": "Klingon"

Conclusion

Accurately mapping user-preferred language information is essential for effective referral submission. By following the specified rules for Ocean forms and understanding how this information is processed in Caredove's downstream systems, you can ensure that language preferences are correctly recorded and transmitted as part of the referral process. If you have any further questions or encounter specific scenarios not covered here, please reach out to our support team for assistance.


​


​

Related Articles
Caredove-Ocean integration: Understanding Referral Status and Substatus Changes
Did this answer your question?