Page Comparison

_{Last Update: May 9, 2022}

...

...

Getting Started with Supplemental Questions

...

If you want supplemental questions to display in both or all three CCCApply applications, you must configure and import separate XML files for each application.

When you have your XML file ready, you import your XML supplemental questions in the CCCApply Administrator and then activate and deactivate question set(s) as you wish.

...

If Page ID 9 and Page ID 10 had the exact same Effective Date, then Page ID 9 would take precedence as the set with the lowest Page ID number is used in this scenario.

...

Working with XML

Although working with computer languages can be daunting, you don't need to be an expert to create supplemental questions for your college's student application, and you don't need any sophisticated tools. A simple text editor and a rudimentary understanding of XML hierarchy will be helpful.

If you are comfortable writing computer software, you can of course use the tools that best suit you. Otherwise, create your XML files using your operating system's built-in text editor. On Windows, the text editor is called Notepad, and on OSX, it is called TextEdit.

Most of the contents of your XML file will depend on the questions you want to ask and the responses you expect to receive. For details on creating questions and guiding the student through the application process see Supplemental Questions: Layout And User Experience and Supplemental Questions: Response Elements.

Setting up Your XML File

1. Copy and paste the example starter XML file structure below into your XML editor before you begin creating questions. This text will serve as your XML base and you can use it over and over again for each new supplemental question XML file set.

...

...

After you paste your XML and click validate, the site will ask you to copy and paste a second file. In industry jargon, the file it is requesting is called a schema. You can copy the schema from here and paste it into the validator. The validator then tells you if there are problems with your XML. Although the error messages may still be somewhat intimidating, this particular validator will at least show you in a friendly way where the error is in your XML.

Supplemental Questions: Layout And User Experience

...

Both <Label> and <HoverHelp> are used only as child elements of the response elements. The <Label> element can be thought of as the question being asked for a response element, while the <HoverHelp> element can be used to provide further explanatory text when the applicant clicks the Help icon next to the related input field. Multiple <HoverHelp> children are allowed, one for each language your student application supports. The optional <Translations> element allows you to specify English or Spanish language (internationalize) for your questions. You must include at least two <Locale> elements, one with a <lang> attribute of "es" and one without, as well as a message block.

...

 <Checkbox id="8"><Label>Underpaid</Label></Checkbox>

</Section>

...

The <HoverHelp> Element

The application will use the <HoverHelp> tag that applies to the currently-selected language. Only English (lang=”en”) and Spanish (lang=”es”, for Español) are supported. The hover help appears when the applicant hovers the mouse over the checkbox.

...

...

The

...

<Translations> Element

The <Translations> element allows you to specify English or Spanish language (internationalize) for your questions. You must include at least two <Locale> elements, one with a <lang> attribute of "es" and one without, as well as a message block.

To ensure your page(s) display in Spanish correctly when the Cambiar A Espanol button is selected, even if the end-user’s browser language is set to Spanish, the college must configure the <Translations> element within their XML code and provide the translated text for each question, label, hover help, and response option.

If your college has already provided both an English and a Spanish version of supplemental questions manually in the XML, you can continue to leave your XML code as is and both language versions of the question(s) will continue to display.

...

To internationalize your custom supplemental questions:

• Add the optional <Translations> element.

• Within the <Translations> element, add at least two <Locale> elements, one without any "lang" attribute and one with a lang attribute of "es".

• Add <Message> element blocks for each code into both of the <Locale> elements.

  • Each <Message> element must have a <code> and <message> attribute with values.

  • The <code> attribute value must match the question's <Label> value.

...

...each has a corresponding <Message code="" message=""/> in the <Translations> element's <Locale> element; the first in English and the second in Spanish:="" message=""/> in the <Translations> element's <Locale> element; the first in English and the second in Spanish:

<Translations>

 <Locale>

 <Message code="main.header" message="Here are some questions"/>

...

 </Locale>

 </Translations>

Response Element: The

...

default Attribute

Depending on your specific circumstances, you can allow the applicant to ignore a given question, or you can require the applicant to provide a response. If you allow a question to be ignored, the system will store a system-default value for the question. The legal default values depend on the response element you specified. When you add a default attribute to a response element, the system auto-answers the question with the default value you specify. When the page appears, the question displays as already answered:

...

Image 2: Supplemental Questions Summary Table with Export Action Icon

...

...

Version Change Log