34
AnswerPath Version 5 User Guide Copyright © 2014 Hindin Solutions Ltd. User Guide

User Guide - AnswerPath · like a script they are following. In this user guide we will use Scripts and Wizards interchangeably. Answer Path allows you to save the Wizards as HTML

  • Upload
    others

  • View
    0

  • Download
    0

Embed Size (px)

Citation preview

  • AnswerPath Version 5 User Guide Copyright © 2014 Hindin Solutions Ltd.

    User Guide

  • AnswerPath Version 5 User Guide Copyright © 2014 Hindin Solutions Ltd.

    Disclaimer Copyright © 2014 by Hindin Solutions Ltd.

    All rights reserved. This manual may not be copied, photocopied, reproduced, translated, or converted to

    any electronic or machine-readable form in whole or part without prior written approval of Hindin Solutions

    Ltd. For more information contact Hindin Solutions Ltd. at: [email protected].

    First Edition February 2010.

    Printed in New Zealand.

    Disclaimer

    Every effort has been made to make this guide as complete and as accurate as possible, but no warranty or

    fitness is implied. The information provided is on an “as is” basis. The author and the publisher shall have

    neither liability nor responsibility to any person or entity with respect to loss or damages arising from the

    information contained in this guide.

    Hindin Solutions Ltd.

    P.O. Box 1181, Christchurch

    New Zealand

    Tel: +64 3 365 3200

    www.hindin.co.nz

    mailto:[email protected]://www.hindin.co.nz/

  • AnswerPath Version 5 User Guide Page 1 Copyright © 2014 Hindin Solutions Ltd.

    Section Contents 1 Introduction ................................................................................................................................... 1

    Overview....................................................................................................................................... 1 1.1

    Links .............................................................................................................................................. 1 1.2

    Introduction .................................................................................................................. 1 1.2.1

    Ordering of Conditions .................................................................................................. 3 1.2.2

    Answer Path ................................................................................................................................... 5 2

    Introduction .................................................................................................................................. 5 2.1

    Answer Path Concepts.................................................................................................................. 5 2.2

    Inputs ............................................................................................................................ 5 2.2.1

    Answer Groups .............................................................................................................. 5 2.2.2

    Answer Path Interface .................................................................................................................. 6 2.3

    Toolbox Window ........................................................................................................... 6 2.3.1

    Design Area ................................................................................................................... 8 2.3.2

    Properties Window ....................................................................................................... 9 2.3.3

    Conditions Window ....................................................................................................... 9 2.3.4

    Using Answer Path ....................................................................................................................... 10 3

    Opening Answer Path ................................................................................................................. 10 3.1

    Creating or Opening a Document ............................................................................................... 10 3.2

    Opening an Existing Document ................................................................................... 10 3.2.1

    Opening a Document created by Mapit Designer ...................................................... 10 3.2.2

    Creating a New Document .......................................................................................... 10 3.2.3

    Editing Document Properties ...................................................................................... 10 3.2.4

    Creating Pages ............................................................................................................................ 11 3.3

    Breadcrumbs ............................................................................................................... 11 3.3.1

    Creating Questions ..................................................................................................................... 12 3.4

    Adding Inputs to Questions ........................................................................................................ 12 3.5

    Adding Answer Groups ............................................................................................... 12 3.5.1

    Adding Inputs .............................................................................................................. 13 3.5.2

    HTML Editor ................................................................................................................................ 14 3.6

    Embedding Hyperlinks ................................................................................................ 15 3.6.1

    Embedding Images ...................................................................................................... 15 3.6.2

    Creating Conditions .................................................................................................................... 16 3.7

    Using the Link Tool ...................................................................................................... 16 3.7.1

    Using the Conditions List............................................................................................. 18 3.7.2

    Using the Conditions Window .................................................................................... 20 3.7.3

    Editing Conditions ...................................................................................................................... 20 3.8

    Viewing Existing Conditions ........................................................................................ 20 3.8.1

    Ordering of Conditions ................................................................................................ 21 3.8.2

    Deleting Conditions ..................................................................................................... 22 3.8.3

    Deleting Links .............................................................................................................. 22 3.8.4

    Linking to Other Websites .......................................................................................................... 23 3.9

    Linking to external websites ....................................................................................... 23 3.9.1

  • AnswerPath Version 5 User Guide Page 2 Copyright © 2014 Hindin Solutions Ltd.

    Re-Direct to a URL when Clicking on the “Next” Button ............................................ 23 3.9.2

    Handling Answer Path Script Data in an External System .......................................... 23 3.9.3

    Changing the Page Appearance and Behaviour ......................................................................... 24 3.10

    Headers and Footers ................................................................................................... 24 3.10.1

    Icons ............................................................................................................................ 24 3.10.2

    Stylesheets and JavaScript .......................................................................................... 24 3.10.3

    Previewing the Document .......................................................................................................... 25 3.11

    Editing the Document ................................................................................................................. 26 3.12

    Deleting objects .......................................................................................................... 26 3.12.1

    Cut, Copy and Paste .................................................................................................... 26 3.12.2

    Setting Document Properties ..................................................................................................... 26 3.13

    Saving Documents ...................................................................................................................... 26 3.14

    Saving a Document ..................................................................................................... 26 3.14.1

    Save As ........................................................................................................................ 27 3.14.2

    Setting the Initial Page ............................................................................................................... 27 3.15

    From Within Answer Path ........................................................................................... 27 3.15.1

    From an External Website ........................................................................................... 27 3.15.2

    Showing and Hiding Windows .................................................................................................... 27 3.16

    Checking for Errors ..................................................................................................................... 28 3.17

    Saving an Answer Path Document for use on your Website ..................................................... 28 3.18

    Exporting an Answer Path Document as HTML .......................................................... 28 3.18.1

    Setting Export Options ................................................................................................ 29 3.18.2

  • AnswerPath Version 5 User Guide Page 1 Copyright © 2014 Hindin Solutions Ltd.

    1 Introduction

    Answer Path from Hindin Solutions provides you with the ability to design complex scripts, wizards, decision

    trees, and more from a simple to use Drag-and-Drop application. Answer Path is one of many knowledge

    tools provided by Hindin Solutions.

    What you create with Answer Path is an Answer Path Wizard. In Answer Path you see this as a series of

    boxes connected by arrows to indicate navigation. What the person using the Answer Path Wizard sees is a

    series of web pages with questions that they answer, leading them to an end point (such as the answer to a

    question, or the correct product or solution to use for a specific circumstance, for example). Calling the

    output from Answer Path a "Wizard" reflects the way Answer Path guides the end-user to a final conclusion,

    like a script they are following. In this user guide we will use Scripts and Wizards interchangeably.

    Answer Path allows you to save the Wizards as HTML. These Wizards can then be exported to your website

    or intranet for use through a standard web browser.

    Overview 1.1

    Answer Path Scripts can be used to lead a user to information such as an answer to a Frequently Asked

    Question (FAQ) using a series of determining questions. The Scripts can encapsulate a business process or

    expert knowledge; by asking a series of specialised questions the Scripts can suggest a course of action based

    on answers given.

    Consider the case of an FAQ as a discovery mechanism for a piece of information. Standard FAQs have a

    single question and a single answer – whether this is a simple textual answer, or a hyperlink to a URL or

    document resource containing the answer. Answer Path Wizards encapsulate sets of questions which can

    lead to many “answers” or outcomes based on the responses given to the questions posed. The navigation

    from page to page, or question set to question set, depends on answers supplied to previous questions. This

    complex navigation and homing in on the relevant end point (in this example information) is encapsulated

    and handled for the user automatically in the Answer Path Wizard.

    Questions in the Answer Path system are divided into blocks called Pages. Each Page can contain one or

    more Questions, or may present an outcome. A set of Answers is associated with each Question that may be

    a group of Radio Buttons, a list of Checkboxes, one or more Drop-down Lists or a field where some free text

    may be entered. The answers given to questions in any one Page determines which Page will be presented

    next. The logic which determines the next Page to present is discussed in section 1.2.

    During the process of answering questions and moving between Pages, the answers to each question are

    recorded. At the end of the Script, a Page may be displayed to communicate some advice based on the path

    taken and a history of answers given may be displayed.

    Links 1.2

    Introduction 1.2.1

    Perhaps the most important aspect of Scripts is Links. These conditions represent the logic that determines

    which Page to present next. As outlined in section 1.1, Pages contain questions and every Page requires at

    least one Link to specify what to do once the question is answered.

  • AnswerPath Version 5 User Guide Page 2 Copyright © 2014 Hindin Solutions Ltd.

    Links contain two elements:

    A Condition

    A Page to jump to if that condition is met

    The path a user will take when navigating the Script is determined by the Conditions that were met by the

    answers given to Questions in each Page. Any number of Conditions may be specified per Page, each taking

    the user on a different, subsequent question path – when a particular Condition is satisfied (said to be true),

    the Page associated with the Condition is displayed.

    Any given Condition contains one or more Answers to check. Checks simply verify whether the user entered

    an answer – for instance, whether a Radio Button was selected, a Checkbox was ticked, a Drop-down List

    item was selected or some text was typed in a Textbox. By checking specific answers, important information

    can be identified, the next relevant Page displayed, and a new Question asked.

    There are no limits to the number of Links that may be specified per Page or the number of answers to be

    checked for any one condition. For instance, a Condition may check to see whether one Checkbox was ticked

    or may check to see if a specific combination of Checkboxes were ticked.

    Each Page may also include a special Link known as the Else Condition. If no other Conditions are found to be

    true (i.e. the user has not supplied answers which correspond to any of the Conditions), the Else Condition is

    executed as a default and the Page associated with this Condition is displayed.

    In the absence of the Else Condition, at least one of the Conditions must evaluate to true for the answers in

    the Page to be accepted. Omitting this condition is useful when using Pages where an answer to a question

    must be specified or a valid combination of answers to several questions given within the Page.

    A conceptual example of Links is illustrated below with a question which could be asked to applicants by a

    recruiting agency. Based on the answer to this question, one of three possible screens (Pages) will be

    displayed, each containing a different text response. Each of the potential answers are numbered (in blue)

    for reference.

    What applications do you

    have experience with?

    Microsoft Word [1]

    Microsoft Excel [2]

    Adobe InDesign [3]

    Adobe Photoshop [4]

    Page 1

    You have experience in both

    Microsoft applications.

    Page 2

    Experience with at least

    Microsoft Word is required.

    Page 4

    {1 and 2}

    {else}

    You must be willing to also

    learn Microsoft Excel to

    proceed to the next stage.

    Page 3

    {1}

    A

    B

    C

  • AnswerPath Version 5 User Guide Page 3 Copyright © 2014 Hindin Solutions Ltd.

    Page 1 contains the question - What applications do you have experience with? Four possible answers are

    given. In this example, the answers are Checkboxes, and the user is expected to tick as many as appropriate

    (which may be none at all).

    This Page contains three Links, or ‘pathways’ (indicated with arrows):

    Page 2 is to be displayed if the applicant has experience with both Word and Excel –this constitutes one pathway.

    Page 3 is to be displayed if the applicant has experience with Word and not Excel – a second pathway.

    Page 4 is to be displayed if the applicant has experience with neither – a third pathway.

    It is important to note that although options 3 and 4 (the Adobe products) are not involved in any Links, it

    may be the case that the agency wants this information recorded, even though it has no bearing on the path

    taken in the Script

    Every pathway must have a condition associated with it. In the example above these are represented in red.

    For instance, if options 1 and 2 are ticked, path A will be followed. The order of conditions in the Answer

    Path Script is important as this is the order in which they will be evaluated. For any Page, the first Link which

    is true will be immediately followed. In this example, it may be assumed that the Links are evaluated in the

    order A, B, C.

    Link A leads to Page 2 and specifies that Checkboxes 1 and 2 must be true (ticked) for this path to be

    followed. If only one (or neither) is ticked the Link is, overall, said to be false (as not all of its components are

    true) and the path will not be followed. For example, if only option 3 (Adobe InDesign) were ticked, Link A

    would be false and the script would proceed to evaluate Link B.

    Link B leads to Page 3 and specifies that Checkbox 1 must be true for this path to be followed. Again, if only

    option 3 were ticked this Condition would also be false and the script would proceed to evaluate the next

    Condition (Condition C).

    Link C is the Else Condition. This Condition is true when all other Conditions are false. Effectively, this

    Condition is a default and, if ever reached, is always followed. If option 3 were ticked, this Condition would

    become true and Page 4 would be displayed.

    As illustrated above, Links may involve checking multiple answers for a combination which represents

    something significant. Links may also check answers from multiple questions within a Page, or questions

    from preceding Pages.

    Ordering of Conditions 1.2.2

    The ordering of Links is important. To illustrate this, consider the example below which shows a more

    complex version of the simple system we saw above.

  • AnswerPath Version 5 User Guide Page 4 Copyright © 2014 Hindin Solutions Ltd.

    Page 1 has four Links which must be evaluated in a specific order (A, B, C, D) for the desired behaviour to

    occur. It is important to note that Conditions check only for options which are ticked – they do not check for

    items which were not ticked. Condition C, for example, checks the value of the Word Checkbox. Irrespective

    of any other options which are (or are not) ticked, if the Word option is checked, then Condition C will

    evaluate to true.

    As an example, assume that a user ticks the Word, Excel, Access and PowerPoint options. If the Conditions

    are evaluated in the order A, B, C, D, then Condition A will immediately evaluate to true (all 4 required

    options have been selected) and Page 2 will display. No further Conditions will be evaluated and the Script

    will continue from Page 2. This is the expected outcome for this combination of options. However, if the

    Conditions were evaluated in a different order such as C, A, B, D, then Condition C would evaluate to true

    first (since it checks only whether the Word option was ticked) and will lead to the display of Page 4, claiming

    the user has experience in only Microsoft Word. Despite the fact that Condition A was a better ‘match’ for

    the selected options, the evaluation ends with the first Condition which was true (Condition C in this case). A

    similar result would occur if Condition B were evaluated first in this scenario. Since the Word and Excel

    options are both ticked, the Condition is logically true and Page 3 would be displayed instead of the expected

    Page 2.

    This example demonstrates the importance of the ordering of Conditions when designing an Answer Path

    Wizard. Typically, the more options available to be selected, the more complex the logic in determining

    which Page to show next and the ordering of Conditions becomes even more important.

    As a general guide, the most complex Conditions should be placed first (that is, the Conditions which involve

    the highest number of inputs, such as Condition A in the example). The remaining Conditions should be

    placed in descending order with the Else Condition (which involves no inputs) being placed last. Section 1.1

    explains how to set the order of Conditions.

    You have experience in all the major

    Business Applications.

    Page 2

    Experience with at least

    Microsoft Word is required.

    Page 5

    {Word and Excel and Access and

    PowerPoint}

    {else}

    You have experience in the Word

    Processor and Spreadsheet

    Page 3

    {Word

    and Excel}

    A

    B

    D

    Page 1

    What Microsoft Applications are you familiar

    with?

    Microsoft Word [Word]

    Microsoft Excel [Excel]

    Microsoft PowerPoint [PowerPoint]

    Microsoft Publisher [Publisher]

    Microsoft Access [Access]

    Page 4

    {Word}

    C You have experience in only Microsoft Word

  • AnswerPath Version 5 User Guide Page 5 Copyright © 2014 Hindin Solutions Ltd.

    Answer Path 2

    Introduction 2.1

    Answer Path is a graphical design tool that allows Answer Path Wizard authors to create, edit and preview

    documents.

    Answer Path Concepts 2.2

    The concepts presented in section 1.1 described the elements of Answer Path Scripts in terms of Pages,

    Questions, Answers, and Links. Answer Path graphically represents all of these concepts in addition to two

    Answer Path-specific concepts – Inputs and Answer Groups.

    Inputs 2.2.1

    Inputs are the Answer Path representation of the Options or Answers available to a user of the Script when

    answering a Question. They form the basis of Links and are the method used to record answers to individual

    Questions within a Page. Four types of Inputs are available in Answer Path – Checkbox inputs, Radio Button

    inputs, Drop-down List inputs and Textboxes.

    Checkboxes present a list of options, several of which may be selected as a response to a question. This type

    of input is useful in situations where users should ‘tick off’ all options which apply.

    Radio Button inputs allow the presentation of a number of options, of which only one may be selected. This

    type of input is useful in situations such as Questions with Yes/No answers, or Questions with responses of

    which only one is ever relevant.

    Drop-down Lists are similar to Radio Buttons and allow the presentation of a number of options, of which

    only one may be selected. Drop-down Lists are particularly useful to present large numbers of options that

    would be unable to fit on a single page e.g. all of the countries of the world.

    Textboxes allow the free entry of text as a response to a Question. These are typically reserved for questions

    such as entering someone’s name, a date or time, or any information which cannot be conveniently

    represented using Radio Buttons, Checkboxes or Drop-down Lists.

    Answer Groups 2.2.2

    The concept of Answer Groups is introduced by Answer Path to separate sets of inputs into logical groups.

    For instance, consider the example below. Two sets of Radio Buttons are associated with the Question. Only

    one option from each set (or group) may be selected, effectively allowing two pieces of information to be

    collected from the question. In order to allow Answer Path to establish which inputs belong to which set,

    Answer Groups are used. In this example, two Answer Groups would be used, each having a set of five

    inputs. In the absence of groups, Answer Path would interpret all ten inputs as belonging to one large group,

    and thus allowing only one option to be selected from all ten available.

  • AnswerPath Version 5 User Guide Page 6 Copyright © 2014 Hindin Solutions Ltd.

    Answer Path Interface 2.3

    The main Answer Path interface is divided into a number of major parts, as illustrated below. Each of the

    major parts will be covered in this section.

    Toolbox Window 2.3.1

    The Toolbox resides on the left of the window and contains a set of tools used in the design and construction

    of Answer Path wizards. The toolbox contains thirteen tools.

    Which are your first and second preferred modes

    of transport?

    Private car

    Bus

    Taxi

    Bike

    Walk

    Private car

    Bus

    Taxi

    Bike

    Walk

    Page 1

  • AnswerPath Version 5 User Guide Page 7 Copyright © 2014 Hindin Solutions Ltd.

    Clicking on a tool will select it for use. Once you have created an object with a tool the object is selected and

    the Select Tool is highlighted.

    If you create an object with the Ctrl key held down, the current tool remains selected allowing you to quickly

    create multiple objects of the same type e.g. a number of Radio Buttons in an Answer Group.

    Please note that if you click too quickly when using the Ctrl key this may be interpreted as double clicking on

    an object and the editing window of the parent object will be opened instead.

    Select Tool 2.3.1.1This tool is used to select components on the canvas for editing, such as

    Pages, Questions, and Inputs. Once selected, a selection frame appears

    around the item as a ‘dotted border’ (the image on the right shows a Page

    which has been selected).

    Items which are resizable (such as Pages) have eight drag handles that appear

    when selected and can be clicked and dragged to resize the item.

    Link Tool 2.3.1.2The Link tool allows the creation of logic which joins Pages. Selecting this tool and dragging out an

    arrow between two Page objects on the canvas will create a Link which joins the two.

    Page Tool 2.3.1.3The Page Tool is used to create Page items in Answer Path Scripts. When this tool is selected, the

    cursor turns to a cross (+) when the mouse enters the canvas. A new Page may be created by

    clicking in an empty area of the canvas and dragging out a rectangle. Releasing the mouse will

    create a new Page with a size equal to the dragged rectangle.

    Pages may only be created on the canvas – it is not possible to create a new Page within an existing Page.

    Once completed, the toolbox will automatically revert back to the Select Tool.

    Page + Question Tool 2.3.1.4The Page + Question Tool is an extension of the Page Tool in the previous section. This tool will

    create a page on the canvas then automatically create an Answer Group and Question. After the

    items have been created the Question Properties window is opened for editing.

    Question Tool 2.3.1.5This tool is used to create new Questions within existing Pages. To create a new Question, select

    this tool and left click once within the Page where it is to be placed. Dragging is not necessary with

    this tool as Answer Path will automatically calculate the required size for the Question at all times.

    Once created, Answer Path will also add a default Answer Group to the new Question and revert to the

    Select Tool.

    Answer Group Tool 2.3.1.6Inputs for any given Question must be placed within a logical group. The Answer Group Tool allows

    the creation of such groups. Selecting this tool and clicking once within an existing Question item

    will create a new group – dragging a rectangle to create the group is unnecessary.

    The tool will create a new group, automatically assign it a default name (such as Answer Group1), select it,

    and revert to the Select Tool. The next step would typically be to add some Inputs to the new group.

  • AnswerPath Version 5 User Guide Page 8 Copyright © 2014 Hindin Solutions Ltd.

    Input Tools 2.3.1.7

    As outlined in section 2.2.1, Answer Path provides four types of Inputs – Radio Buttons, Checkbox, Drop-

    down Lists and Textboxes. Each of these input types has a toolbox icon. Inputs may only be added to an

    existing Answer Group (which may be created using the Answer Group Tool described in section 2.3.1.6).

    Inputs can only be placed in groups that are either empty, or contain inputs of the same type as the one

    being created. For instance, a Checkbox may not be added to a group containing Radio Buttons – a new

    Answer Group would be required for this – but it may be added to a group which is empty or already

    contains other Checkboxes.

    Clicking once within an existing Answer Group will create an input of the selected type (Radio Button,

    Checkbox, Drop-down List or Textbox); the new item will be selected and Answer Path will revert to the

    Select Tool.

    Yes / No Tool 2.3.1.8The Yes / No Tool is a short cut for creating the most common type of Radio Button answer - Yes /

    No.

    Clicking once within an existing Answer Group will create a Radio Button containing the word ‘Yes’ and a

    Radio Button containing the word ‘No’.

    Text Tool 2.3.1.9The Text tool is used to place information (such as Help) or text prompts for the users of Scripts. A

    new Text item may be created by clicking in an empty area of the Page. The new Text item will be

    sized to fit the Page and automatically selected for further editing.

    Hyperlink Tool 2.3.1.10This tool is used to add a hyperlink to external websites or web pages on the intranet. Similar to the

    Text Tool (see section 2.3.1.9), clicking within an existing Page will create a new Hyperlink item and

    automatically select it for further editing.

    Design Area 2.3.2

    The design area is in the centre of the window and displays two tabs. The first tab contains the Canvas where

    tools may be used to manipulate objects on the canvas and the second tab contains the Preview.

    Canvas 2.3.2.1The Canvas is a scrollable area, which will dynamically resize itself to fit all items which reside on it. When

    the canvas is visible, Toolbox items may be selected and applied to the canvas.

    Preview 2.3.2.2The Preview shows an immediate vision of how the Answer Path Script will look and behave when viewed

    and executed by users. The Preview presents the document verbatim as it has been designed – including

    Pages which contain no items or Questions which have no Inputs.

    Selecting the Preview tab will automatically cause the document to be compiled into HTML and displayed.

  • AnswerPath Version 5 User Guide Page 9 Copyright © 2014 Hindin Solutions Ltd.

    Properties Window 2.3.3

    The Properties window resides on the right hand side of the window and

    displays attributes specific to the item currently selected on the canvas.

    The properties are displayed in a grid and each may be directly edited. For

    instance, if the currently selected item is a Hyperlink object, the properties

    displayed includes the Content, Notes, PostState, Target and URL.

    Help information on the currently highlighted property is displayed at the

    bottom of the Properties window.

    Any properties changed in the window, will immediately cause the selected object on the canvas to update

    once the Enter key is pressed or if the mouse is clicked away.

    Conditions Window 2.3.4

    The Conditions window displays a list of Conditions associated with the

    selected Page or Link. If a Page object is selected on the canvas, the

    window displays all Conditions associated with that Page. If a Link

    between two Pages (named A and B, for instance) is selected; only the

    Conditions from Page A which lead to Page B are displayed.

    The top of the Conditions window indicates the context of the list

    (whether the Conditions of one Page are displayed or the Conditions

    between two Pages). Below the list is a description of the selected

    Condition. At the bottom of the window, three buttons are displayed

    (Add, Edit, and Delete) which allow rapid editing of the selected Condition

    or the addition of a new Condition. Double clicking on a Condition will

    open the Condition in the Condition Editor.

  • AnswerPath Version 5 User Guide Page 10 Copyright © 2014 Hindin Solutions Ltd.

    Using Answer Path 3

    This section will cover all available facilities in Answer Path. The section is organised by task.

    Opening Answer Path 3.1

    To open Answer Path click on the icon in your Start menu or on your desktop. Alternatively find a recent

    Answer Path file (they all end in .ap) and double click on the file name.

    Creating or Opening a Document 3.2

    Answer Path only allows one document to be open at a time. When opening a document the currently

    opened document (if any) will be automatically closed. If this document has been changed since it was last

    saved you will be prompted to save or discard the changes before the document is closed.

    Opening an Existing Document 3.2.1

    When you install Answer Path a new directory called My AnswerPath Scripts is created in My Documents.

    The two scripts that accompany the installation version are present in this directory. You can save your

    scripts there also. Select the Answer Path Document from the directory navigator and double click. The

    document will open in the design area for editing.

    If Answer Path is already in operation, open a document which resides on the local machine by pressing

    Ctrl+O, or select Open from the File menu.

    Opening a Document created by Mapit Designer 3.2.2

    Documents created by Mapit Designer (these end in .mapit) can be opened in Answer Path. These

    documents are listed as Answer Path Document files in the Open Document dialog (select Open from the File

    menu), and can be selected from here.

    Alternatively they can be double clicked from your directory navigator in the same manner as with opening

    Answer Path Documents.

    Creating a New Document 3.2.3

    To create a new document, press Ctrl+N, or select New from the File menu. The New Document dialog will

    appear providing an opportunity to enter a title, brief description of the new Answer Path Document and

    whether you would like to truncate long text descriptions in the Summary page. Clicking OK will create the

    document and present an empty design area.

    Note that documents may not be Created or Opened while Answer Path is previewing a document (you can

    tell because the Preview tab is highlighted at the top of the Page). Answer Path must be in Design mode (by

    clicking the Design tab) before these facilities become available again.

    Editing Document Properties 3.2.4

    To edit the information that was provided when the document was created select Properties from the

    Document menu.

  • AnswerPath Version 5 User Guide Page 11 Copyright © 2014 Hindin Solutions Ltd.

    Creating Pages 3.3

    To create a Page object, select the Page tool (see section 2.3.1.3) from the Toolbox and drag out a rectangle

    on the canvas in the design area, as illustrated below.

    Pages have the following properties:

    After creation, Answer Path assigns a default name such as Page 1. It can be useful to give Pages useful

    names such as “Participant Name” or “Participant Location” which give an indication of the nature of the

    questions contained within the Page. User-defined names can help when reading and interpreting

    Conditions.

    To give a Page a custom name, ensure the Properties window is visible and edit the Name property. Page

    names must contain at least one character. If the name of the Page is too long to fit the size of the Page

    object on the canvas, it will be abbreviated with an ellipsis (…). Alternatively, double click on the Page name

    and change the name in the Page Properties window.

    The size of Page objects is automatically adjusted to accommodate the items within it (Question and Text

    objects). However, sometimes it may be necessary to resize the width of the Page to better fit questions

    with extended text. To resize a Page, use the Select Tool to select the Page object and use the drag handles

    (small squares that appear on the selection frame) to adjust the width to the desired length.

    The Page + Question tool can be used to create a page that also contains a Question and Answer Group. The

    Question is automatically opened for editing in the Question Properties window.

    Breadcrumbs 3.3.1

    Answer Path Scripts also have a feature known as Breadcrumbs where the pathway you have followed can

    be shown on the left hand side of the script. The Breadcrumbs names are taken from the Page Name. When

    designing a new script it is suggested that each page is given a unique and descriptive name so that the

    Breadcrumbs are easy to follow.

    Property Value Description

    ID Text The unique ID assigned to the page. This value is read only and cannot be changed.

    Name Text The name of the page - used in the breadcrumbs and the page label on the canvas.

    RedirectUrl URL A URL to redirect to when clicking on the “Next” Button. See section 1.1 for further information.

  • AnswerPath Version 5 User Guide Page 12 Copyright © 2014 Hindin Solutions Ltd.

    Breadcrumbs may be turned on or off. To alter this setting select Breadcrumbs… from the Document menu.

    The percentage width of their display can also be set in this dialog also. You may choose any value between

    10 and 50 per cent; any values specified outside of this range will be rounded back.

    Creating Questions 3.4

    The Question Tool (see section 2.3.1.5) is used to add Question objects to existing Pages. To add a new

    Question to a Page, select the Question Tool and click inside the destination Page object. The image below

    illustrates how a Page object appears once a new Question has been added.

    Questions have the following properties:

    Questions are assigned a default name after creation. It can be useful to provide a custom name for

    Questions as the name of the Question is displayed in Condition descriptions. Question names can also be

    changed by double clicking on the Question name and changing the name in the editing screen. Notes text

    can optionally be specified to clarify questions, and is displayed only when the Script is viewed as HTML or

    previewed in Answer Path.

    Adding Inputs to Questions 3.5

    Adding Answer Groups 3.5.1

    Before Inputs can be added to a question, an Answer Group must first be created. As discussed in section

    2.2.2, Answer Groups are a container for a group of inputs. As a helpful measure, Answer Path automatically

    creates an Answer Group when a new Question is created.

    Property Value Description

    Name Text The name of the question - used in the Condition descriptions.

    Content Text The question text.

    Notes HTML HTML text that is displayed with the Question when it is viewed by the end user. It can contain formatted text, graphics, tables and hyperlinks.

  • AnswerPath Version 5 User Guide Page 13 Copyright © 2014 Hindin Solutions Ltd.

    Answer Groups may only contain Inputs of one type. If a Question requires inputs of several types (a set of

    Radio Buttons mixed with a Textbox, for example) it is necessary to add a new Answer Group. The Answer

    Group Tool can be used to add a new Answer Group to a question.

    Selecting the Answer Group Tool from the toolbox and clicking once within the destination Question object

    will add a new Answer Group. The image below illustrates how a Question appears once a new (empty)

    Answer Group is added.

    Answer Path indicates potential problems by colouring the Answer Group in red. In the image above, Answer

    Path is warning the author that the group contains no Inputs. Once Inputs are added, the Group will return

    to its natural blue colour. Answer Path will also colour Answer Groups red if they contain only one Radio

    Button. By definition, Radio Buttons must appear in sets of two or more. Answer Path will automatically

    create two Radio Buttons if the Answer Group is empty.

    Answer Groups have the following properties:

    Answer Group properties can be changed by double clicking on the Answer Group Name and editing them in

    the Answer Group Properties window.

    Adding Inputs 3.5.2

    The five Input tools (Radio Button, Checkbox, Yes/No, Drop-down List and Textbox) can be used to add

    Inputs to existing Answer Groups. Selecting the appropriate Input tool and clicking once within the

    destination group will create a new Input and select it. A warning will appear if an attempt is made to add an

    Input to a group which already contains Input objects of a different type.

    Radio Buttons have the following properties:

    Property Value Description

    Name Text The name of the question - used in the Condition descriptions.

    Field Text This property has been deprecated and will be removed in a future version.

    Property Value Description

    Content HTML HTML text that is displayed to the right of the Radio icon. It can contain formatted text, graphics, tables and hyperlinks.

    GoNextOnClick True / False If True then selecting this Radio Button will automatically take the user to the next page without the requirement to click the “Next” button.

  • AnswerPath Version 5 User Guide Page 14 Copyright © 2014 Hindin Solutions Ltd.

    Checkboxes have the following properties:

    Drop-down Lists have the following properties:

    TextBoxes have the following properties:

    Clicking on an input object will select it. Double clicking on it will display the Content property for editing.

    The order that an input object appears in an Answer Group can be changed by right clicking on the input and

    selecting “Move Up” or “Move Down” from the Order submenu.

    HTML Editor 3.6

    Answer Path automatically uses the HTML/WYSIWYG editor for adding or changing text, headers, footers

    and Notes screens. This allows the addition of images and hyperlinks to these fields as well as a large variety

    of text styles.

    Property Value Description

    Content HTML HTML text that is displayed to the right of the Checkbox icon. It can contain formatted text, graphics, tables and hyperlinks.

    Property Value Description

    Content HTML HTML text that is displayed to the left of the Drop-down value. It can contain formatted text, graphics, tables and hyperlinks.

    ListValues Text List A list of pipe (|) separated values to populate the Drop-down list with e.g. Item 1|Item 2|Item 3

    DefaultValue Text The default selected value that will appear in the Drop-down List when the page is first displayed. This value is case sensitive and should be an exact match for an item in the list. If the default value cannot be found in the list then the blank value is selected.

    GoNextOnClick True / False If True then selecting a value from the Drop-down List will automatically take the user to the next page without the requirement to click the “Next” button.

    Property Value Description

    Content HTML HTML text that is displayed to the left of the text input field. It can contain formatted text, graphics, tables and hyperlinks.

  • AnswerPath Version 5 User Guide Page 15 Copyright © 2014 Hindin Solutions Ltd.

    Embedding Hyperlinks 3.6.1

    Hyperlinks can be embedded in the HTML editor by selecting the text that the user is expected to click on

    and clicking on the Web Link tool.

    In all references to URLs, the http:// or https:// must be appended on the front. You can specify whether you

    want the destination website to open in the current browser window or open in a new tab.

    Embedding Images 3.6.2

    Images can be embedded in the HTML editor by clicking on the Image tool.

    Select an image, enter substitute text and select the alignment of the image.

    To edit an image that has been already been embedded into the HTML editor, select the image and click on

    the Image tool.

    When you add images to the notes properties, header fields or footer fields of your Answer Path Script the

    default behaviour of the software is to copy the image from the source location into the Answer Path file.

    That is, when you save the Answer Path file the image is saved within the .ap file.

  • AnswerPath Version 5 User Guide Page 16 Copyright © 2014 Hindin Solutions Ltd.

    You may change this through the Image Management dialog from the Document menu. All images are

    automatically selected to be saved within the .ap file. You can click onto the image name to preview the

    image.

    If you do not wish the image to be saved into the .ap file untick the box. This will mean the image is only

    referenced from your local machine by the .ap file. This is useful only if the image is going to be changed or

    you do not wish the .ap file to become too large.

    When you Export the .ap file to become a webpage (HTML) the image will be included and saved in the

    webpage file (see Section 3.18 Saving an Answer Path File for Use on Your Website).

    If the image is not embedded in the .ap file and that file is later moved to another computer the link to the

    file will be lost and the image will not be able to be previewed or exported for use on your website.

    Creating Conditions 3.7

    Conditions represent the logic which causes different Pages to be displayed depending on the values of

    specific Inputs. Answer Path provides several ways to add conditions.

    Using the Link Tool 3.7.1

    The simplest method is to use the Link tool from the toolbox. Selecting this tool and dragging an arrow from

    the source to the destination Page will cause the Expression Builder window to appear.

  • AnswerPath Version 5 User Guide Page 17 Copyright © 2014 Hindin Solutions Ltd.

    The window presents two types of Expression Builder. Expression builders are used to construct the logic

    involved in a Condition. As initially outlined in section 1.2, Links contain two elements: a Condition, and a

    Page to jump to when that condition is met. Dragging the arrow between two Pages has completed the

    second part (which Page to jump to), and Expression Builders are used to create the rest.

    The first type of Expression Builder is the Simple Builder. This builder allows you to interactively click the

    Inputs which will cause the next Page to be displayed. Multiple options within the Page can be selected

    (clicked) to participate in the condition. In the image above, the Yes option will cause Page 2 to be displayed.

    Clicking an Input once will select it and clicking it again will deselect it. Only one Radio Button per Answer

    Group may be selected. If several Input combinations lead to the same Page being displayed, multiple

    Conditions must be created to achieve this.

    Clicking on any part of a Drop-down List will activate it. Clicking on an activated Drop-down List icon will

    display the list contents. Clicking on the label of an activated Drop-down List will deactivate it.

    If no Inputs are involved in the Condition (making it the Else Condition), then As a default when no other

    matching conditions are found (Else Condition) should be selected. See section 1.2 for more information

    about Else Conditions.

    The Advanced Builder (shown below) can be used to construct more Complex conditions which involve

    inputs from Questions in other Pages. To create an expression using the advanced builder, select an Input

    from the Document Tree on the left (Inputs are coloured in blue text) and click the Add button or drag it

    across to the Selected Input(s) Tree. The branch of the tree the Input belongs to will be copied across. The

    image below shows how the tree appears when the Yes option has been dragged across and selected.

    At the bottom of the Advanced Builder is a textual description of the expression state. As new Inputs are

    added to the selected Input tree, the description is revised to include the new Input information. The display

  • AnswerPath Version 5 User Guide Page 18 Copyright © 2014 Hindin Solutions Ltd.

    of this description may be shortened by selecting the Short option (which removes references to the Page,

    Question and Answer Group each Input belongs to) or the Long option (which includes all context

    information for Inputs).

    To remove an Input from the selected tree, select it and press Remove.

    Note that it is not possible to create Else Conditions with the Advanced Builder – the Simple Builder is

    designed for these types of Conditions.

    Clicking OK will complete the process and create the Condition. An arrow between the two initial Pages

    should appear (if it has not already) indicating that there is at least one Condition joining the two.

    Using the Conditions List 3.7.2

    An alternative method of creating a new Condition is to use the Conditions List. The Conditions List for any

    Page may be accessed by selecting the Page object on the canvas and pressing Ctrl+E, or right clicking the

    Page and selecting the Edit Conditions… item, or by selecting Edit Conditions… from the Page menu on the

    menu bar.

  • AnswerPath Version 5 User Guide Page 19 Copyright © 2014 Hindin Solutions Ltd.

    The image above shows the Condition List dialog for a Page which currently has no Conditions (Page 1). To

    add a new Conditions, click the New… button. The dialog below appears.

    The dialog has three parts. The first part assigns a name to the new Condition. Naming Conditions is

    important as it helps distinguish between Conditions presented in a list. By default, Conditions are assigned

    names such as Condition8, which isn’t descriptive. Names such as “Yes Selected Condition” or “Any Other

    Answer Condition” are useful and indicate the Condition logic from a list without the need to open any editor

    dialogs and read the actual text description of the Condition.

    The second part of the dialog specifies the type of the Condition. Conditions may either be based on the

    values of inputs (Input-based) or be an Else condition. For information about condition types, see section 1.2.

    Conditions based on inputs require logic and the Expression Builders described in section 3.7.1 are used to

    specify this. Pressing the Build Logic button causes the Expression Builder window to be displayed (possibly

    without the greyed out Page on the right, depending on whether a Page to open was specified in the dialog

    before Build Logic was clicked). Further information on the use of the Expression Builders (Simple and

    Advanced) is provided in section 3.7.1.

    Once the Builder has been used to create some logic for the Condition, a description of it appears in the

    Textbox above the Build Logic button.

  • AnswerPath Version 5 User Guide Page 20 Copyright © 2014 Hindin Solutions Ltd.

    The lower part of the dialog specifies the action to take when the Condition is true. Answer Path currently

    supports one action: Open Section. A list of Pages in the document is displayed in a dropdown; one should be

    selected to be opened when this condition is true.

    Clicking OK will complete the process and create the Condition with the specified logic and action to take

    when true.

    Using the Conditions Window 3.7.3

    The Conditions Window can also be used to add a new Condition. Selecting a

    Page object and clicking the Add button will cause the New Condition to be

    displayed. Instructions for creating a new Condition from this dialog are as per

    section 3.7.2.

    Double clicking on a Condition will select it and open it in the Condition Editor.

    Editing Conditions 3.8

    This section covers procedures for editing existing Conditions for a given Page.

    Viewing Existing Conditions 3.8.1

    One of the main advantages of using the Conditions window is the simple display of the components

    associated with a given Condition. As covered in section 2.3.4, the Conditions window displays a list of

    Conditions for the currently selected Page or Link. Selecting one of the Conditions listed will cause Answer

    Path to indicate (in red) the Inputs and Pages associated with that condition.

    The image below illustrates an example of using this window to identify the parts of a Condition on the

    canvas. The Conditions window has Condition7 selected. On the canvas, the input associated with this

    Condition is indicated in red, as is the Page that will be displayed if this Condition is true. The items are

    highlighted only until the mouse is clicked again and this indicator mechanism is intended only to be a guide

    for establishing which parts of the document are associated with each Condition. Else conditions are not

    associated with any Inputs directly and so only the relevant Link and Page will be highlighted.

  • AnswerPath Version 5 User Guide Page 21 Copyright © 2014 Hindin Solutions Ltd.

    Ordering of Conditions 3.8.2

    Section 1.2.2 emphasised the importance of the ordering of Conditions in order to get the desired behaviour

    from an Answer Path Document when it executes. By default, any new Conditions created are added to the

    end of the Conditions List for that Page. If left unchanged, Conditions will be evaluated in the order they

    were created in Answer Path. This fact is important to remember when creating Conditions, as it can avoid

    Condition reordering problems later in the design process. A well-planned document design with Conditions

    on paper can help this.

    If Condition reordering is necessary, the Conditions List dialog can be used to change the position of

    individual conditions within the list for a Page. To display the Conditions List dialog for a specific Page, select

    the desired Page on the canvas and press Ctrl+E, or choose Edit Conditions… from the Page menu. A dialog

    similar to that shown below will appear.

    The and buttons may be used to reposition the selected condition relative to others in the list.

    Conditions at the top of the list will be evaluated first, and those at the bottom evaluated last. By definition,

    any Else Conditions must always appear at the bottom of the list and it is not possible to reposition these

    types of Conditions or move any Conditions below them.

  • AnswerPath Version 5 User Guide Page 22 Copyright © 2014 Hindin Solutions Ltd.

    Deleting Conditions 3.8.3

    Conditions may be deleted from the Conditions List dialog by selecting the Page associated with the

    condition, pressing Ctrl+E. Select the Condition to be deleted from the list, and press the Delete button in

    the dialog.

    Note that deleting some Conditions may cause some Pages to become inaccessible when the Answer Path

    Document is executed (as no logic may exist which would cause them to be displayed). Careful attention

    must be paid when deleting Conditions or the behaviour of the document may be inadvertently altered.

    Answer Path is capable of automatically detecting when some Pages are inaccessible but not all cases are

    checked.

    An alternative method of deleting Conditions is to use the Delete button at the bottom of the Conditions

    window. Selecting a Page will cause all Conditions associated with that Page to appear in the Condition

    window list. Select the Condition to delete and press the Delete button.

    Deleting Links 3.8.4

    Links are the arrows which appear between joined Pages and represent one or more conditions. Deleting a

    Link will delete all Conditions represented by the Link, effectively severing all connection between the two

    involved Pages. Care should be taken when deleting Links as any number of Conditions may be deleted in a

    single operation.

    To check the number of Conditions associated with a given Link, use the Select Tool to first select the Link

    and use the Conditions window to view the list of Conditions that Link represents.

  • AnswerPath Version 5 User Guide Page 23 Copyright © 2014 Hindin Solutions Ltd.

    Linking to Other Websites 3.9

    Linking to external websites 3.9.1

    A Hyperlink object can be added with the Hyperlink Tool on the Toolbox. This will allow the Answer Path

    Document to link to external websites or web pages on the intranet.

    HyperLinks have the following properties:

    Re-Direct to a URL when Clicking on the “Next” Button 3.9.2

    To redirect a user to a URL (as opposed to a new Page) when clicking on the Next button in the script, create

    a Page and populate it with a Question and Inputs as described in 3.4 and 3.5. Next create a new blank Page

    and Link to the Page as described in 3.7. The target page should be left blank.

    In the Properties section of the blank Page add the target URL to the RedirectURL property. Don’t forget to

    use the full description of the URL including the syntax http:// or https://.

    Handling Answer Path Script Data in an External System 3.9.3

    Data from an Answer Path Script can be submitted to external systems using the Hyperlink facility when the

    PostState setting is set to True. The Answer Path Script sends its data to a HTTP URL exposed by the external

    system. An HTML Form containing one hidden Form Input field with the name “xml” will be sent to the URL

    specified in the Hyperlink. The form is submitted using the HTTP POST method. The content of the hidden

    Property Value Description

    Content Text Text that is displayed to the user to represent the hyperlink.

    Notes HTML HTML text that is displayed with the Hyperlink when it is viewed by the end user. It can contain formatted text, graphics, tables and hyperlinks.

    Url Text The URL of the web page that is being linked to. The http:// or https:// prefix must be appended on the front of the URL.

    Target List Specifies whether you want the destination website to open in the current browser window or open in a new tab.

    PostState True / False If True then data from an Answer Path Script will be submitted to the external system identified in the URL. See section 3.9.3 for more details.

  • AnswerPath Version 5 User Guide Page 24 Copyright © 2014 Hindin Solutions Ltd.

    “xml” input is the Answer Path Script session data in XML format and contains a definition of the Answer

    Path Document, data from all user input, and an execution history for the session. Once the form is

    submitted to the URL, the external system can receive and process the XML data.

    The XSD schema defining the session XML has been included in the Documents folder of the installed Answer

    Path folder with the licensed installation pack. Please contact Hindin Solutions if you require further

    information on handling Answer Path script data.

    Changing the Page Appearance and Behaviour 3.10

    Headers and Footers 3.10.1

    Headers and footers can be added to the display by selecting “Header and Footer” from the Document menu

    and editing the information.

    Icons 3.10.2

    The icons for the Question, Answer, Text and Hyperlink shown in Preview mode (and export) can be changed

    by selecting the Icons option in the Documents menu.

    If no icon images are provided then Answer Path will use default images. Note that any new icon should be

    64 pixels x 64 pixels. If not Answer Path will attempt to compress or expand the image to this size.

    Stylesheets and JavaScript 3.10.3

    The Answer Path CSS Reference gives a detailed description of the CSS used to display a previewed or

    exported Answer Path file. You can create your own CSS stylesheet to replace any of the default classes used

    by Answer Path.

    To add your own CSS stylesheet select the “JavaScript And Stylesheet” option from the Document menu.

  • AnswerPath Version 5 User Guide Page 25 Copyright © 2014 Hindin Solutions Ltd.

    Use the browse button to locate your stylesheet. Clicking on the Reference button will save a reference to

    the stylesheet in to the list. Referenced stylesheets appear in the list with (ref) after their name.

    Answer Path does not store a copy of the referenced stylesheet in the Answer Path file but directly

    references it at the location you selected it from. This is useful if you have a common stylesheet that you

    would like to share between Answer Path files (e.g. a corporate image) or if you need to change the

    stylesheet often i.e. when experimenting with screen layout.

    Clicking on the Copy button will copy the stylesheet into the Answer Path file. It is safer to use the Copy

    button if there is a chance that the stylesheet file may be removed from its current location in the future.

    Once a stylesheet has been copied into Answer Path it can no longer be changed unless you remove it from

    the list and copy it back in again.

    Answer Path applies the default Answer Path stylesheet to the exported HTML first then applies the

    stylesheets in the list next. The and buttons can be used to reposition the selected stylesheet relative

    to others in the list. Stylesheets at the top of the list will be applied first, and those at the bottom applied

    last.

    The default Answer Path stylesheet uses the reserved name AnswerPath-Generated-Default-

    Stylesheet.css. If you add your own stylesheet with the same name then it will be ignored.

    You can change the behaviour of an exported Answer Path web site by providing your own JavaScript code.

    The user interface for adding your own JavaScript is identical to adding your own CSS stylesheet.

    Previewing the Document 3.11

    The document may be previewed at any time by pressing F5, clicking on the Preview tab or selecting Preview

    from the Document menu. During a preview, all Answer Path windows are hidden and reappear when the

    preview ends. The document may not be saved or edited while in Preview mode. Pressing Shift+F5 will end

    the Preview and return Answer Path to design mode. Clicking the Design tab for the document will also

    return Answer Path to design mode.

  • AnswerPath Version 5 User Guide Page 26 Copyright © 2014 Hindin Solutions Ltd.

    The Preview facility requires Microsoft Internet Explorer 7.0 or later be installed on the machine in order to

    work. Immediately prior to the preview, Answer Path examines the document state for any errors and

    displays these (if any) in a dialog before the Preview.

    Editing the Document 3.12

    Deleting objects 3.12.1

    Pages, Questions, Answer Groups, and Inputs may be deleted at any point by selecting them and pressing

    the Delete key, or choosing Delete from the Edit menu. When a Page is deleted, all Conditions associated

    with that Page are deleted. Further, deleting inputs will cause any Conditions which relied on that input to

    be deleted.

    Cut, Copy and Paste 3.12.2

    All objects on the canvas can be Cut and Copied to the internal clipboard of Answer Path. To Cut an object,

    select it with the Select Tool and press Ctrl+X, or select Cut from the Edit menu. To copy an object, select it

    and press Ctrl+C, or select Copy from the Edit menu. When pasting objects, the clipboard item will be pasted

    into the currently selected item, if possible. If pasting is not possible, the Paste option (Ctrl+V) will not be

    available from the Edit menu.

    Question objects pasted directly onto the canvas will automatically have a Page created for them.

    Setting Document Properties 3.13

    The title and description of the document may be edited by selecting Properties from the Document menu or

    right-clicking the canvas and selecting Properties from the context menu.

    There is also a property for controlling how text values longer than 600 characters are managed in the

    Summary page. Turning this on will truncate all excessively long values.

    Saving Documents 3.14

    On installation Answer Path will create a folder under My Documents called My AnswerPath Scripts. Example

    Answer Path scripts are stored there and this is the default directory the first time the File>Open Ctrl+O

    dialog is used.

    Saving a Document 3.14.1

    Answer Path Documents may be saved at any point by pressing Ctrl+S or selecting Save from the File menu.

    New Documents may only be saved to the local machine in the .ap format.

    Prior to the Save operation, Answer Path examines the document state for any errors and displays these (if

    any) in a dialog before writing the document to disk.

    To open a saved Answer Path Document, double-click on the file name or press Ctrl+O or select Open in the

    File menu.

  • AnswerPath Version 5 User Guide Page 27 Copyright © 2014 Hindin Solutions Ltd.

    Save As 3.14.2

    Answer Path documents can be saved to a new file at any point by pressing Ctrl-Shift-S or selecting Save As…

    from the File menu.

    You may find this useful if you wish to save your Answer Path Script to a different name, or if you have

    opened a legacy .mapit file and do not wish to overwrite the contents with a Save. Documents may only be

    saved to the local machine in the .ap format with this function.

    Setting the Initial Page 3.15

    From Within Answer Path 3.15.1

    The Initial Page is the Page which is to be displayed first when an Answer Path Script executes. By default,

    the first Page created in Answer Path is labelled as the Initial Page. To change the Initial Page, select the new

    Initial Page from the Initial Page submenu in the Document menu.

    If the Initial Page is deleted during the course of editing, Answer Path defaults to the oldest Page in the

    document.

    From an External Website 3.15.2

    An external website can temporarily override the initial page set within Answer Path by providing two

    parameters in the URL to your Answer Path site. For example

    http://mysite.com/faq.htm?start=Section5&reset=1

    The "start" parameter value should contain the page ID for the first page to be displayed when the browser

    opens the site. The page ID can be found in the Properties window of the page object.

    If the value of the "reset" parameter is set to "1" then the "Reset" button displayed on a previewed Answer

    Path page will return the user to the page specified in the start parameter. If the value of the "reset"

    parameter is set to "0" then the "Reset" button displayed on a previewed Answer Path page will return the

    user to the initial page specified in the Answer Path file.

    Showing and Hiding Windows 3.16

    It is often useful to hide windows to allow more design space. For example, if no new items are being

    created, hiding the Toolbox is useful as the extra space can be used to show more of the canvas.

    The Toolbox, Properties, and Conditions windows may be hidden by clicking the close button on their

    respective title bar or by toggling their entry in the View menu. For windows not currently visible, selecting

    their item in the View menu will cause them to reappear.

  • AnswerPath Version 5 User Guide Page 28 Copyright © 2014 Hindin Solutions Ltd.

    Checking for Errors 3.17

    The document is automatically checked for errors prior to Saving and Previewing. To manually force an error

    check, press Ctrl+K or select the Check For Errors item from the Document menu.

    Saving an Answer Path Document for use on your Website 3.18

    Answer Path Documents can be exported in HTML format so that they can be accessed as a standalone

    HTML document (with supporting images, CSS and script code) outside of Answer Path. A number of options

    are available for configuring how the document is exported, depending on your environment and intended

    use of the HTML.

    Once the content of an Answer Path Document is exported using this facility, Answer Path cannot open or

    edit the HTML file. To make changes to an HTML file you must use an HTML editor, or alternatively you may

    make your changes to the original Answer Path Document (.ap file) using Answer Path and re-export the

    changes as a new HTML file.

    Note: Exported HTML follows the W3C HTML 4.01 Transitional standard.

    Exporting an Answer Path Document as HTML 3.18.1

    To export an existing Answer Path Document select Export... from the Export menu. You will be prompted to

    select a folder and filename for the HTML file you want created.

    By default any supporting files such as images, CSS and JavaScript will be placed in a subfolder of the folder

    that you select here. The diagram below provides an overview of the structure of this subfolder. You may

    change these defaults by selecting Export Options… from the Export menu. These options are discussed in

    section 3.18.2.

    Click Save to finish the process and save the document as HTML. The selected folder will be automatically

    opened for you.

    Note: The subfolder (if this option is used) will be named after the filename you select in the following

    format _folder. For example, if the filename you select is MySelfHelp.htm, the

    supporting folder will be named MySelfHelp_folder. The diagram below shows the structure of the

    folders within the subfolder. The enclosed folders will only be present for the individual options that

    are saved to a subfolder. For example, if Images and JavaScript are selected to be saved to a subfolder

    and Style Sheets are to be embedded then the stylesheets folder will not be present.

  • AnswerPath Version 5 User Guide Page 29 Copyright © 2014 Hindin Solutions Ltd.

    Setting Export Options 3.18.2

    A number of configurable options are available when exporting a Script as HTML. These options may be

    changed at any time by selecting Export Options… from the Export menu. The settings in the Export Options

    dialog are automatically saved between Answer Path sessions.

    Cascading Style Sheet options 3.18.2.1Cascading Style Sheet (CSS) information can be either:

    1. Embedded in the HTML file inside a tag in the document header. This option should be selected if you want to minimise the number of external files that are created in the Export process. This option is not recommended if you intend to use your own stylesheet settings (formatting).

    2. Saved in a sub folder. This option should be selected if you want to have the flexibility of changing the stylesheet for the Script in the future. The CSS information will be saved in a supporting stylesheets subfolder along with the HTML file. The file will be named AnswerPath-Generated-Default-Stylesheet.css. This file can be edited or completely replaced to change the appearance of a Script.

  • AnswerPath Version 5 User Guide Page 30 Copyright © 2014 Hindin Solutions Ltd.

    Image options 3.18.2.2Images can be either:

    1. From Location. This option should be selected if you intend placing the HTML document in a Document Management System, Intranet or Website where you want to centrally control the images used for many Answer Path Documents. If this option is selected, you must provide a path to the location or folder where the images can be found. For example: http://intranetServer/content/AnswerPath/images.

    2. Saved in a sub folder. This option should be selected unless you prefer to use a central Internet location for multiple Answer Path Documents. Images will be saved into a supporting images subfolder along with the HTML file.

    Note: No filename should be included in the URL for the From Location option.

    JavaScript code options 3.18.2.3The main JavaScript code can be either:

    1. Embedded in the HTML file inside a tag. This option should be selected if you want to minimise the number of external files that are created in the Export process.

    2. Saved in a sub folder. The main JavaScript code will be saved in a supporting javascript subfolder along with the HTML file.