From 597de6008978082ebd6daf83a98c72a38231762c Mon Sep 17 00:00:00 2001 From: spwoodcock Date: Tue, 23 Jul 2024 23:23:30 +0100 Subject: [PATCH] docs: add xlsform design page to docs manuals section --- .../xlsform-design/entities_registration.xls | Bin 0 -> 28672 bytes .../images/xlsform-design/entity-features.csv | 2 + .../odk-collect-entity-creation.png | Bin 0 -> 63811 bytes .../xlsform-design/xlsform-choices-sheet.png | Bin 0 -> 22740 bytes .../xlsform-design/xlsform-entities-sheet.png | Bin 0 -> 6989 bytes .../xlsform-entity-features.png | Bin 0 -> 9490 bytes .../xlsform-entity-registration.png | Bin 0 -> 15505 bytes .../xlsform-design/xlsform-settings-sheet.png | Bin 0 -> 4299 bytes docs/manuals/xlsform-design.md | 151 ++++++++++++++++++ 9 files changed, 153 insertions(+) create mode 100644 docs/images/xlsform-design/entities_registration.xls create mode 100644 docs/images/xlsform-design/entity-features.csv create mode 100644 docs/images/xlsform-design/odk-collect-entity-creation.png create mode 100644 docs/images/xlsform-design/xlsform-choices-sheet.png create mode 100644 docs/images/xlsform-design/xlsform-entities-sheet.png create mode 100644 docs/images/xlsform-design/xlsform-entity-features.png create mode 100644 docs/images/xlsform-design/xlsform-entity-registration.png create mode 100644 docs/images/xlsform-design/xlsform-settings-sheet.png create mode 100644 docs/manuals/xlsform-design.md diff --git a/docs/images/xlsform-design/entities_registration.xls b/docs/images/xlsform-design/entities_registration.xls new file mode 100644 index 0000000000000000000000000000000000000000..4feacd74cadbec60b75191d1f76b368c87b3f8b2 GIT binary patch literal 28672 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 literal 0 HcmV?d00001 diff --git a/docs/images/xlsform-design/xlsform-choices-sheet.png b/docs/images/xlsform-design/xlsform-choices-sheet.png new file mode 100644 index 0000000000000000000000000000000000000000..c7bff06506788c83449c2722e5c9bdbf4188a9ad GIT binary patch literal 22740 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 J$XB<1_&+Edxw`-W literal 0 HcmV?d00001 diff --git a/docs/images/xlsform-design/xlsform-entities-sheet.png b/docs/images/xlsform-design/xlsform-entities-sheet.png new file mode 100644 index 0000000000000000000000000000000000000000..008640900815463a030dd7f087f73e0ddc14c792 GIT binary patch literal 6989 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 lz^mkWF5doMIHYx-UI9(h literal 0 HcmV?d00001 diff --git a/docs/images/xlsform-design/xlsform-entity-features.png b/docs/images/xlsform-design/xlsform-entity-features.png new file mode 100644 index 0000000000000000000000000000000000000000..e52db214d9a4769a0a13a6df6997502ac02aad7a GIT binary patch literal 9490 zcmZ{K2Ut@}(|-`J4TS5ZOH&k)W+>8|sDOxo5D)!* zL_}&JNG|~*C4^o=34sv4fcL)N`~KhWzt5ALJ!f}zc4p_y&d%?=y>Fm%_RRS+007{u z?w#Al001L~UXML>g8tw2Q}+)2!r)`9a}!XE<(sG99Cy;x*8~8Nu}oCkKj`;n zl$nw04MzI0TXjz9^;$f9zxiUh>C^bF2O^lY0!aMqdudGYyjge%lD$QW`Sl?8D_fuY z>|Xxgf}&-9Nom4wv^CaugSJfkO(6py)A4}=wBXhLEp$2*U6A*sKu%cbtQ>uM^fIlH zj6SM-`&h<&Sh;cMm-N!&qU%O}FdPmijW}f_O9QyiDzjiaJCmfZpFf+N(wq0LN5Q~( zo;~oHZV6-g^QSXR)GPJsJ9}T%YRjneeIgsD0oo^#;&(EnTALMfazHZ-SL#`Qp7<08 zT+31~|7m^#Ao#@Wry}8`gPy=MU#~?*6>#!~+OrTCYMIyf#|_48o?9#G#5ajjIV}?XzVnyc0NQS+9x_>1MOOF zI}&Uu)e?rOJq$a28MMpz{T2VNhrmbeJ=13?yY)PYd!$V-E6&b`=|LH=tCKPVC(Me& z+rw?89ucJOgnwaNc97cpD$%|72+-7f0=xZS##~A^n;K$%!jxY`Mc!ma+fw39syfdJ zOF`cWbYiet4d0ld`^r<(ANEii)K!ae%KRcs0Nv>4v3xBc2I&rYP-5ZM8~9; z4DiKC%abo0ey+xp%J0a3oSt}R;;}Q8em;GID%FA%$a=l|v)9x~sW_`Ju6^zmD|$bt zZCN-lVDBz%5`N&3dyK+UFf12(%gTb~0T6Ggj0?Vkf4wT955#!KHry3R@&C#>Xc|Fj zsLS6xi2QTnR#W!SbNVvKtcWr#hSx^sp5y(c6Z&+%s?2Tis;e(74h@AbsKlWui|7x$ z&``6P@sgSFWX2hXq$fiI=BC+IQeRt1P_3R+eDR9jjq#5?dQMCljtcJTHxX&^DgRehTYpI{gyP(BJ%S;{ZQ%<#DJ zpMo`Bu-4*!x{Ijt2j!;PS{*os!v$jrPoH($vhiAM_40p5gQd(BZBX_r5_$7S!YPo? zEeUpj(9|5smQn3;KScr#kx0 z4RA(-a}t+q&>u<;w!-W7h7KeT99HwNYxuNvyRbQ?>hlG|If4U;o?BgSp3hr_-NQtW zD3DOG_~Xo=5o>e0+meI9;ByB274R3y_A`@=Kl_;DbovJyDWC-hzfSDi&h5QcD zSQ(P9MX-2fYV70S&8%UC8LkSOWbnt}@K~z`|Ge~2aaK%ts7ZMqB@@a~L%rW%%0D|B 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 Z7-jA_oHhSC_Ue#MSIgjb@y*9C{s)@;1?>O; literal 0 HcmV?d00001 diff --git a/docs/images/xlsform-design/xlsform-entity-registration.png b/docs/images/xlsform-design/xlsform-entity-registration.png new file mode 100644 index 0000000000000000000000000000000000000000..0e30e20b9369f822c69edafa8b48765801d0ac54 GIT binary patch literal 15505 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 b`*1ZucWuRM_7QlD_=%L5Jh(!{FyQ|I?$ovD literal 0 HcmV?d00001 diff --git a/docs/images/xlsform-design/xlsform-settings-sheet.png b/docs/images/xlsform-design/xlsform-settings-sheet.png new file mode 100644 index 0000000000000000000000000000000000000000..7eb7148d0cda89297facc1e8fad3d7af8c2203f5 GIT binary patch literal 4299 zcmZu!byyQz)E^=tp@cL@iNvVUodTl~7`y`oUX&P()MyZ-LlAIChXc0JDK%e7K}re9 ziGa8vATc_=`F;O>f82ZSiRa$)Joh>0_dCfJW(M>$oHPIcfZh=N&=LS3LzB*y)Rd&1 zaDGlr5@Z3E20DPcac(?Gx#^~Dsto`%X3}2#OF`0a`GKJU0Ko0Ozl&_hxB3|Xz~E%~ zP}>^ruwA6?wW!ZE#EZ2W3icr5ucJikuD0s%krg+6b71P9`B7#J^v$DHDpq63F9c+D z&-0|*cDPG5?tIH#kz9smtS(_V?yZ&XEX%KVY7f1KztPzg>P3w7%RI zuCX(0FHp{COv*&d`LyKhZ%RzGIV=D`O#f3F@|ES~8X=O&sW;+cZ^#2iS)2=!l@8Yz z3^aUkc;l3Uvk{2KUSHWu#D>Ns@>FsROHC#{fkvME(f(`Mr-D)L)5?xS- zTwbNZ+e0n-p>nH&X=T^N>y+%&*t5}3^;1X3U56s+I@wNqSY5(BY-t5h$jfB>HlmP4 zR=}+>jdJ>KZmzYxexGCzW$1`iVyAAaq{|1H^vsLkxbcYzsK=!CsYKCCMh&_x)_u71 zA~@4C@UYE<-gG>#{@1So3afwT1({qnDyx-X8OnFMcsMbT>L#^PGow}(=c{Hug8}D! z4tYKg83}A3t%t)#{!pD>5TbDV-sHmfGzXVSF`8P;(p?teo;=0?tSY%(mt*CROL@+~ z&YBk2@6fRu4}kTEe_vzYj9B<*e`>k7jhl+e6Ln)k32e(qdA3(yxh7eRj2J)ixAf#l zX86ttdNQ!SrqS&Bg@Y#EjfFR^nbX_byV1I$0_e=@$2cP9+$4_eTeTNp*HWQ5aCxDgA<&5$W>xOER8;E2eGAeR9Fzc;SX7n(}I;nwGR_ zkq_GmO>gyn@D$)_DL%?jz#e?vFX%D|4fC8beWEg6O~ng_Qjp$|v(p#2iIB2iaT%WK zi8#}V{eyAsYZx`~$zp#+UM~1`AJ|PKE9&X6(3gqcL>bzidWWTvv5uQmR4d_|)1FaF zJGKSqZC3v?UL|>#dO}QNkX*d2I(WKlV_W}$0c^lb!Kto zwYo*is?CzSN6Q+0No0#W!&eb_5%MC@uUz@C^MfZ8so#VhFAgR&@y!z&R@Wae+NW`H zw2$Q}Y+;1>0)?nC%tLtGT5gl5_t^nvWFD zz$yYHiDaq~QV-Gk5!-YF0C)wz0HRkZwtct1>RI;62QHTGf64w8vj(fGofW3PR2iM_ zfNWt}LZ%~sTUh#%-|RQhh83b195 z7^SQHC~Cev!xUA+r(>~8tCh0AA#qaElD_>rH{k2Gi%ZNH#b}cXtJKYyLD6T-tqfnl8ZPTbn(biI* zfjF#|X7J(r#oB_L{Nzr*Y>vLOMmo+vS#$9boX?)>{5*_o8i?3X)Z3=3fIv1u zH0$x)XUh{q%^>n;Q8E(a?jMe17nmi(lf??Y;GWd*Ffl8XZ>fj5%1{~gk2v<18WeGI z^sHH4y5S|+dY^?GqH39clo4{JY&K{*%M{I!No?D5BX(Sl!b!2Yrl=&EZsgB*O^H$k z<=3&O#HI{isTx=ohh4OYOTx?-PsM!v@%nrAD)S--tY?`Ez9(C21GX4(o&Hzunx@Kr`VbAN{GEeAz>Q?2-b zWl^!aU}qqD)`^TO`+QgmNvFCNX>TbdV}`F8`-W>77WNaCC9)IdlM)ARkrVRj_#$!}uY-O+=%X3j}yx`Z!}m94kg?WHf!>IHNI1tchSY;Nr4?)xfFnBV*7!-eDBCcDNJ+VcVUa8vl;cN=OFbWnPYi~w z8_$A}dK$5+pK1-3o%Y!`Hhr-S6Z$4jDX%D~ti)sfw`n}q_7FE?_nZB-E7kGtv||(y zLqWEkb~|UL<(F?lmrz6xsp4<6$f{V_kcyruvu1)Y#2an>7k)oPobGh(PBT&dBd+$V zl#+y;1>W$ILduUZe;H_% z+jR}~Hdk4h^UbG_@4sBktylF4E!dhy6cXl!4~c}r`n;BlzPwsNW*qvhUUo)-xrL;6PWKIh}hZ&ALvJSd*UDwXX=+9i%}Cz99O)bVh~=8`$Mq*Cyco=;-!TBos&dMV!*+DVFI&z zx|enoR72z_Xnnu3Erg>)?*< z;XUX4Uh~g$HaBczVeTdC{^Guy2P$)rk}#74jw)5g0OhgBL1&~10n)h=?kc9J(dgQ$ z(MvU@uLN(4Qu9wI3SSg@?1+t3z}&ZA&nhT~e_m@FSsFJqw=vdUP|BNAToM79q#&rt z1)^@;ZeX`;?^CM{|B4d3dK?69wySK_$4sW@4v3W15#Kp95!M>D%iM(%-tAmN5Z_$GXB7;ZCT*8kZaj3hl+)Gz?omzp?k*y?nPr{?o zLxhzme;gY-}DsqH1Jrr&F`<$7ZpAquRk_HY{w^y@X&YxPm-AljF@x-7xAxZM<;F=}rb zk{Ot45WgD|_*_;nQ%^^O{lk3ZM?u{93pwl>aWU5sJ2Z>ny;rqXCF;mi656~} z)$mG4o8Y~0mEYj9Ma7X$&8BgP0W!XmX4dPSDpRYnQmr>?w5;e8v!a_=P$=$T{)`5R zxZ6vG+%V4nmQ%z59Y^jfeloTkQG&w7fKMLDe-sl-NLl2nEm$0V5bjiD;R7d@c_HLh z&j-Es+CtL%DYYv5A;|of~+*vbfPnYT)b8((y z!FegME&Fc$A=fLRw8-BfepsK~uw&hCO)OjR>Hp*yUewEm%a*UozeIL7sMb>%z28r8 z(A7YHYCO}Mu6(u&fnid0a8AV?LJ@2%zyfR0{LxPkP>MoYXoFeM@A*NHTH3x|LUhoR z%C0U|<1?4TzBsB1DrS7*loa#%Le(27N149=w9u%{A*&iY9#E=Jzj!)h^Uk+@cmWvF zIPehdF<)iPOPo>22<=j7=Mm662tE#I*EcyFThtRvN66=aDdS@8ew@6&x=P}}ta<;t zgF{9v`;Qg~9!OD0dhKoV`(FPYeRl~(~Y98Rnx$B!Ll^*J}n+nTlNBoo739JzSsQ1=8%zi1;4T-8cNGIsx|#dIVN zoMXfS<2C+Lf7yZdrtJ0V6L`VCEtYZm@8}I(EyE-PHe&VsDoFvKneVvdRxHU(L9D{t zJ;2MhZgT&0nd|NGl6*X|*P({Xz7KSR?+g#Z8m literal 0 HcmV?d00001 diff --git a/docs/manuals/xlsform-design.md b/docs/manuals/xlsform-design.md new file mode 100644 index 0000000000..7c10f55c63 --- /dev/null +++ b/docs/manuals/xlsform-design.md @@ -0,0 +1,151 @@ +# XLSForm Design (For People In A Hurry) + +Adapted and updated from +[this document](https://hotosm.github.io/osm-fieldwork/about/xlsforms/) +in osm-fieldwork. + +The full specification for XLSForms can be found [here](https://xlsform.org/en/). + +## XLSForm & ODK Terms + +A few terms should be explained: + +- **XLSForm**: a spreadsheet containing your survey questions. + - Simply a `.xls` or `.xlsx` file. + - Can be created with any tool like Microsoft Excel, LibreOffice Calc. + - Include text and a small amount of spreadsheet logic to generate values. +- **XForm**: an XLSForm that is converted to XML format read by ODK tools. +- **ODK Central**: the server where XForms are stored, plus related submissions. +- **ODK Collect**: the mobile app to load the XForm to make submissions from. +- **XForm ID**: the ID reference of the XForm in ODK. +- **XForm Title**: the friendly name of the survey form that the user sees. +- **Entity**: a fancy term for map `features`, or commonly for our use case, + `buildings`. Each Entity is a feature to be mapped. +- **Entity List**: a collection of Entities stored on ODK Central. +- **Choices List**: a group of pre-defined options / answers to a survey + question. + +## XLSForm Sheets (Tabs) + +- There are four options for sheet (or tab) names: + - `settings` - metadata like XForm ID & XForm Title. + - `survey` - the actual question data to ask the user. + - `choices` - different options to select are stored. + - `entities` - metadata about the related Entity list for a project. + +### Settings Sheet + +![Settings Sheet](../images/xlsform-design/xlsform-settings-sheet.png) + +- `form_id`: XForm ID above. +- `version`: Can be any value, but it is advised to use a date and time via + spreadsheet formula `=NOW()`. +- `form_title`: XForm Title above. + +### Entities Sheet + +- Entities were introduced to ODK Central recently in order to more easily track + the same feature over time. +- We now have a nice way to store a feature, with geometry and properties, in + ODK Central (for example the buildings you wish to map!). +- The geometry can then be selected in ODK Collect survey questions. + +![Entities Sheet](../images/xlsform-design/xlsform-entities-sheet.png) + +- `list_name`: The Entity List name in ODK. +- `entity_id`: A reference to a field in your survey sheet, such as building ID. +- `update_if`: If set `true()`, the Entity will be updated on form submission, + else no update will take place. +- `label`: A descriptive user-facing name for the Entity. This can include logic + to add text or symbols based on a field in the survey sheet (for example, + mapping status). + +### Choices Sheet + +- Contains options that can be used to answer a survey question. +- These are used instead of 'free text' input for consistent answers. + +![Entities Sheet](../images/xlsform-design/xlsform-entities-sheet.png) + +- `list_name`: The Choices List name that can be referenced in the survey. +- `name`: The value that can be selected as the question answer. +- `label`: A description of the choice, displayed in ODK Collect. + +### Survey Sheet + +- The main part of the form - the questions for the survey! + +## Translations + +- Fields for translations... + +## Creating Entities + +- For the XLSForm to reference an Entity List for data collection, the Entity + List must first exist in ODK Central. +- There are two ways described below. + +### From The ODK Central UI + +- Easiest approach via the user interface of ODK Collect. +- First we generate the Entity List via the UI, with all the fields we + want included: + +![Entities Create UI](../images/xlsform-design/odk-collect-entity-creation.png) + +> A single field `geometry` would be acceptable, but it can be useful to add +> other fields as references, for example including a mapping `status` field. + +- Next we need to generate a `.csv` containing our geometries we want to map, + including the fields we defined above. +- The `geometry` field must be in JavaRosa geometry format. +- Example JavaRosa polygon (semicolon separated): + +```java +-8.38071535576881 115.640801902838 0.0 0.0; +-8.38074220774489 115.640848633963 0.0 0.0; +-8.38080128208577 115.640815355738 0.0 0.0; +-8.38077407987063 115.640767444534 0.0 0.0; +-8.38071535576881 115.640801902838 0.0 0.0 +``` + +![Entities Features](../images/xlsform-design/xlsform-entity-features.png) + +The example CSV can be downloaded +[here](../images/xlsform-design/entity-features.csv) + +- Now this CSV can be uploaded via the UI and the Entity List will be populated. + + +
+ Other Options + + +### Via Entity List XLSForm Upload + +- This is quite a convoluted approach, as a **separate** XLSForm must be + uploaded to do this. +- An example Entity registration form can be found + [here](../images/xlsform-design/entities_registration.xls). +- In the end, we will have two XLSForms. One for Entity List creation, + and another for the actual data collection. +- The key part of this form is in the `survey` sheet, where the Entity data + fields are defined: + +![Entity Reg](../images/xlsform-design/xlsform-entity-registration.png) + +- We will cover in the [Survey Sheet](#survey-sheet) section more details of + the specifics here, but as you can see we have: + - A field type to help determine which kind of data we have. + - A field name that should match those defined in the features CSV file. + - A field label to display to the user. + - A `save_to` field to specify which Entity field / property the data will be + saved to when submitted. This should probably match the field name. + +### From Code (API) + +- + + +
+