10903 sub contact routing by jkuester · Pull Request #10 · benkags/cht-core

jkuester · 2026-05-15T20:50:40Z

All these changes have been made just with the report functionality in mind. I have not tested any support yet for contacts. 😓

Also, if you are not super happy with this approach, also check out just the changes in the first commit. That was a more ambitious refactoring that tried to bring the type=binary functionality to be closer to type=file.

License

The software is provided under AGPL-3.0. Contributions to this project are accepted under the same license.

jkuester · 2026-05-15T20:51:51Z

I just reset this file to master since the original behavior of clearing the binary fields should work fine.

jkuester · 2026-05-15T21:09:57Z

+        const xpath = Xpath
+          .getElementXPath($element[0])
+          .slice(ownerXpath.length + 1);
+        const formPrefix = ownerDoc.form ? `${ownerDoc.form}/` : '';
+        const filename = `${USER_BINARY_FILE_PREFIX}${formPrefix}${xpath}`;


I spent an obscenely long time working on a naming approach here that uses a hash of the actual base64 contents and then had the attachment name set in the doc property value (similar to the type=file attachments).

It worked, but ultimately had very few benefits over this current strategy. 😓 The worst was that it ended up requiring bespoke handling code anyway. 😞

I ended circling back to this path-based approach in the end as I think it works with the least amount of code needing to be added. (And we can just fully repurpose the "legacy" pattern for type=binary attachments).

I also had initially started with a guid as attachment name approach but that meant doing a clean up with every edit - quite inefficient. Only note with the updated attachment name logic is we need to confirm attachment retrieval for report view also works across all edge cases: reports existing pre-this feature, sub reports view within main report and sub reports standalone view.

Only note with the updated attachment name logic is we need to confirm attachment retrieval for report view also works across all edge cases: reports existing pre-this feature, sub reports view within main report and sub reports standalone view.

100%! I did test against these cases (including pulling in a report with attachment created on a 4.8.0 instance) and viewing/editing the reports worked as expected. But, it would be really good to have someone else repro this as well. 👍

benkags · 2026-05-16T17:08:50Z

