Data market end user exercises

Data Market: End-User Exercises
Aitor Magán (UPM)
amagan@fi.upm.es
@AitorMagan

Outline
2
• DM-EU-1: Create a Private Dataset
• DM-EU-2: API Usage – Get entries
• DM-EU-3: API Usage – Insert entries
• DM-EU-4: Publish the dataset in the Store
• DM-EU-5: Mashup to visualize the data
• DM-EU-6: Publish the Mashup in the Store
• DM-EU-7: Create a compound offering
• DM-EU-8: Acquire the offering
• DM-EU-9: Install the mashup

DM-EU-1. Create a Private Dataset
• Prerequisites
– A FIWARE Lab account
– A CSV file with a dataset. You can use the
example one published in the Store (Madrid
Public Transport Pass Price Evolution - FIWARE
Developers Weeks)
• Click on Resources
• Download the CSV in your local file system
Easy

DM-EU-1. Create a Private Dataset
• Steps
– Go to Data portal page
• https://data.lab.fiware.org
– Log in
– Go to the “Datasets” section
– Click “Add dataset”
– Complete the fields
• Set the title based on your name to avoid conflicts
• Remember: “Create a private dataset”
– “Next: Add data”
– Upload the CSV
• Format: CSV
– “Next: Additional Info” > “Finish”
Easy

DM-EU-2. API Usage: Get Entries
• Prerequisites
– A published dataset in the Data Portal
• Data API should be enabled: Active by default if you uploaded
a CSV file
• Steps
– Check CKAN documentation
– Use action “datastore_search”
• Hints
– Use a REST Client to ease the authorization process
• You can also use cURL but you will be the one in charge of
sending the Authorization token
– https://data.lab.fiware.org/api/action/{ACTION_NAME}
– “resource_id”: Can be obtained when you are viewing the
resource in the GUI.
Medium

DM-EU-3. API Usage: Insert Entries
• Prerequisites
• Data API should be enabled: Active by default if you uploaded a CSV
file
• Steps
– Use action “datastore_upsert”
– Insert the prices for 2015
• Figure them out or use the 2014 ones
• Hints
– Use a REST Client to ease the authorization process
• You can also use cURL but you will be the one in charge of sending the
Authorization token
– http://ckan.readthedocs.org/en/255-update-api-docs/datastore-
api.html
– https://data.lab.fiware.org/api/action/{ACTION_NAME}
– “resource_id”: Can be obtained when you are viewing the
resource in the GUI.
– “force”: true
– “method”: “insert”
Hard

DM-EU-4. Publish the Dataset in the Store
• Prerequisites
• DM-EU-1
• Steps
– Click on your dataset
– Click on “Manage”
– Click on “Publish”
– Complete the form
– Click “Publish Offering”
• Hints
– Complete the legal terms fields if you want users to
accept some restrictions for using your data
Easy

Medium
DM-EU-5. Mashup to visualize the data (1)
• Prerequisites
– The widgets/operator to visualize data and
connect with CKAN
• Acquire (for free) the offering called “CKANStarterKit”
• Go to the Mashup Platform
• Go to the MarketPlace
• Look for “CKANStarterKit”
• Click “Install”

Medium
• Prerequisites
• Data API should be enabled for the resource
contained in the dataset
– Active by default if you upload a CSV as done in DM-
EU-1

Medium
• Steps
– Create a new Work Space
• No Template
• Chose an appropriate name
– Add the following widgets:
• ckan_operator
• graphs
• linear_graphs
• Tables
– Move to the Wiring Editor
– Click on “Operators”
• Drag and drop “CKAN Source”

Medium
• Steps
– Connect widgets and operators
– Modify CKAN Source Settings
• Set CKAN Server URL to: https://data.lab.fiware.org
– WARN: The default one contains an extra dash
• Set Resource ID
– Go back to the Work Space
• Hints
– “resource_id”: Can be obtained when you are
viewing the resource in the GUI.

DM-EU-6. Publish the Mashup in the Store
• Prerequisites
– DM-EU-5
• Steps
– Click on Work Space properties button
– “Upload to My Resources”
– Complete the required fields
– Click on “Advanced” tab
• “Embed used widgets/operators”
– Accept
– Click on “My Resources”
– Click on the created Mashup
– Click “Publish”
– Select the appropriate Store
Easy

DM-EU-7. Create a compound offering (1)
• Prerequisites
– DM-EU-4
– DM-EU-6
• Steps
– Access the Store Portal
– Click “My Offerings”
– Click “Provider Options”
– Click “Create offering”
• Name: Use Camel Case (ExampleName)
• Version: 1.0
• Provide Notification URL:
https://data.lab.fiware.org/api/action/dataset_acquired
– Next: Add legal terms, description and price
– Next: Avoid this section
Easy

DM-EU-7. Create a compound offering (2)
• Steps
– Next: Chose the two resources: the Mashup and the
dataset
– Accept
– Click “Provided”
– Click on the offering you’ve just created
– Insert tags. At least use the following ones:
• widget
• dataset
– Accept
– Publish
Easy

DM-EU-8. Acquire the offering (1)
• Prerequisites
– DM-EU-4 or DM-EU-7 (preferably)
– Another FIWARE Lab account
• Steps
– Go to the Data Portal
• Look for your dataset
• Check that is labeled as “Private”
• Check that you cannot access
– Click on the link provided to get the rights
– Click on one of the offerings provided
• Try to chose the one with the MashUp
• Hint: You can click on the offering in the “Resources” tab to view
the different resources contained in the offering
Easy

DM-EU-8. Acquire the offering (2)
• Steps
– Click on the price or “Free” (depends on the price you’ve
set when creating the offering)
– Accept the terms (if any)
– Introduce an address
• You can fake it
– Accept
– Click on resources
• Access the dataset and check that you can access it now.
Easy

DM-EU-9. Install the Mashup
• Prerequisites
– DM-EU-8
– Have acquired the offering with the Mashup in the last
exercise
• Steps
– Go to the Mashup portal
– Click on “Marketplace”
– Look for the offering you published in previous exercises
– Click install
– Go back
– Create a new Work Space
• Template: the one with the mashup to visualize the Dataset
Easy

Data market end user exercises

Recommended

Recommended

More Related Content

Viewers also liked

Viewers also liked (15)

Similar to Data market end user exercises

Similar to Data market end user exercises (20)

Recently uploaded

Recently uploaded (20)

Data market end user exercises