admin:generate_ckan_reports
Differences
This shows you the differences between two versions of the page.
|
admin:generate_ckan_reports [2018/02/16 14:22] acorbi [Configuring the reporting parameters] |
admin:generate_ckan_reports [2020/06/23 15:05] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Generating CKAN reports ====== | ||
| - | |||
| - | ===== Who is this guide for ===== | ||
| - | |||
| - | * Monitoring and evaluation officer who produces data for reporting | ||
| - | * Editor and data officer who assist with reporting | ||
| - | * Program development officer who uses site analytics data for presentation and fundraising purposes | ||
| - | |||
| - | ===== What this guide teaches ===== | ||
| - | |||
| - | * How to run a python script which gathers reporting data from the contents stored on the ckan instance | ||
| - | * How to to clone a github repository | ||
| - | * How to install python runtime on any platform | ||
| - | |||
| - | ===== Things to know beforehand ===== | ||
| - | |||
| - | * This task requires some basic programming knowledge | ||
| - | * How to edit a python source code file | ||
| - | * How to execute a python script | ||
| - | * In order to complete this task, you will need access to the password repostory on [[https://ratticdb.proteus-tech.com:7078/|the rattic db instance maintained by Proteus]] | ||
| - | |||
| - | ==== Installing python runtime on your machine ==== | ||
| - | |||
| - | You can download and install the latest version of python from [[https://www.python.org/downloads/|the official python site]] | ||
| - | |||
| - | ==== Cloning or downloading the library of scripts from the data_workstream repostory ==== | ||
| - | |||
| - | Within [[http://github.com/OpenDevelopmentMekong/data_workstream/|the data_workstream repository]] on the OpenDevelopmentMekong github organization, many different utility scripts and other pieces of code can be found and used for several purposes. | ||
| - | |||
| - | There are two ways to download them: | ||
| - | |||
| - | - Download the zip file from [[https://github.com/OpenDevelopmentMekong/data_workstream/archive/master.zip|the following link]]. After downloading the .zip file, please extract it to the folder of your choice. | ||
| - | - Clone the code repository using your favourite git client (advanced) | ||
| - | |||
| - | ==== Configuring the reporting parameters ==== | ||
| - | |||
| - | The following parameters can be configured: | ||
| - | |||
| - | - DATE_FROM: The initial date of the timeframe to get the reports about (e.g: 2017-06-01) | ||
| - | - DATE_TO: The final date of the timeframe to get the reports about (e.g: 2017-12-31) | ||
| - | - PRIVATE: Whether to gather private or public records (e.g: True) | ||
| - | - FILE_NAME: The filename to store the results of the script. | ||
| - | |||
| - | In order to configure this parameters, the file **datasets_by_taxonomy.sh** needs to be opened with a text or code editor. The variables can be found on lines 5-8. | ||
| - | |||
| - | {{ :admin:screenshot_from_2018-02-16_15-18-52.png?nolink&600 |}} | ||
| - | |||
| - | These parameters need to be adapted prior to the execution of the script to make sure that the results contained the wished data. | ||
| - | |||
admin/generate_ckan_reports.txt · Last modified: 2020/06/23 15:05 (external edit)
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
