Improve SMS recipient resolution in 'app_settings.json'

[binokaryg]

Page: /building/reference/app-settings/
Version: 2024-11-03 13:55:45 0100 0100

Under SMS recipient resolution, we have these two options among others:

value	resolves to
ancestor:<contact_type>	primary contact of the place of the requested type in the subject’s/submitter’s lineage
link:<contact_type>	primary contact of the place of the requested contact_type in the subject’s/submitter’s lineage. As of 3.10.x

How do they differ? The descriptions look similar.

Looking at the code, it looks like the ancestor: looks for phone in the parent doc while link: first looks for a direct match, and if not found, goes to the parent:

  } else if (recipient.startsWith('ancestor:')) {
    const type = recipient.split(':')[1];
    phone = getParentPhone(context.patient, type) ||
            getParentPhone(context.place, type) ||
            getParentPhone(context, type);
  } else if (recipient.startsWith('link:')) {
    const tag = recipient.split(':')[1];
    phone = getLinkedPhone(context.patient, tag) ||
            getLinkedPhone(context.place, tag) ||
            getLinkedPhone(context.contact, tag) ||
            getParentPhone(context.patient, tag) ||
            getParentPhone(context.place, tag) ||
            getParentPhone(context.contact, tag);