Skip to content

Changes

Page history
Update hubungkan ke server authored by Muhamad Tohir's avatar Muhamad Tohir
Hide whitespace changes
Inline Side-by-side
hubungkan-ke-server.md
View page @ 09e950b1
# 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.
1. **Agregate**, digunakan untuk menyimpan dan memonitoring data secara keseluruhan di server
2. **Builder**, digunakan untuk membuat kuesioner digital
3. **Survey Management**, digunakan untuk mengatur survei yang ada, alokasi pencacahan, alokasi kuesioner, *authentication*, alokasi petugas , dan lain-lain. Jika dirasa anda tidak membutuhkan fitur dari server manajemen survei ini, anda boleh tidak menggunakannya / mengaktifkannya.
## Siapkan Server Agregate
Anda bisa menggunakan Server [Agregate CAPI-STIS](https://git.stis.ac.id/faqih/survey_management_CAPI_STIS/wikis/home), Server [Agregate ODK](https://opendatakit.org/use/aggregate/), atau server [Agregate Kobotoolbox](http://www.kobotoolbox.org/#block-block-9). Silahkan ikuti petunjuk instalasi / penggunaan masing-masing server.
> Setelah server anda siap digunakan, Atur server Collectiva menuju server agregate yang anda gunakan. Buka aplikasi Collectiva, buka menu `preferences > Platform settings > URL`, ganti url dengan alamat dimana anda menginstall server agregate.
## Siapkan Kuesioner Digital
Jika anda belum mempunyai kuesioner digital untuk memulai menggunakan aplikasi, anda bisa menggunakan file contoh kuesioner digital [berikut]() sebagai contoh, atau anda bisa membuat sendiri kuesioner digital pada salah satu tools berikut : [CAPI-STIS Builder](https://git.stis.ac.id/faqih/survey_management_CAPI_STIS/wikis/home), [ODK Builder](https://build.opendatakit.org/), [KoboForm](http://www.kobotoolbox.org/koboform/), atau membuat sendiri dengan Ms. Excel.
> Setelah file kuesioner digital anda telah dibuat (biasanya dalam bentuk `.xml`), silahkan deploy ke server agregate yang anda pilih. Dokumentasi lebih lanjut terdapat pada laman masing masing penyedia server.
#### 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.
## Server Survey Management
Apabila survey anda membutuhkan manajemen survei yang lebih, seperti alokasi petugas, multi-survei, alokasi kuesioner, dll, maka anda harus menghubungkan Collectiva dengan server *Survey Management* ini. Anda bisa mengetahui instalasi dan penggunaanya di [halaman survey mangement server CAPI-STIS.](https://git.stis.ac.id/faqih/survey_management_CAPI_STIS/wikis/home)
#### 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
> Ada beberapa langkah yang perlu dilakukan untuk menghubungkan Collectiva dengan server *Survey Management*:
### 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
......@@ -28,17 +28,20 @@ private void endSplashScreen(){
}
```
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.
### 2. Set up server *Survey Mangement*
Anda bisa menggunakan Server *Survey Management* 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`
###### Output login JSON if Success
```sh
{
"code":"1",
......@@ -49,13 +52,13 @@ Apabila anda mempunyai server survei manajemen sendiri, anda tetap bisa mengguna
}
}
```
`Service get data multi-survei`
###### 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`
###### Output get data multi-survei JSON
```sh
{
"surveys": [
......@@ -77,11 +80,11 @@ Apabila anda mempunyai server survei manajemen sendiri, anda tetap bisa mengguna
]
}
```
`If error request happened`
###### 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.
Apabila server anda sudah mampu menyediakan API diatas, maka anda bisa menggunakan server anda sebagai server managemen survei.