In the left-hand pane of the AskiaSurf window, you will find the campaign tree. It contains a list of the waves and volumes that make up your campaign.
You can expand or contract an item in the tree by clicking + and - respectively. For example, when you expand a wave, you can view a list of its volumes.
By clicking the campaign or a wave in the tree, you can view or edit its details (the questions in a campaign or wave appear in the right-hand pane, and a description of the wave or campaign appears in the bottom pane).
You can rename any item in the tree (campaign, wave or volume) by clicking it to select it, then pressing F2 (or clicking it again), then typing the new label.
There are three different context (right-click) menus, depending on the item that you right click.
When you right-click the campaign, the context menu contains the following command:
Add new wave...: Allows you to add a wave to the campaign. The add new wave dialog appears. The new wave you create is placed beneath the other waves in the tree; askiasurf treats it as a later wave in the campaign than those already present (in other words, you should add waves only in sequence). This command is not available if there is a wave present in the campaign that has not yet been reconciled.
Open containing folder: Available if your campaign has been saved (as a QEW file), this command opens the folder containing the QEW in Windows Explorer.
Maximise response count: Sets the maximum response count on each closed campaign question based on what is found in the matching source questions. You are given the option to keep the existing value in a campaign question if it is found to be higher than the value in any matched source. AskiaSurf indicates how many questions it has a changed as a result of this command.
Maximise numeric decimals: This command sets the maximum number of decimals on each numeric campaign question based on what is found in the matching source questions. You are given the option to keep the existing value in a campaign question if it is found to be higher than the value in any matched source. Askiasurf indicates how many questions it has a changed as a result of this command.
When you right-click a wave, the context menu contains the following commands:
Add new volume...: Allows you to add a volume to the selected wave. The add new volume dialog appears. This command is available only if the selected wave is the final one in the campaign tree (i.e. if it is the most recent wave).
Add new wave above this: Allows you to add a new wave in the tree above the selected wave. The add new wave dialog appears, allowing you to set up details of the new wave.
Apply wave question order: Re-order campaign questions and responses so that their order matches, as closely as possible, that of the selected wave.
Freeze entry codes: If you select this command, entry codes are frozen for all closed questions (but note that loops are unaffected) in the order that they appear in the selected wave. This prevents unwanted results with calculated variables in AskiaVista. This can occur when you add a new wave in AskiaSurf and then change the order of the items in the campaign question (normally the entry codes would change and this can cause AskiaVista calculated variables to be miscalculated).
Reconcile questions: Reconciles this wave. AskiaSurf performs automatic reconciliation and then opens the reconciliation view, so you can view the results and perform manual reconciliation if required. This command is not available if the selected wave has already been reconciled, or if it contains no volumes. Note that you can also reconcile unmatched questions only (see below).
Show reconciliation: Displays the results of a previous reconciliation of this wave in the right-hand pane (in other words, the reconciliation view appears). This command is available only if the selected wave has been reconciled.
Show reconciliation summary: Displays the reconciliation summary report for this wave which shows you how much manual reconciliation still needs to be carried out for the wave (i.e. how many non-matches or imperfect questions/response matches have been found). This command is available only if the selected wave has been reconciled.
Redo reconciliation: Re-reconciles this wave. AskiaSurf performs automatic reconciliation and then opens the reconciliation view, so you can view the results and perform manual reconciliation if required. When you select this command, you are presented with two options:
Apply caption library. If selected, you can apply a caption library to the re-reconciliation.
Keep chapters. If selected, this option retains any chapters, and their order, in the wave.
This command is available only if the selected wave has been reconciled.
Reconcile unmatched questions only: Re-reconciles this wave, reconciling any unmatched campaign and source questions only. AskiaSurf performs automatic reconciliation and then opens the reconciliation view, so you can view the results and perform manual reconciliation if required. This command is available only if the selected wave has been reconciled.
Remove wave: Removes the selected wave, and any volumes it contains, from the campaign.
Caution: when you select this command, you are asked to confirm your choice; if you answer yes, the wave is permanently removed from the campaign. Any manual questions or response matches you have performed are lost and you will have to perform them again if you subsequently change your mind.
This command is available only if the selected wave is the final one in the campaign tree (i.e. you cannot remove a wave from the middle of the campaign).
When you right-click a volume, the context menu contains the following commands:
Open volume in AskiaDesign: Opens the selected volume in AskiaDesign, if AskiaDesign is installed on your computer.
Warning: you should be very careful what changes you make to a volume once you are using it in AskiaSurf:
Minor changes, like changing aspects of a question or response, will normally result in the question or response being flagged as having changed.
However, deletion of a questions from the volume will result in the campaign referencing a question that no longer exists, and askiasurf will display an error message.
Adding a question to the volume file will result in an unmatched volume question, but will not normally cause any problems.
Open volume in AskiaAnalyse: Opens the selected volume in AskiaAnalyse, if AskiaDesign is installed on your computer.
Remove volume: Removes the selected volume from the parent wave. When you select this command, you are asked to confirm your choice; if you answer yes, the volume is permanently removed from the wave and campaign. This command is not available if the parent wave has already been reconciled and the volume was present at the time (in other words, if the volume has been used in a reconciliation).
Unreconcile volume: Undoes a previous reconciliation. You will be prompted to confirm your action. If you go ahead, all manual matchings done for the volume will be permanently removed.