Field Mapping lets you do two things with a questionnaire. First, you can fill in some answers ahead of time with details Adracare already has, such as the client's name or the provider's phone number. Second, if your organization has the PDF feature, you can place each answer onto your own PDF form, so a completed questionnaire opens as a filled-in PDF.
Before you start
- You need an admin role, such as Provider-Admin or Office Staff, with Questionnaire Template Manager turned on in Settings > Access Management. Other roles can't create questionnaires or change their mapping.
- Your questionnaire must already be created in Questionnaire Manager. See How to Create a Questionnaire.
- Prefilling answers works for every organization that uses questionnaires.
- Uploading a PDF and placing answers on it is only available when Adracare has turned on the questionnaire PDF feature for your organization. Contact [email protected] to have it enabled.
What Can Be Prefilled
You can link a question to any of these details. The labels below are shown exactly as they appear in the Prefill Mapping dropdown.
- Client: Patient's first name, Patient's last name, Patient's name (first last), Patient's name (last, first), Patient's full name, Patient's date of birth, Patient's health card number, Patient's full health card number (with version code), Patient's home street address, Patient's street address with unit/apartment, Patient's city, Patient's province or state, Patient's postal or zip code, Patient's primary phone number, Patient's gender.
- Appointment provider: Appointment provider's first name, Appointment provider's last name, Appointment provider's name (first last), Appointment provider's name (last, first), Appointment provider's full name (with title), Appointment provider's salutation or title, Appointment provider's phone number, Appointment provider's college (CPSO) number, Appointment provider's college province, Provider profession (MD or NP).
- Appointment location: Appointment clinic/location full address, Appointment clinic/location street address with unit/apartment, Appointment clinic/location city, Appointment clinic/location province, Appointment clinic/location postal code, Appointment clinic/location phone number, Appointment clinic/location fax number.
- Person sending the questionnaire: First name of the person sending the questionnaire, Last name of the person sending the questionnaire, Salutation or title of the person sending the questionnaire, Phone number of the person sending the questionnaire, College (CPSO) number of the person sending the questionnaire, College province of the person sending the questionnaire.
- Other: Today's date.
How to Prefill Questions with Client and Provider Details
- In the left menu, go to Settings > Forms > Questionnaire Manager.
- Find the questionnaire and click Field Mapping in its row.
- A window opens with the questionnaire's questions on the left and a preview on the right. Use Back and Next at the bottom to move between pages.
- Click a question on the left to open it.
- In the Prefill Mapping dropdown, choose the detail that should fill this question.
- Repeat for any other questions. A small green tag appears next to each mapped question. It shows the detail's short code, for example patient_full_name.
- Click Save. To leave without saving, click Close.
Note: The Prefill Mapping dropdown is greyed out for checkbox and radio button questions. Use prefill on text questions.
When answers are prefilled
- Answers are filled in at the moment the questionnaire is created for the client. This happens when you send a new questionnaire from the client's profile, when you start a new questionnaire yourself, or when it is sent automatically because it is linked to a healthcare service.
- Questionnaires that already exist are not updated if you change the mapping later.
- Questionnaires you add to a package that's already in progress (with Add In-Progress Questionnaire in the Send Questionnaire Package window) are not prefilled.
- If Adracare doesn't have a detail, for example the client has no home address on file, that question is left blank.
- Appointment provider and location details are only filled when the questionnaire is tied to an appointment, for example when it is sent automatically for a booked appointment. When you send a questionnaire from the client's profile without an appointment, those questions stay blank.
- "The person sending the questionnaire" is the staff member who sent or started it. For questionnaires sent automatically for an appointment, it is the appointment's provider.
- When the client opens the questionnaire, the prefilled answers are already filled in. The client can change them before they submit.
How to Upload a PDF Template
This section is only available if Adracare has enabled the questionnaire PDF feature for your organization.
- Go to Settings > Forms > Questionnaire Manager.
- To start a new questionnaire, click New Questionnaire Template. To add a PDF to a questionnaire that isn't published yet, click Edit in its row.
- Under the buttons, click Select Files and choose your PDF form.
- Click Create New Questionnaire (new questionnaire) or Save Changes (existing questionnaire).
- The PDF's name appears next to File Name.
Note: Uploading a new PDF to an unpublished questionnaire replaces the old one.
Note: A questionnaire can't be edited after it is published, so you can't add or replace its PDF then. To use a new PDF, create a new version of the questionnaire. See How to Update an Existing Questionnaire Template. You can still change the Field Mapping on a published questionnaire.
How to Place Answers on the PDF
- Go to Settings > Forms > Questionnaire Manager and click Field Mapping on the questionnaire.
- On the right, click the PDF tab. Your PDF page appears. (The SurveyJS tab shows the questionnaire itself. The PDF tab can only be opened once a PDF is uploaded.)
- Click a question on the left, then click Add. A marker for that question appears in the middle of the PDF page.
- Drag the marker to the spot where the answer should be printed.
- Questions that aren't placed yet show a small orange dot in the list. To remove a marker, click the trash icon next to the question.
- Use Next to move to the next page and repeat.
- Click Save.
How each type of question is printed:
- Checkbox and radio button questions: there is one marker for each choice. Drag each one onto its matching box on the PDF. An "X" is printed on the choices the client picks.
- Signature questions: the client's signature is placed as an image at the marker.
- Long text questions: the answer wraps inside a box starting at the marker.
- Other questions: the answer is printed as one line of text starting at the marker.
Note: Each questionnaire page lines up with the same page number in the PDF. Questions on page 1 of the questionnaire go on page 1 of the PDF, and so on. Plan your questionnaire's pages to match your PDF. If the questionnaire has more pages than the PDF, answers on the extra pages aren't printed. If the PDF has more pages than the questionnaire, you can't place answers on the extra PDF pages.
Note: When you select a placed question, a text box shows its exact position settings. Most people won't need it. You can drag markers instead.
You can use Field Mapping for both prefill and PDF placement in the same visit. A question can be prefilled and placed on the PDF.
Where to Find the Filled PDF
- Open the client's profile from All Clients or My Clients.
- Go to the Questionnaires card.
- Click the questionnaire on the card, or open the card's expanded view and click View in the questionnaire's row. The filled PDF opens in a new window.
Edit Document Template Is Different
The Edit Document Template button in Questionnaire Manager is not for the PDF. It controls how a completed questionnaire looks when you import it into a session note. See Importing Questionnaire Responses to a Session Note.