Viz Social Deployment Guide

Version 1.1 | Published January 26, 2022 ©

Submission of Pre-Aggregated Poll Data

Submission via JSON Files

Viz Social is able to accept aggregated Poll standings generated by external sources. Out-of-the-box, this is supported via files formatted in Viz Social ’s native Poll JSON format.

Each snapshot of a pre-aggregated, externally-managed Poll must be formatted as follows.

Syntax by Example

Each snapshot of aggregated Poll standings must be formatted as a structure starting with metadata identifying the Poll and its status, followed by counts and other parameters for each Poll alternative. Please find an example of the natively supported structure below:

{
  "id"0,
  "question""Which is your favourite Pokémon?",
  "image""https://code.never.no/test/img/profile-01.jpg",
  "status""open",
  "end_time"1534864196093,
  "timestamp"1534777796093,
  "options": [
    {
      "uuid""a",
      "text""Pokémon #001: Bulbasaur ",
      "count"94,
      "image""https://code.never.no/test/img/pokemon/001.png"
    },
 
    {
      "uuid""b",
      "text""Pokémon #002: Ivysaur ",
      "count"2,
      "image""https://code.never.no/test/img/pokemon/002.png"
    },
 
    {  
      "uuid""c",
      "text""Pokémon #003: Venusaur ",
      "count"6,
      "image""https://code.never.no/test/img/pokemon/003.png"
    }
  ]
}

Semantics

Poll Field Definitions

The table below contains the definitions of the Poll fields and parameters.

Field

Description

Required

id

An ID used to reference the Poll in question

Yes

question

Question text. Is set to a default text in Viz Social if not included.

No

image

URL to image associated with the question.

No

status

open or closed. Currently ignored by Viz Social.

No

end_time

Unix timestamp (in milliseconds) that the Poll ends.

No

timestamp

Current time of the snapshot as a Unix timestamp (in milliseconds).

No

options

Array of alternatives.

Yes (at least one)

uuid

Unique ID to identify the alternative.

Yes

text

Name of the alternative. Is set to the UUID by Viz Social if not provided.

No

count

Aggregated number of cast votes for the alternative so far.

Yes

image

URL to image associated with the alternative.

No

Business Logic

Please take note of the following items when designing the business logic for integrating with an external source of Posts:

  • The example in Syntax by Example shows the widest supported set of fields and parameters. Most fields are optional, see Poll Field Definitions.

  • Question and alternative texts are only set the first time Viz Social harvests the poll. Updates in later snapshots are ignored, but can be processed (overwritten) manually via the Viz Social UI.

  • The read interval to check for updates of the JSON file is configurable on Viz Social.

Dynamics

Files with aggregated Poll standings from external sources must be delivered at a well-defined path where it can be polled by Viz Social. Only one Poll per JSON file is supported.

File access, data transport and naming conventions are not prescribed. After having been agreed, they form input to Never.no’s integration services.

Submission in Other Formats

Aggregated Poll standings in alternative JSON formats or even via RSS/Atom feeds or plain XML, can often be supported via customized pre-processing on-board of Viz Social as well.

Important: Customization options should be discussed with Never.no. Please contact the Never.no support team to discuss options and to come to an optimal solution.