Pular para o conteúdo principal
Base de Conhecimento da FocusVision

Survey Importer

This document describes how to import a survey file to the survey editor.

Overview

The Survey Importer allows users to upload an external survey file directly into Decipher for use in the project portal. The importer recognizes both Decipher and Confirmit XML files, as well as bConvert and Excel XLS files. Importing a Confirmit XML file will convert all supported elements and logic into Decipher’s structure, and any unsupported content will be flagged for conversion.

Confirmit XML importing requires v18 and later files. Older versions will not be converted and will prompt a system error.

1: Importing a Survey File

Survey importing requires using a clean slate, so start by building a new survey. To do this, click "+ New Project" in the portal:

Then fill in your project details in the New Project module and click "Build":

Once your project is created, you will will be able to choose between building a new survey from scratch, applying a template, or uploading an existing survey from an external file. Select "Upload File":

In the Upload File module, click "+ Choose a File" and select your survey file:

Note: Confirmit XML files will include language translations.

The upload process may take a few minutes depending on the size of your file. If the upload is successful, you will see the screen below which includes a success message, a list of recognized languages, and a count of any incompatible elements. Click "Continue" to finish the import process:

You can also click the "x" next to the file name to remove that file and select a new one, or you can click "Cancel" to abandon the upload and return to the project construction menu.

2: Reviewing an Imported Survey

When a survey file is imported to the Survey Editor, the system automatically scans the file for language variables and incompatible elements. Any unsupported content will appear in red in the element tree, and you can hover over or click on any of these elements for more details:

When selected, each element will have a warning message detailing the issue(s), and all unsupported content will appear in pink highlight:

Use the system messaging to guide you through making any necessary updates. Once you have addressed all content warnings, your new survey should be ready to go.

3: Confirmit Import Considerations

While the Survey Importer will recognize a wide range of element tags and logic, due to the use of different programming practices in Confirmit surveys, some of your survey's features may be incompatible with the Decipher system.

The following sections outline all Decipher-compatible Confirmit elements. All incompatible elements will be imported as-is and flagged for your review.

Confirmit XML importing requires v18 and later files. Older versions will not be converted and will prompt a system error.

3.1: Compatible Tags and Attributes

The table below defines how different Confirmit tags and their attributes are converted into valid Decipher tags:

Confirmit Tag

Attributes

Decipher Tag

<Info>

 

<note>

<Single>

 

<radio>

<Single>

Dropdown

<select> + <choice>

<Grid>

 

<radio> + <row> + <col>

<Grid3D>

 

Hybrid question support for:

<select>, <number>, <checkbox>

<Multi>

 

<checkbox> + <row>

<Multi>

Numeric

<number> + <row>

<Multi>

RankByClick

<select> + <choice> + <row>

<Multi>

OpenText

<text> + <row>

<Open>

Rows="1"

<text>

<Open>

Rows="1" + Numeric

<number>

<Open>

Rows > 1

<textarea>

<Folder>

 

<block>

<Loop>

 

<loop> + <looprow> + <loopvar>

<Directive>

DirectiveType="single"

Turn on automatic page breaks

<Directive>

DirectiveType="multi"

Turn off automatic page breaks

<Condition>

 

<term>

 

Note: Anything not included in the list above will be imported wrapped in a <note builder:title=”warning1” builder:warning="unsupported"> tag.

3.2 Compatible Logic Expressions

The table below defines how different Confirmit logic expressions are converted into valid Decipher expressions:

Confirmit Expression

Decipher Equivalent

f("QID") == precode

(QID.rprecode)

f("QID").inc(precode)

(QID.rprecode)

f("QID").any(precode1,precode2,precode3)

(QID.rprecode1 or QID.rprecode2 or QID.rprecode3)

f("QID").all(precode1,precode2,precode3)

(QID.rprecode1 and QID.rprecode2 and QID.rprecode3)

f("QID").none(precode1,precode2,precode3)

(!QID.rprecode1 and !QID.rprecode2 and !QID.rprecode3)

f("QID").toBoolean()

(QID.val != None)

f("QID")[precode].toBoolean()

QID.rprecode

f("QID_precode").toBoolean()

QID.rprecode

f("QID").toNumber()

QID.val

f("QID").value()

QID.val

f("QID").get() == precode

(QID.rprecode)

f("QID")[precode].toNumber()

QID.rprecode.val

f("QID").size()

QID.count

 

Note: Any logic expression not included in the list above will be imported as a <condition builder:warning="unsupported"> tag.

3.3: Compatible Piping Expressions

The table below defines how different Confirmit piping expressions are converted into valid Decipher expressions:

Confirmit Expression

Decipher Equivalent

^f("QID").get()^

[pipe: QID]

^f("QID_precode").get()^

${QID.rprecode}

^f("QID")[precode].get()^

${QID.rprecode.val}

^f("QID").get() != "1" ? "Foo":"Bar"^

${"Foo" if (not(QID.r1)) else "Bar"}

^f("QID")[precode].label()^

${QID.rprecode.text}

 

Note: Any piping expression not included in the list above will be imported as-is.

3.4: Compatible Language Mapping

The table below defines how different Confirmit language codes are converted into valid Decipher languages:

Confirmit Language Code

Decipher Language

1

Arabic

4

Chinese Simplified

5

Czech

6

Danish

7

German

8

Greek

9

English (USA)

10

Spanish

11

Finnish

12

French

13

Hebrew

14

Hungarian

16

Italian

17

Japanese

18

Korean

19

Dutch

20

Norwegian

21

Polish

22

Portuguese

24

Romanian

25

Russian

27

Slovak

29

Swedish

30

Thai

31

Turkish

33

Indonesian

34

Ukrainian

37

Estonian

38

Latvian

39

Lithunian

42

Vietnamese

54

Afrikaans

57

Hindi

62

Malay

75

Kannada

513

Tagalog

1025

Arabic (Saudi Arabia)

1028

Traditional Chinese (Taiwan)

2058

Spanish (Mexico)

2060

French (Belgium)

2067

Dutch (Belgium)

3079

German (Austria)

4105

English (Canada)

14337

Arabic (UAE)

34825

English (India)

35849

English (Singapore)

38921

English (Hong Kong)

 

4: Additional Considerations

  • Importing Decipher XML files will import survey elements only; survey tag attributes and sample sources are not imported.
  • All elements must be wrapped in <survey> tags for an import to be successful.
  • Este artigo foi útil?