This How To will describe the setup of a wirecloud environment with CKAN as source on the FIWARE Lab NL.
The result will be displaying playgrounds of Utrecht being displayed on a map using widgets and wiring.
To start this guide, you will need to have setup a wirecloud instance on the lab. Default username and password is 'admin'/'admin'.
Please change this, since the server is public accessible!
We added an user called WireCloud5412 in our setup, since admin is no user to be used
After login, your (empty) workspace is displayed on the screen:
First thing you have to do, is upload the correct widgets to your environment. THere are multiple versions of these widgets, not all working.
We sorted out a base set of working widgets which can be used directly on the FIWARE Lab NL:
In the near future, we will provide a marketplace with working widgets for the FIWARE Lab NL.
To upload a widget to the wirecloud, you need to upload a widget file from your local computer.
First goto 'My Resources'
Press the 'Upload button'
Now simply drag the widget from a explorer/finder to the window and press upload
The following screen is shown. Do not upload too many at once, it will cost you a bit more time, but exceptions are much easiers to track
After uploading the desired widgets, your resource screen might look like this:
Now it is time to create your workspace. Goto the main screen and press 'Add widget'
Look up the Map Viewer, and press the '+' to add this to the workspace
Now the widget is placed on the workspace. But we want it to focus on Utrecht and zoom to a more detailed zoomlevel
On the top right there is a 'hidden' menu:
Now select 'Settings' from the menu and change the popup screen:
Accept the changes and your result will be an empty map Utrecht
Now it is time to wire up with external data:
Press the 'Find components' button
On the widget tab, drag the Map Viewer (orange) to the main screen
Select the Operators tab, and look for CKAN Source
Now drag the ckan source (green) to the main screen
Repeat this for the 'CKAN to Pois' component
We can now simply connect the lines:
CKAN Source - Resource -> CKAN to Pois - Entity
CKAN to Pois - Poi -> Map Viewer - Insert/Update Poi
Now we need to configure the components with the correct resources and settings.
First we need to tell the 'CKAN to Pois' to use the correct location fields. You can look up these fields in the CKAN site.
In this case, the location is 'latitude, longitude' (comma seperated fields!) Press the triple horizontal lines on the 'CKAN to Pois' component and press settings:
Now we need to configure the source for the CKAN component
Goto the settings of the CKAN Source component, and goto settings
Enter the desired fields (ckan resource 01f778aa-2ec7-4244-8547-afc1bf30b21a)
Just one step away of showing the right field for coordinates. Just goto the settings of the CKAN to POIs and set the coordinate attributes for Latitude, Longitude:
Now you are done, just refresh your browser in the main screen!
If you are using NGSI (IoT) devices, you just need to change the CKAN source and CKAN to POIs to these components:
Use the NGSI Source and NGSI Entity to POI. The settings for the current Orion contextbroker are: "22.214.171.124:1026"
Device ID's which can be used are: c168ac00020304f1, c168ac00020304f2, c168ac00020304f3, c168ac00020304f4, c168ac00020304f5
If you leave the Id Pattern empty, all devices will be used.