SUMMARY
This script is to be used for presenting how to create, upload and share content on Cadasta’s Platform, based on ESRI’s ArcGIS Online product.
ASSUMPTIONS
1. Trainees have an understanding on how to log in to Cadasta’s Platform and know the different content types on the platform.
2. Trainees have a copy of the sample shapefile downloaded on their desktops and have the Partner – Project Manager role in their user accounts.
3. You, the trainer, have slides that show:
- How content can be created in the platform: collected in the field; created online; or uploaded.
- Supported file types: Comma-separated values (CSV) file (.csv); GeoJSON file (.geojson or .json); Keyhole markup language (KML) file (.kml, .kmz); Microsoft Excel spreadsheet (.xls or .xlsx); Photos with locations (.zip); Shapefile (.zip); Tile package (.tpk or .tpkx).
- How to share content to everyone, the organization, groups, and no one.
DEMO STEPS
1. Show a slide that explains how content on the Platform can be created by collecting it in the field with mobile devices, adding from online resources, or uploading from your workstation.
2. Explain that this demonstration will focus on how to upload data from your workstation since this is the most common task when creating content that is not collected through mobile apps.
3. Show a slide that lists the supported file types and explain that a common use case for adding content to the Platform would be when you already have data collected in previous projects or from your archives.
4. Explain that in most cases, data will be in a text file or an Excel spreadsheet and that in some cases it will be in a KML or shapefile.
5. Explain that there are many formats that can be uploaded but the common and most useful ones are listed on the slide.
6. Explain that you will now show how to upload the sample shapefile, which they received at the beginning of their training. Note that the location of this file on your desktop may be different than the location on other people’s desktop.
7. Explain that the files need to be compressed into a zip file before they can be uploaded to the Platform.
8. Show the Cadasta Platform home page (https://cadasta.maps.arcgis.com/home/index.html).
9. Press the Content tab. Explain that to create content, you first need to open the Content page.
10. Press the Add Item button and then select the From your computer option.
11. Click the Choose File button and navigate to the location of the compressed sample shapefile on your desktop and select it.
12. In the Add an item from your computer window, press the Contents drop-down and show that it has different file formats that are supported by the Platform.
13. Explain that the Platform will try to automatically determine which file format is in the compressed file but it is always a good idea to verify that the correct format was chosen.
14. Explain that in this demo, the Platform has correctly identified the contents included as a shapefile so no further action is needed.
15. Explain that data uploaded to the platform is by default saved in its original form.
16. Show the Publish this file as a hosted layer checkbox and explain that you should always publish the data as a hosted feature layer if you want to make use of the data in other items such as web maps, web apps, dashboards, etc.
17. Explain that you can rename the data item. You must also add some tags before the data can be uploaded and published.
18. Rename the data item to Bangladesh Training Demo [your name]. Replace [your name] with your first and last name. Explain that this new name is just an example.
19. Add the demo tag and explain that it is important to try and add tags which will help find this item quickly in the future.
20. Press the Add Item button and explain that the Platform is now uploading and publishing the data.
21. In the new window that opens, show that a new feature layer has been created and its new name is Bangladesh Training Demo [your name].
22. Copy the url of the new feature layer and explain that we will use this url later on in this session.
23. Explain that after data has been published, it is always recommended to review the data table and view the data on a web map if the data includes any geometry.
24. Press the Data tab and explain that this specific dataset has only one record and that this record has been correctly published.
25. Explain that you will now review the geometry of this dataset by pressing the Visualization tab.
26. Explain that this dataset included only one polygon and that the platform was able to upload the geometry correctly.
27. Press the Overview tab and explain that after data has been uploaded and published it is only visible by you and that in order to allow other people to view it it must be shared.
28. Show a slide which shows the difference between sharing to everyone, the organization, a user group, and not sharing with anyone.
29. Press the Share button on the right of the screen and then press the Edit group sharing button.
30. In the search bar, search for Demo and select the Demo Group – Project Managers group.
31. Explain that only users which have the Partner – Project Manager role can share content to groups.
32. Explain that Cadasta trainers and support staff also have permissions to share content to the entire organization and publicly. If this is desired, please reach out to Cadasta staff or trainers for assistance.
33. Open an incognito browser and enter the url for the feature layer.
34. Explain that by default, anyone wishing to view this layer needs to have a user account on the Platform and be part of the group which the layer was shared to.
35. Explain that if data is shared to the entire organization then the user does not have to be part of that group.
36. Explain that if the layer is shared publicly than anyone with the link to the url can view it.