|
|
# WELCOME TO COLLECTIVA
|
|
|
[![N|Solid](https://cldup.com/dTxpPi9lDf.thumb.png)](https://nodesource.com/products/nsolid)
|
|
|
|
|
|
Collectiva adalah aplikasi mobile berbasis android untuk pengumpulan data pada survei kompleks / official statistik. Collectiva dikembangkan dari aplikasi open source Open Data Kit (ODK) [Collect](https://opendatakit.org/use/collect/).
|
|
|
|
|
|
## Features
|
|
|
Berikut beberapa kelebihan / keutamaan yang dimiliki oleh Collectiva dan tidak ada pada aplikasi CAPI lainnya:
|
|
|
- Support Login Page / Authentication
|
|
|
- Support Multiple Survei
|
|
|
- Support TableView on repeat question
|
|
|
- Navigasi Pertanyaan by Group
|
|
|
- Log Error
|
|
|
- Searching Question
|
|
|
- Dynamic Summary Response
|
|
|
- Multiple Constraint type
|
|
|
- Great User Interface (based on Google Material Design Guidelines)
|
|
|
|
|
|
## Quick Start
|
|
|
1. [Instalasi Aplikasi](www.google.com)
|
|
|
2. [Hubungkan ke server](www.google.com)
|
|
|
3. [Cara menggunakan aplikasi ini]()
|
|
|
|
|
|
# Instalasi Collectiva
|
|
|
Untuk menggunakan aplikasi ini, anda diharuskan menginstallnya pada smartphone berbasis android. apabila anda tidak mempunyai smartphone android dan ingin menggunakan emulator, silahkan baca instruksi [berikut](https://github.com/opendatakit/opendatakit/wiki/DevEnv-Setup).
|
|
|
#### 1. Cara install dari file
|
|
|
Silahkan download file collectiva.apk, kemudian install pada smartphone anda. Perlu diingat bahwa smartphone anda harus memiliki *operating system (OS)* minimum Ice Cream Sandwitch.
|
|
|
#### 2. Cara Install dari Android Studio
|
|
|
- pastikan anda telah menginstall Android Studio, jika belum silahkan download dan install Android Studio terlebih dahulu.
|
|
|
- download file project collectiva
|
|
|
- Extract file collectiva.zip
|
|
|
- Import project Collectiva ke android studio *File > New > Import Project*
|
|
|
- Pilih folder project Collectiva dimana anda meng-extract-nya
|
|
|
- Tunggu sampai Android Studio melakukan *sync gradle*, pastikan ikuti semua permintaan Android Studio hingga tidak ada masalah.
|
|
|
- Run Aplikasi Collectiva.
|
|
|
|
|
|
Setelah anda selesai menginstall aplikasi mobile Collectiva, anda harus menghubungkan ke server untuk mulai menggunakannya.
|
|
|
|
|
|
# Hubungkan ke Server
|
|
|
Secara garis besar CAPI-STIS membutuhkan beberapa komponen server sebagai berikut :
|
|
|
1. **Builder**, digunakan untuk membuat kuesioner digital
|
|
|
2. **Agregate**, digunakan untuk menyimpan dan memonitoring data secara keseluruhan di server
|
|
|
3. **Survey Management**, digunakan untuk mengatur survei yang ada, alokasi pencacahan, serta alokasi kuesioner. Server ini akan diperlukan apabila fitur Login Authentication, multi-survey digunakan di proyek anda.
|
|
|
|
|
|
#### Untuk penggunaan dasar
|
|
|
Cara menghubungkan server pada penggunaan dasar pengumpulan data, tanpa login, tanpa menggunakan multi-survei. Pada penggunaan ini, Collectiva hanya memerlukan server Agregate saja.
|
|
|
1. **Siapkan Server Agregate**, Anda bisa menggunakan Server Agregate CAPI-STIS, Server Agregate ODK, atau server Agregate Kobotoolbox. Silahkan ikuti petunjuk instalasi / penggunaan masing-masing server, silahkan pilih salah satu sebagai contoh awal anda. Petunjuk instalasi / penggunaan : [Agregate CAPI-STIS](), [Agregate ODK](https://opendatakit.org/use/), [Agregate kobotoolbox](http://www.kobotoolbox.org/#block-block-9).
|
|
|
Untuk kenyamanan penggunaan saat pertama kali, kami menyarankan anda menggunakan Server Agregate CAPI-STIS, atau Agregate Kobotoolbox.
|
|
|
2. **Siapkan Kuesioner Digital**, Jika anda belum mempunyai kuesioner digital untuk memulai menggunakan aplikasi, anda bisa menggunakan file [sampel_kuesioner.xml]() ini sebagai contoh, atau anda bisa membuat sendiri kuesioner digital pada salah satu tools berikut : [CAPI-STIS Builder](), [ODK Builder](), [KoboForm](), atau membuat sendiri dengan Ms. Excel.
|
|
|
3. **Deploy Survey**, Jika sudah mempunyai kuesioner digital, silahkan deploy kuesioner digital tersebut pada server agregate anda. Silahkan lihat kembali cara instalasi dan penggunaan agregate server yang anda gunakan.
|
|
|
4. **Arahkan server di Collectiva**, Buka aplikasi Collectiva, buka menu *preferences > Platform settings > URL*, ganti url dengan alamat dimana anda menginstall server agregate.
|
|
|
|
|
|
|
|
|
#### Penggunaan Multiple Survei & Support Login [OPTIONAL]
|
|
|
Pada penggunaan ini, Collectiva membutuhkan server survey management yang berfungsi untuk melakukan pemetaan pengguna dengan survei, melakukan manajemen survei, pemetaan kuesioner, dan lain-lain. Anda bisa mengetahui instalasi dan penggunaanya di [halaman survey mangement server CAPI-STIS]().
|
|
|
Ada beberapa langkah yang perlu dilakukan sebelum menggunakan Collectiva untuk multiple survei, dan support login
|
|
|
##### 1. Set up in collectiva
|
|
|
Buka source code collectiva dengan android studio, buka class `activity/SplashScreenActivity.class`. Pada method `endSplashScreen()`, pastikan potongan kode method `startDefaultSimpleUsage()` dalam keadaan tidak aktf, dan diganti dengan method `startSupportLoginAndMultiSurvei("yourserveraddress")`.
|
|
|
seperti contoh dibawah ini
|
|
|
```sh
|
|
|
private void endSplashScreen(){
|
|
|
//launch new activity and close splash screen
|
|
|
//startDefaultSimpleUsage();
|
|
|
startSupportLoginAndMultiSurvei(“http://server-surveymanagement.com”);
|
|
|
}
|
|
|
```
|
|
|
kemudian, pastikan alamat server yang ditulis pada parameter method `startSupportLoginAndMultiSurvei("http://server-surveymanagement.com")` dengan benar mengarah ke server survei mangemen.
|
|
|
##### 2. Set up server survei manajemen
|
|
|
Anda bisa menggunakan Server Survey Manajemen milik CAPI-STIS, silahkan melihat panduan instalasi dan penggunaannya [disini](https://git.stis.ac.id/faqih/survey_management_CAPI_STIS/wikis/home)
|
|
|
|
|
|
Apabila anda mempunyai server survei manajemen sendiri, anda tetap bisa menggunakannya dengan collectiva, asalkan parameter dan outputnya bisa berkomunikasi dengan Collectiva. Berikut adalah beberapa aturan input / output API yang harus dimiliki pada server survei manajemen anda sendiri.
|
|
|
`Service login (POST):`
|
|
|
```sh
|
|
|
- username : string
|
|
|
- password : string hash md5
|
|
|
- requestType : "login"
|
|
|
```
|
|
|
`Output login JSON if Success`
|
|
|
```sh
|
|
|
{
|
|
|
"code":"1",
|
|
|
"message":"Login Surccess",
|
|
|
"data":{
|
|
|
"token":"aJKDjanskdjSJDKAJSD765ASD",
|
|
|
"name": "Name Of User"
|
|
|
}
|
|
|
}
|
|
|
```
|
|
|
`Service get data multi-survei`
|
|
|
(digunakan ketika user sudah login, atau me-refresh daftar survei dan kuesioner)
|
|
|
```sh
|
|
|
- token : string
|
|
|
- requestType : "get_data"
|
|
|
```
|
|
|
`Output get data multi-survei JSON`
|
|
|
```sh
|
|
|
{
|
|
|
"surveys": [
|
|
|
{
|
|
|
"id_survey": "susenas2016a".
|
|
|
"label_survey":"SUSENAS 2016",
|
|
|
"icon_servey":"https://www.survey.com/susenas/images20x20.jpg",
|
|
|
"agregate_server":"https://www.survey.com/susenas/",
|
|
|
"user_level":"pcl",
|
|
|
"user_level_label":"PCL",
|
|
|
"forms":[
|
|
|
{
|
|
|
"form_id":"vsen2016",
|
|
|
"form_name":"VSEN 2016 SUSENAS",
|
|
|
"form_url":"https://www.survey.com/susenas/forms/vsen2016.xml"
|
|
|
}
|
|
|
]
|
|
|
}
|
|
|
]
|
|
|
}
|
|
|
```
|
|
|
`If error request happened`
|
|
|
```sh
|
|
|
{
|
|
|
"code":"1",
|
|
|
"message":"Failed to get data, internal server error"
|
|
|
}
|
|
|
```
|
|
|
Apabila server anda sudah mampu menyediakan API diatas, maka anda bisa menggunakan server anda sebagai server managemen survei. Anda hanya tinggal memasukkan alamat server anda seperti pada poin nomer 1 (*Set up in* collectiva), dan Collectiva sudah siap digunakan. |
|
|
\ No newline at end of file |