How To Topic

Converting a Multiple Choice Variable

When your template contains a Multiple Choice variable (which are being deprecated in HotDocs Author) you can use the convert tool to convert them into (based on the characteristics of the Multiple Choice variable) either a Single Select variable, Multi Select variable, or a Text variable with answer suggestions.

Before converting Multiple Choice variables, consider whether or not the variable is referenced in other templates that you have not yet imported into Author. If so, you should import the other templates first, so that your conversion can be applied to every instance of the Multiple Choice variable.

To convert a Multiple Choice variable to a Single Select or Multi Select Variable

  1. Open Component Studio.
  2. In the components list, select the Multiple Choice variable you want to convert.
  3. In the component toolbar, click the Convert button.
  4. Author will analyze the Multiple Choice variable, convert it to a Single Select or Multi Select variable, and open the new variable for editing.
  5. When you finish editing the new variable, click Save.

 

Conversion Rules

The Multiple Choice variable will be analyzed and converting using the following rules:

  • If the Multiple Choice variable's configuration is set to Select one item, it will be converted to a Single Select variable
  • If the Multiple Choice variable's configuration is set to Select one item and has the Include "Other" property set, it will be converted to a Text variable with answer suggestions
  • If the Multiple Choice variable's configuration is set to Select multiple items, it will be converted to a Multi Select variable
  • The Option column of the Multiple Choice variable will become the Key column (as required by Single Select and Multi Select variables) and will be set as Option labels property
  • If the Multiple Choice variable has any values in the Prompt, Default Merge Text (Default Alternate Text), or Resources (Additional information) columns, a corresponding column is added to the variable upon conversion