Afform - allow ids to be passed directly into the directive

[colemanw]

Overview

This gives Submit Forms the same feature as Search Forms, entity ids can be passed directly into the directive as 'options', allowing ids to be passed around internally.

Before

With an Afform named MyForm and an entity named Contact 1, you could enable url-autofill for that entity and append #/?Contact1=123 to the url to supply an existing contact id.

After

The above still works, but to facilitate embedding an afform into other places e.g. a block or a contact summary tab, you can pass the id directly into the directive e.g.:

<my-form options="{Contact1: 123}"></my-form>

Comments

Note that this same technique already works with Afforms of type "Search" so this just extends the functionality to work with submission forms as well.

Technical Details

See discussion at systopia/de.systopia.eck#48 (comment)

[civibot]

(Standard links)

• If this is your first pull-request for CiviCRM, please browse CONTRIBUTING.md for information about the development and testing processes.
• If you are reviewing this pull-request, you may wish to consult the test sites and the Review Standards (long template, short template).

[totten]

@colemanw The "After" example isn't readable?

[colemanw]

@totten fixed

[jensschuppe]

I can confirm this works with the ECK implementation (systopia/de.systopia.eck#48), where an Afform for editing a custom entity is being embedded in a tabset and loads with current entity values. However, submitting the embedded form does not seem to work, the entity values are not being updated.

[colemanw]

@jensschuppe good catch. It was not passing the id correctly to the submit action. I've updated this PR, so now it saves.

The UX is still not great because it doesn't refresh the page so you still see old data on the "View" tab, but I think we can address that in a followup PR.