Step 1 - Customise Download Script
Astun supply a python script to download the CMIS data GetCMISPeople.py
which connects to the CMIS SOAP web service in order to download Councillor information including their Contact details, Ward and image into a CSV file councillors.csv
.
The script must be modified to specify the URL for the CMIS SOAP web service and details of any Proxy.
- Open the GetCMISPeople.py, which you will find in the ...Studio\config folder for your iShare installation, in a Text Editor such as Notepad++.
# The following 2 lines will need to be adjusted to suit the cmis environment # 1. Change url = to suit # 2. Proxy address and port may need to be adjusted, use `proxy=None` if no proxy is required url = "https://cmis.mycouncil.gov.uk/CMIS/DesktopModules/IWebCSharp/WebService.asmx?wsdl" proxy = dict(https='proxy2.mycouncil.gov.uk:3128', http='proxy.mycouncil.gov.uk:80')
- Edit the url and proxy details and Save you changes.
- In the tree, right click on the Build Councillors (CMIS) Job you have just created and select New Task.
- Select the Program type and click OK.
Task Details
Enter the following:
Name
Enter a Name for the task e.g. Fetch CMIS Councillors.
Program
Browse to the python executable e.g. c:\python27\python.exe
Additional Parameters
Here you need to enter the link to the python script to download the CMIS data e.g.
D:\Astun\iShare\Studio\config\GetCMISPeople.py
Step 3 - Create Task to Import CMIS Councillors
The Python script creates a CSV file Councillors.csv
in the ...Studio\config folder, this can then be imported via a Spatial Data Transformation Workflow Task.
- Right click on the Build Councillors (CMIS) Job you have just created and select New Task.
- Select the Spatial Data Transformation type and click OK.
Task Details
Enter the following:
Name
Enter a Name for the task e.g. CMIS Import councillors.csv
Source Data
Select Comma-Delimited Text File
Filename
Enter the path to the generated councillors.csv file e.g. D:\Astun\iShareGIS\5.4\Studio\config\councillors.csv
Output
Select your Data Share database from the list e.g. iShareData
Table
Enter the name of the table that you wish to be created in the Data Share database e.g. councillors
Force Geometry
Tick the Force Geometry box and select NONE from the list.
Show expert mode
Tick the Show expert mode and then enter the following in the Additional Parameters
--config PG_LIST_ALL_TABLES YES
The use of --config PG_LIST_ALL_TABLES YES
ensures that the ogr2ogr
command finds the existing councillors
table in order to overwrite it if the Task is ran more than once
Step 4 - Create Task to add HTML column
Once the data is imported into the Data Share database a Stored Procedure Task is used to create a new table with an additional html
column which will be displayed in My House. The select statement
will need to be updated to specify the appropriate URL for the organisations public CMIS website.
- Right click on the Build Councillors (CMIS) Job you have just created and select New Task.
- Select the Stored Procedure type and click OK.
Task Details
Enter the following:
Name
Enter a Name for the task e.g. CMIS - Create councillor_ward
Connection details
Select the Data Share database from the list.
Function
Select at_sys_create_table entry from the list.
select c.ogc_fid, w.wkb_geometry, c.forename1, c.surname, c.wardname, c.html from wards w left join councillors_html c on (lower(trim(w.ward_name)) = lower(trim(c.wardname)))