Taswira Documentation

Taswira supports two types of accounts; creators and viewers.

Creators Account

The account have Administrative privileges for customizing taswira for your company. The Creator page is only displayed to users with the relevant privileges. The creators are invited by the admins of their respective companies to collaborate on creation of stories. When invited, a creator receives an email that prompts them to complete creation of an account with the system. This involves creating a strong password which can allow them to access taswira.

Some of the privileges the creator has are as follows:

  1. Create stories
  2. Add data
  3. access dashboards
  4. Edit and update dashboards within their departments
  5. Subscribe to email updates on chosen dashboards
  6. Message the admin

Create Stories

The creators main task within taswira is creating stories out of data which can be consumed by viewers. When creating a story, the creator is requested to select the data source they intend to use, this could either be a JSON file, CSV file, a Database connection or a Custom Dataset from your database

How to create a story:

  1. Select the create story item from sidebar
  2. Select your datasource from the Get Data dropdown menu (Files, Database, Datasets)
  3. For files, click the button select file to preview your data. Finally click on the create story button on the right to create your story.
    1. Click the setting icon at the bottom right corner of the board and select the fields needed for visualization (You can select all or some of the files).
    2. Click on the zigzag icon below the setting button on the top right of the board.
    3. Happy Story telling
  4. For database, it will show all available database connections. You can write a query that picks data from a particular table, you can view tables available in a particular database
    1. You can create your stories from either the db query or create a dataset from your database query.
    2. Click on the zigzag
  5. Once the query has picked the required data, you can save it as a data set or create a story direct from the queried data

Add Data Sources

For a creator to come up with a story or an EDA, they must select the data they want to use hence they have permissions to add data sources they want to work with. Different data sources are supported which include PostgreSQL and mysql databases, files of type json and csv. The file size supported is below 50 mbs and creators can query from a database directly. Steps involved in connecting database include:

  1. select the data source on the left side of the board
  2. Click on databases menu
  3. Click on add new button at the right of the board
  4. Fill the pop up form with your database details then add.

Steps involved in adding a file:

  1. select data source on the left side of the board
  2. Click on files
  3. Click on upload news on the right side of the board
  4. Choose the file type, enter the name of the file and choose file intended for upload.
  5. Click on upload button

access dashboards

  1. A creator has permissions to view all dashboards created within their respective companies.
  2. They can update the dashboard's department
  3. Publish or unpublished a dashboard
  4. They can also delete a dashboard.
  5. There are two menu lists to access dashboards on the board. one is stories on the left side on the menu which has privileges mentioned above.
  6. Another menu is the dashboard located on the left side of the board menu, which gives creators privilege to edit and update dashboards.

Edit and update dashboards within their departments

Creators have privileges to open dashboards within their departments and do edits and updates on them. This can be accessed through the dashboard button on the left menu of the board. Steps involved in editing a dashboard include:

  1. Click on the dashboard menu at the left corner of the board's menu
  2. Here the creator can see a list of dashboards for a particular department they have logged in with.
  3. Creator has permissions to change the dashboard icon, delete dashboard, un publish or duplicate a dashboard.
  4. Click on one of the dashboards you need to edit
  5. Here the creator can change configurations for each chart
  6. Export the whole story, download a chart as an image, data or print.

Subscribe to email updates on chosen dashboards

The creator can subscribe to be emailed with dashboards at a selected time each day. The user will receive a dashboard image posted in their email and a pdf attachment at specified times of the day. As a creator, they can subscribe in order to receive email reports.

Message the admin

For any queries with the system or inquiries, the creator can channel communication direct to the super admins for help.

Viewers account

Taswira viewers are the intended consumers of the company's stories. They can be grouped as stakeholders or business users who are interested in the dashboards created. Viewers are invited by admin of their respective companies to view and export created stories. When invited, a viewer receives an email that prompts them to complete creation of an account with the system. This involves creating a strong password which can allow them to access taswira. Some of the privileges the creator has are as follows:

  • View Dashboards/stories
  • Export stories
  • Download chart images, data or print
  • Apply filters on the data

View Dashboards/stories

A viewer can open created stories within their department and view. This is accessed right after the viewer has logged in, all the stories in their department are enlisted.

Export stories

Viewers can export reports in form of an image. This is saved on the machine to be accessed later. to export a viewer has to click on one of the stories on the board then click the export story button at the top right corner of the board.

Chart Download & Print

Once in an individual story, a viewer has the privilege to download a chart in form of an image (png, jpg, svg, pdf) or data. They can decide to print the image to a printer. These features can be accessed in an individual chart by clicking on a three dotted column at the top right corner of the chart then selecting the type of action from dropdown lists.

Apply filters on the data

A viewer can apply filter on a specific story with desired field options of the story data. This can be accessed from the top right menu of the board. a viewer clicks on the filter icon that gives them an option to select fields to filter on.