Conducttr HelpDocs
Contact supportOld_HelpDocs
  • START HERE!
    • How to use this site
    • Getting started
  • FEATURE DOCUMENTATION
    • Important Foundations
      • Organisational structure
      • Deleting assets
    • Planning (AXS)
      • Assistants
        • LISA
      • Canvas
      • FIEMA
    • Designing
      • Editor
        • Project Activities
          • Collaboration 1.0
          • Exercise file activities
          • Exporting projects and exercises
        • Licences
        • Master Events List
          • Multiple Master Events List
          • Questions
        • Media
        • Personas
          • Persona libraries
          • Working with personas
            • Unique voice
            • Influence
            • Social Graph
            • ⚡Gotchas
            • Batch & Bulk operations
          • Factions
        • Configuration
          • Participants
            • Registration
              • Cookies, Privacy and T&Cs Statements
            • Teams
              • How To Assign Roles and Positions
            • Players, Personas and Role-players
              • Impersonation
              • Persona as a team member
          • Exercise
            • Exercise design
            • Exercise Setup
            • Channels
              • Historical Content
              • ⚡Why is a channel still showing?
              • Popular Channels
                • Email
                • Messenger (Msngr)
                • MicroBlog (Twitter)
                  • ⚡Tweets not appearing
                • Websites/News
                  • ⭐Simulating a cyber-attack in the MEL
                    • Hack website in the MEL
                    • 🔥Web page details
                • GoSocial (Facebook/Linkedin)
              • Pop Up Channels
                • 🔀Which Pop up is right for me?
                • Notification
                • Media pop-up
                • Phone call
                • Walkie Talkie
              • Information based Channels
                • Diagrams
                • Portal
                • Captions
                • Graph
              • Exercise Logging Channels
                • Decision log
                • Checklist
              • Monitoring and Alerting Channels
                • Help Desk Channel
                • InfoMap
                • Social Watch
              • Collaboration based Channels
                • Messenger Plus
                • TeamChat Plus
              • Other Social Channels
                • InstaMedia (Instagram)
                • Telegraph
                • Videoblog
                • Forum (Reddit)
                • Bulletin
                • BearSocial
                • Panda
              • Legacy Channels
                • TV
                • Browser
                • Blog
                • TeamChat
              • External Messaging Channels
                • External Email
                • Alert email
            • Capturing Observations
              • 🔀What's right for me?
              • Assessment Toolkit
              • Checklist creation
                • ⚡Checklist not appearing?
            • Diagrams
            • Smartwords - Dynamic Content
              • Exercise Smartwords
              • Persona Smartwords
              • Player Smartwords
              • Content smartwords
              • Conducttr Engine Smartwords
              • Functions
                • DATETIME formatting
            • Facilitator Dashboard
          • Style
        • Pattern of Life (PoL)
    • Running
      • 🤔Some definitions of who does what
      • The Virtual Desktop
      • Exercise Control
        • Facilitation
          • Teams
            • Team upload via Facilitator Dashboard
            • Positions and Special Permissions
          • Facilitator Dashboard
            • Master Events List
              • Multiple Master Events List
          • Pattern of Life
            • Dynamic Retweeting with Smartwords
          • Injects Grid
          • ⭐Live Cyber-Attack Simulation
            • Simulate a cyber-attack
            • 🔥Data corruption
        • Observation
          • Reviewing activity
            • 🔀What's right for me?
            • 🔥Confirming players are logged in
            • Review tab
              • Review
              • Assess
                • ⚡Assess tab not appearing?
              • Reports
              • ⚡Review tab not appearing?
            • Monitoring (Pulse)
              • 🔥Pulse disposition timeline
          • Capturing information
            • After-Action Review feature
            • Checklist operation
        • Adjudication
          • Spoof social engagement
        • Role-playing
          • 🔀What's right for me?
          • Impersonation
          • Log in as Persona
        • Observing
          • After-Action Review (AAR)
          • Pulse
      • Players (training audience)
        • Navigating Channels
          • Information-based channels
            • Website/News
          • Team-based channels
            • Social Media
              • MicroBlog (Twitter)
              • GoSocial (Facebook/Linkedin)
              • InstaMedia (Instagram)
              • Forum (Reddit)
            • Decision log
          • Solo-based channels
            • Email
          • Collaboration channels
            • Messenger Plus
            • TeamChat Plus
          • Tools-based channels
            • Social Watch
            • InfoMap
            • Checklist
      • Live updates from Scenario Editor
        • Refreshing personas
    • Reporting
      • Exporting
      • Feedback Summary for Exercise
  • HOW TO
    • How do I....
      • Live Cyber-Attack Simulation
      • Simulate a cyber-attack
      • Data corruption
  • PLAYER GUIDE
    • Role-Playing
  • CONCEPTS
    • Planning
      • Individualistic personas
        • Beliefs
    • Designing
      • Exercise design
        • Considerations and constraints
      • Scenario Design
    • Running
  • WORLDS
    • Concept
      • Facilitators
      • Administrators
    • Designing
      • Exercise
        • Setting up Worlds in the Scenario Editor
          • Adding exercise slots
        • Exercise setup
      • Hubs
        • Creating new Hubs
        • Deactivating Hubs
      • World Settings
        • Welcome Email
          • Customising the Welcome Email
          • Sending a Welcome Email
    • Running
      • Registering Facilitators
      • Uploading scenarios
      • Using Worlds for Facilitators
        • Uploading an exercise
        • Giving access to participants
    • Reporting
      • Metrics
  • FAQs and Common Issues
    • Registration & log in
      • I'm not receiving the password reset
      • The password reset is arriving late
      • Do I have to register my players?
    • Device & environment requirements
    • You're Already Logged In Elsewhere
  • RELEASE NOTES
    • 2025
      • February 2025
      • March 2025
    • 2024
      • June 2024
      • July 2024
      • September 2024
      • October 2024
      • December 2024
    • Installing Scenario Editor
      • Installing on Apple Mac
  • LOCAL
    • On-premises solution
      • Packing for Local
