'User Input Node' functionality

A guide to creating 'User Input Nodes' and then creating hooks into those nodes

Using Ignition Post Win Client as a Template Editor.


  1. From the main tabs select: DATA

  2. From the sub-tabs select: SCHEMAS & HOOKS


There are three main panes:

  • SCHEMAS with SCHEMA below it

  • HOOKS with WORKING SET and HOOK PROPERTIES below it

  • HOOK EVALUATION


  1. Within SCHEMA make the following selections:

    1. Data Provider: XMLTeam

    2. Target: Production

    3. Schema: soccer event-report

    4. Sample Data: Southampton v Leicester City

  2. From the main tab DATA select the sub-tab:

    1. DATA PROVIDERS

  3. In the left 'Search Data Providers' pane, select:

    1. XMLTeam


The main view has information about the URL etc. Below that is the SCHEMA & SEARCHES pane, which has three sub-tabs:

  • SCHEMAS

  • SEARCHES

  • SCHEDULES

  • To the right-hand side is a greyed out pane - which will become populated in a moment.


  1. Below the sub-tab SCHEMAS, select the 'soccer event-report' schema


The greyed out pane has now populated with two tabs:

  • DATA SUBSETS

  • USER INPUT DATA


  1. Select the 'USER INPUT DATA' tab

  2. Expand 'sports-content'

  3. Expand 'sports-metadata'


The idea is to create the new nodes as seen in the below image:


'User Input Node' functionality


You will note there are five bright white text nodes in the above image, which are not currently in the Win Client.


  1. Hover the mouse over 'sports-metadata'

  2. To the right is a permanent 'cube' icon - this denotes 'Object'

  3. To the right - but only when the node is highlighted, an icon appears, now hover the mouse over the icon:

    1. 'Create a new user input node under this element'


You will notice a '@' icon against some of the nodes - this denotes 'Value'. User Input Nodes can be created below 'Objects' but not 'Values'.


  1. Ensure you are using the 'sports-metadata' icon, click 'Create a new user input node under this element'

      • A new 'EDIT' pane now appears, with the following fields:
          Node Label: New User Input Node
          Node Name: new-user-input-node
          Input Type: Text

    1. Change the Node Label to: Commentator Name

    2. Change the Node Name to: commentator

    3. Change the Input Type to: Options

    4. In the available 'Option' fields add the following 4 options:


    5. Alistair Bruce-Ball

    6. Steve Wilson

    7. _ ?

    8. <BLANK> (i.e. leave the field empty)


    9. Set the 'Default Value' to: _ ?

    10. TICK the 'Allows Override'

    11. Click 'Save'


Repeating some of the above steps, you now need to create further new user input node.


  1. Ensure you are using the 'sports-metadata' icon, click 'Create a new user input node under this element'

    1. Change the Node Label to: Validate

    2. Change the Node Name to: validate

    3. Change the Input Type to: Bool

    4. Ensure the 'Default Value' is: false

    5. Click 'Save'


The above user input node can be used by an Operator to set true or false, which can then be used to set conditions for certain actions. More will become clear in the following tutorial. You now need two user input nodes to allow an Operator to select the kit a team may be wearing for a match. This is needed to ensure some graphics (i.e. with images of the player) have the same kit being worn by the team.


  1. Ensure you are using the 'sports-metadata' icon, click 'Create a new user input node under this element'

    1. Change the Node Label to: Home Team Kit

    2. Change the Node Name to: homekit

    3. Change the Input Type to: Options

    4. In the available 'Option' fields add the following 5 options:


    5. home

    6. away

    7. third

    8. _ ?

    9. <BLANK> (i.e. leave the field empty)


    10. Set the 'Default Value' to: _ ?

    11. TICK the 'Allows Override'

    12. Click 'Save'


The above is restricted to the home team, now for the away team.


  1. Ensure you are using the 'sports-metadata' icon, click 'Create a new user input node under this element'

    1. Change the Node Label to: Away Team Kit

    2. Change the Node Name to: awaykit

    3. Change the Input Type to: Options

    4. In the available 'Option' fields add the following 5 options:


    5. home

    6. away

    7. third

    8. _ ?

    9. <BLANK> (i.e. leave the field empty)


    10. Set the 'Default Value' to: _ ?

    11. TICK the 'Allows Override'

    12. Click 'Save'


At times there will not be an image of the team kit (including the sponsorship logos etc), i.e. during FA Cup matches. If the kit is not held as an image, the base colour can be set for use within certain graphics - i.e a 'Formation' graphic.


  1. Ensure you are using the 'sports-metadata' icon, click 'Create a new user input node under this element'

    1. Change the Node Label to: FA Colour Strip

    2. Change the Node Name to: facolour

    3. Change the Input Type to: Options

    4. In the available fields add the following 5 options:


    5. WHITE

    6. RED

    7. BLUE

    8. _ ?

    9. <BLANK> (i.e. leave the field empty)


    10. Set the 'Default Value' to: _ ?

    11. TICK the 'Allows Override'

    12. Click 'Save'


The Schema


  1. From the main tabs select: DATA

  2. From the sub-tabs select: SCHEMAS & HOOKS


There are three main panes:

  • SCHEMAS - with SCHEMA below it

  • HOOKS - with WORKING SET and HOOK PROPERTIES below it

  • HOOK EVALUATION


  1. Within SCHEMA make the following selections:

    1. Data Provider: XMLTeam

    2. Target: Production

    3. Schema: soccer event-report

    4. Sample Data: Southampton v Leicester City


Hook Creation


  1. Expand the following nodes below SCHEMA:

    1. sports-content

    2. sports-metadata


As you can see in the image below, the newly created user input nodes are now available.


'User Input Node' functionality


  1. Highlight the 'sports-metadata' node

  2. Click 'Create a new hook into this element'

  3. Rename 'User Input Node Hooks'


This will be the parent hook for the following five sub-hooks, which use the newly created User Input Nodes.


  1. Highlight the 'commentator' node

    1. Click 'Create a new hook into this element'

  2. Highlight the 'validate' node

    1. Click 'Create a new hook into this element'

  3. Highlight the 'homekit' node

    1. Click 'Create a new hook into this element'

  4. Highlight the 'awaykit' node

    1. Click 'Create a new hook into this element'

  5. Highlight the 'facolour' node

    1. Click 'Create a new hook into this element'


'User Input Node' functionality


Hook Evaluation


Initially, the evaluation does not return a value for each of the newly created User Input Nodes.


With appropriate steps, the User Input Nodes can be made visible in the Ignition Post Web Client. They can then be altered there, using their options (if available), a tick box (if Boolean was set as the Input Type) and can be overridden (if the 'Allows Override ' option was Ticked).


The Hook Evaluation will then display some data; such as the default values; which can be seen in the image below.


'User Input Node' functionality


You will manipulate your 'User Input Nodes' in the next tutorial: