Skip to content

User Guide Overview

This user guide provides detailed instructions for working with each component of the Askalot platform. The guide is organized by workflow stage, from questionnaire design through data analysis.

Guide Contents

Creating Surveys with Armiger

Creating Surveys covers the complete process of questionnaire authoring:

  • QML syntax and structure
  • Question types and input controls
  • Preconditions and postconditions
  • Variables and code blocks
  • AI-assisted generation
  • SMT validation and debugging
  • Flow visualization

Armiger provides a browser-based development environment with syntax highlighting, real-time validation, and interactive diagram generation.

Designing Campaigns with Targetor

Campaign Management explains campaign orchestration and audience management:

  • Target User Management: Import and manage respondent databases
  • Projects: Organize questionnaires into logical projects
  • Questionnaires: Upload and version QML files
  • Campaigns: Configure demographic targeting, launch schedules, and track progress

Targetor enables representative sampling by targeting specific demographic profiles and monitoring real-time completion rates across segments.

Executing Surveys with SirWay

Survey Execution covers the respondent experience and survey administration:

  • Dynamic question flow with lazy evaluation
  • Precondition evaluation and adaptive navigation
  • Progress tracking and flow visualization
  • Interviewer-Assisted Mode for phone and in-person interviews

SirWay supports two execution modes:

  1. Direct Mode: Respondents complete surveys independently via unique links
  2. Interviewer-Assisted Mode: Trained interviewers conduct interviews by phone or in person and enter responses on behalf of respondents

Interviewer-Assisted Mode is valuable for:

  • Phone interviews where the operator enters responses while questioning (CATI)
  • In-person interviews where the interviewer operates the interface (CAPI)
  • Populations with limited digital literacy
  • Situations requiring clarification or translation

Both modes benefit from SirWay's contradiction-free guarantee and dynamic flow control.

Analyzing Data with Balansor

Data Analysis covers post-collection processing:

  • Extract: Create Bronze datasets from campaigns or projects
  • Weighting: Post-stratification raking to match target demographics (Bronze → Silver)
  • Refine: Computed fields (Top/Bottom Box, scale construction, counts), field transformation, and semantic clustering of open-ended responses (Silver → Gold)
  • Quality: Sample representativeness and response quality metrics
  • Export: Multi-format output (CSV, Excel, SPSS, Parquet) from any pipeline stage

Balansor organizes datasets into bundles — lineage-linked groups from Bronze through Silver to Gold — providing a unified view of the data pipeline.

Balansor ensures that survey results are statistically representative and ready for analysis by correcting sampling bias through post-stratification techniques.

AI-Assisted Features

The platform includes AI-assisted capabilities across the workflow. See the dedicated AI Assisted Features section for details:

Organization-Based Data Sharing

Organization-Based Data Sharing explains how Askalot handles data visibility based on your organization's sharing mode:

  • Non-private organizations (default): Users have isolated access to their own QML files and respondents
  • Private organizations: QML files and respondents are shared among all organization members
  • Project ownership controls access to questionnaires and campaigns
  • Practical examples for collaborative teams and independent research units

Understanding your organization's sharing mode helps you work effectively within your environment's data model.

Workflow Summary

The typical workflow progresses through these stages:

  1. Design → Create questionnaire in Armiger with QML and SMT validation
  2. Campaign → Upload questionnaire to Targetor, import users, configure demographics
  3. Execute → Respondents (or interviewers) complete surveys in SirWay with dynamic flow
  4. Analyze → Process responses in Balansor with statistical correction and export

Each guide section provides detailed instructions, examples, and best practices for its respective stage.

AI Assistance: The Campaign Wizard and Chat Interface can guide you through these stages conversationally, handling complex operations and providing recommendations at each step.

Getting Started

If you're new to Askalot, we recommend:

  1. Start with Quick Start Guide for a complete workflow walkthrough
  2. Follow Creating Surveys to learn QML syntax
  3. Reference Theory for mathematical foundations

For specific tasks, navigate directly to the relevant guide section above.