Powered by GitBook
On this page
  • Audience Responses
  • Arrays
  • Nested Smartwords

Was this helpful?

  1. FEATURE DOCUMENTATION
  2. Designing
  3. Editor
  4. Configuration
  5. Exercise
  6. Smartwords - Dynamic Content

Conducttr Engine Smartwords

You can achieve a lot with Conducttr engine smartwords and functions but it's usually for pro-users and often those using Colibri where you can add calculations.

While the {} smartwords make life easier for commonly-used data, there's a lot more you can do by directly accessing the Conducttr Engine. These smartwords use the || delimiters instead of {}. Please note that you can't use the two together. The rest of this article might get a bit complicated for some but even if you don't understand it completely, you might still be able to use the recipes.

Audience Responses

To capture the player's response to the last question, you can use: |audience.response| Note that this only survives the immediate use after the question. If you want to store the response, you'll need to save it in a variable using a calculation.

Arrays

Arrays are like tables with two columns: the left column is the index and the right column is the data. You use the index to access to data.

Symbols

[ ] denotes an array

( ) denotes a function

| | denotes a smartword

{ } a short form for some smartwords

Indexes

Most indexes are in quotes " " because we want Conducttr to use that actually text. Without the quotes Conducttr will try to find a variable of that name.

The exercise Smartwords table is actually an array that internally is called the "custom_data" array. If you're writing content to use the custom_data array, writing something like {data.stadium} is the easiest approach but you could also write |partition.custom_data["stadium"]| - they both mean the same. Conducttr maintains the following arrays:

Array
Description

custom_data

audience.responses

Holds all the question answers for a the current player. The index is in the format campaign code.card number The campaign code can be configured by going to Setup>Essential configuration>Campaign code Assuming a campaign code of "panda", then to get the player's response to the question asked on card 56, the smartword would be |audience.responses["panda.56"]|

partition.decisions

Holds a count of players clicking on a data point (see the article on data points to understand what these are). This is also indexed using the campaign code but it has two types of index:

  • campaign_code.card_number

  • campaign_code.card_number.choice

As an example, if the campaign code is "mr" and the card number is 3 and you want to know how many players have click the first choice, the smartword would be |partition.decisions["mr.3.1"]| If you wanted to print this as a percentage you could write |partition.decisions["mr.3.1"]| other person(s) took this decision which is |INT((partition.decisions["mr.3.1"]/partition.decisions["mr.3"])*100)|% of the total

partition.variables

Holds the values of all the variables you've created in calculations. To access a partition variable you're usually better off to use the {} notation but if you have to use || then this is how it looks... the array holds three types of variable: audience, team and session. And these are identified in the index by a suffix - a. for audience, t. for team and s. for session. To access the value of the variable, use |partition.variables[CONCAT("{entity suffix}.",{entity it},".{variable name}")]| The entity id for each entity is:

  • audience.hash

  • audience.participant_team_id

  • audience.session_id

So, putting this altogether, to access the audience attribute "my_score" the formula is |partition.variables[CONCAT("a.",audience.hash,".my_score")]| To access the team attribute "team_decision" the formula is |partition.variables[CONCAT("a.", audience.participant_team_id,".team_decision")]|

partition.the_chart_index

Holds the button text for any data point you create. The array is indexed by campaign_code.card_number.button_number In the image below, of he campaign code is "defsc" then |partition.the_chart_index["defsc.3.1"]| = "stay INSIDE"

Nested Smartwords

Note that this is an advanced feature and not for the fainthearted ;)

Nested smartwords allows authors to create more dynamic experiences by using variables to access the data in other variables. Example Let's say you ask the player to choose a song and store the answer in a player variable called "music". Normally to access this variable we would use {music}. To nest the smartword you need to use the || notation. Hence the player variable "music" will become |partition.variables[CONCAT("a.",audience.hash,".music")]| But lets say we want to use the the value in "music" to access some data in the custom data table. To do this we will use this expression:

|partition.custom_data[partition.variables[CONCAT("a.",audience.hash,".music")]]|

PreviousContent smartwordsNextFunctions

Last updated 8 months ago

Was this helpful?

Holds the data you've added to personalise this scenario. See

exercise smartwords