-    // (`user-file/<xpath>`) for inline-binary fields. Required for sub-doc
-    // rendering: the parent-form prefix embedded in the name cannot be
-    // reconstructed from a sub-doc's own field path alone.
-    if (typeof value === 'string' && value.startsWith('user-file/') && isImagePath(value)) {


Just to note here that this logic here also fixed currently broken sub-reports standalone view whose attachment name was derived from the main/parent doc xpath, whose name reconstruction within the sub report fails because of missing parent doc xpath reference.

Hmm, I am not following you here. 🤔 Based on my testing (and it is totally possible I just missed something 😬) the only time I saw the property value getting set to an attachment name with a corresponding user-file/ attachment was for type=file attachments pre-4.9.0. As far as I can tell, we have always cleared the property value for type=binary attachments. And, since 4.9.0 the type=file property values are mapped to user-file- attachments.

…rt forms (medic#10922) Co-authored-by: Bernard K. <kagondubernard81@gmail.com>

…rt forms When a report form contains [db-doc="true"] sub-documents with binary/file fields, attachments are now routed to the owning sub-document instead of always attaching to the main report doc. - Add resolveOwnerDoc() to walk up XML tree to nearest db-doc ancestor - Route FileManager file uploads to correct owner doc - Route inline binary blobs to correct owner doc - Fall back to main report doc when element is not inside a sub-doc

processAllAttachments now walks the parsed XML to determine which prepared doc owns each [type=binary] element (main / sibling / repeat child) and attaches files accordingly, instead of dumping every upload on preparedDocs[0]. Field-value sanitization and orphan cleanup also run per-doc. Adds two private helpers: - resolveContactOwnerDoc: DOM-walk from any element to its section root, then to the owning prepared doc (with mainDoc fallback). - findContactOwnerForFilename: locates the [type=binary] node whose text matches a FileManager filename and resolves its owner. No public API changes; no new service dependencies.

saveContact now uses validateAttachments(preparedDocs.preparedDocs)

New 'attachment routing to sub-contacts' describe block exercising: - file uploaded inside a sibling section -> sibling doc - file uploaded inside a repeat child -> i-th repeat doc - mixed uploads across main / sibling / repeat -> each owner - FileManager file with no matching binary node -> main doc fallback - inline binary (draw widget) inside sibling -> sibling doc - per-doc field-value sanitization (sibling field rewritten, main untouched) - main-doc orphan cleanup on edit path with per-doc loop

- main-doc & sub-doc oversize attachment fails saveContact - normal-sized attachment passes validation

Enketo's setVal rewrites uploaded binary nodes to type="file" the moment a value is set.

add sub-contact attachment routing form fixtures & testes

…peatIndex

… binds on edit

Co-authored-by: Joshua Kuestersteffen <jkuester@kuester7.com>

…t attachments Inline-binary form fields (`<foo type="binary">…base64…</foo>` populated by form `<instance>` defaults, `calculate` expressions, or external `instanceData` injection) previously had attachments stored under `user-file/<xpath>` while the saved field was blanked, requiring downstream binary fields attachment name reconstruction from `label` at render time. That reconstruction was broken for sub-docs, where the parent-form prefix in the attachment name is not derivable from the sub-doc alone. With this change, a media field's value is the name of its attachment, regardless of how the attachment was produced. Inline-binary fields keep their stable, xml based name (`user-file/<xpath>`), which is also written back into the field value so the renderer can resolve the image by value alone, consistent with file-widget uploads. - `nodesToJs` no longer sets `[type=binary]` to ''. - `bindJsonToXml` skips binding into `[type=binary]` for empty & attachmentment name reference. inline base64 still binds. - `xmlToDocs` attaches `[type=binary]` blob under the xpath-derived name and rewrites the element text to that name. - `getImagePath` gets the value directly when it starts with `user-file/` and preserves the legacy fetch path Existing data behavior: - Pre-existing docs with `<binary>=""` and a `user-file/<xpath>` attachment, gets overwrite-in-place on edit-re-save as the base64 is supplied for re-attachment under the same xpath-derived key. - Un-edited legacy main-doc records continue to render via the legacy `user-file/<label-path>` fallback in `getImagePath`. - Sub-doc image rendering, previously broken because the parent-form prefix was unreachable from sub-doc field paths, now works once the field has been rewrittento the literal attachment name. - `calculate`-derived per-doc base64 is preserved across edits via re-computation at Enketo's form-init

The report path was searching [type=binary] for file-widget filenames, so modern [type=file] widgets in sub-docs fell back to the main report doc. Narrow both report and contact paths to [type=file] (inline binaries are handled by their own loops).

A media field's value is now uniformly its attachment name minus the USER_FILE_PREFIX, for both file-widget uploads and inline-binary fields. - export USER_FILE_PREFIX from enketo.service; use it for both file and inline-binary attachment names (binary -> user-file-<formId>/<xpath>/<field>) - store the bare reference (<formId>/<xpath>/<field>) as the binary field value - add EnketoTranslationService.isAttachmentRef (path-pattern regex) and use it in the three former startsWith('user-file/') guards - remove the dedicated user-file/ branch from getImagePath; the bare value resolves through the unified user-file- + value branch - reduce processAllAttachments cognitive complexity (extract helpers) - reduce bindJsonToXml cognitive complexity (extract shouldSkipBinaryBind, bindArrayToXml, bindObjectToXml) - namespace report sub-doc binaries by ownerDoc.type - update unit specs; fix stale type="binary" file-widget fixtures to type="file"

Make the sub-contact badge assertions robust to the exact xpath: verify the inline-binary attachment exists and the field value is that name minus the user-file- prefix, and that the value is preserved unchanged on edit.

Sub-docs carry their own form, so revert attachInlineBinary to `ownerDoc.form || doc.form`. Update the db-doc-with-binary fixture so its sub-docs include a <form> element, matching real sub-report shape.

- fill unit-coverage gaps: binary-in-repeat, empty binary, file dedup - gitignore tmep folder - tests hygiene: variable renaming and comments clean up

jkuester commented May 15, 2026

View reviewed changes

Comment thread webapp/src/ts/services/enketo.service.ts

jkuester force-pushed the 10903-sub-contact-routing branch 2 times, most recently from c660ebb to 3bbca5f Compare May 15, 2026 21:02

jkuester commented May 15, 2026

View reviewed changes

jkuester mentioned this pull request May 15, 2026

feat(#10903): sub contact attachment routing medic/cht-core#10923

Open

7 tasks

benkags reviewed May 16, 2026

View reviewed changes

benkags force-pushed the 10903-sub-contact-routing branch from 40daa0b to 39ccc3c Compare May 20, 2026 21:48

YASHSHARMAOFFICIALLY and others added 22 commits May 21, 2026 10:36

feat(medic#10904): route file attachments to correct sub-docs in repo…

05b38ac

…rt forms (medic#10922) Co-authored-by: Bernard K. <kagondubernard81@gmail.com>

feat(medic#10903): validate attachment size on contact save path

40e7c3b

saveContact now uses validateAttachments(preparedDocs.preparedDocs)

test(medic#10903): cover validateAttachments wiring on contact save path

304d2e0

- main-doc & sub-doc oversize attachment fails saveContact - normal-sized attachment passes validation

fix(medic#10903): match type="file" upload nodes when routing

bd7e6a1

Enketo's setVal rewrites uploaded binary nodes to type="file" the moment a value is set.

feat(medic#10903): clean up.

f5f9792

refactor resolveContactOwnerDoc signature.

36593e2

refactor resolveContactOwnerDoc to reduce cognitive load

a2d3805

refactor: use Set for ignored section tags

9d5b49a

refactor: use Array.find over jQuery filter()[0]

596fdfd

refactor: group contact-owner lookup params into context object

44a6753

test(e2e): assert sub-contact attachment routing on create and edit

b255672

add sub-contact attachment routing form fixtures & testes

test(e2e): click add-repeat for the first child row, fix edit-flow re…

6482af4

…peatIndex

test(e2e): drop primary contact section from edit form

92d1e70

test(e2e): rename main section to match contact_type so existing data…

eed0b2c

… binds on edit

Apply suggestions from code review

2d6589c

Co-authored-by: Joshua Kuestersteffen <jkuester@kuester7.com>

fix typo.

5e9aa8b

benkags added 3 commits May 21, 2026 10:36

test(e2e): assert badge value equals attachment name minus prefix

4a95939

Make the sub-contact badge assertions robust to the exact xpath: verify the inline-binary attachment exists and the field value is that name minus the user-file- prefix, and that the value is preserved unchanged on edit.

fix(medic#10904): namespace report sub-doc binaries by ownerDoc.form

3adce63

Sub-docs carry their own form, so revert attachInlineBinary to `ownerDoc.form || doc.form`. Update the db-doc-with-binary fixture so its sub-docs include a <form> element, matching real sub-report shape.

fix(medic#10904): resolve rebase conflict in enketo report-routing specs

69fe840

benkags force-pushed the 10903-sub-contact-routing branch from 39ccc3c to 69fe840 Compare May 21, 2026 07:37

jkuester and others added 6 commits May 21, 2026 14:52

Bump CI

b01b7e2

comments clean up.

6b6c7d9

fix failing e2e test.

576e2d8

fix failing e2e test.

0b25504

test(medic#10903): add tests and clean up

e850f29

- fill unit-coverage gaps: binary-in-repeat, empty binary, file dedup - gitignore tmep folder - tests hygiene: variable renaming and comments clean up

feat: refactor binary filename handling

a8dfb10

jkuester force-pushed the 10903-sub-contact-routing branch from 3bbca5f to a8dfb10 Compare May 26, 2026 21:40

benkags force-pushed the 10903-sub-contact-routing branch 2 times, most recently from 19e33c9 to d3f9c15 Compare May 27, 2026 09:31

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

10903 sub contact routing#10

10903 sub contact routing#10
jkuester wants to merge 31 commits into
benkags:10903-sub-contact-routingfrom
jkuester:10903-sub-contact-routing

jkuester commented May 15, 2026 •

edited

Loading

Uh oh!

jkuester May 15, 2026

Uh oh!

Uh oh!

jkuester May 15, 2026 •

edited

Loading

Uh oh!

benkags May 16, 2026

Uh oh!

jkuester May 18, 2026

Uh oh!

benkags May 16, 2026

Uh oh!

jkuester May 18, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

jkuester commented May 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

License

Uh oh!

jkuester May 15, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

jkuester May 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

benkags May 16, 2026

Choose a reason for hiding this comment

Uh oh!

jkuester May 18, 2026

Choose a reason for hiding this comment

Uh oh!

benkags May 16, 2026

Choose a reason for hiding this comment

Uh oh!

jkuester May 18, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

jkuester commented May 15, 2026 •

edited

Loading

jkuester May 15, 2026 •

edited

Loading