KTL's Add Record History (_arh): New [identifier] parameter — Fix for blank Identifier

API & Custom Code Show & Tell
1

_arh: New [identifier] parameter — Fix for blank Identifier in Record History

If you’ve been using the _arh keyword, you may have noticed that the Identifier field in your Record History entries sometimes shows up blank.

This happens because _arh assumes the Identifier is the Display Field of the object.

However, the Display Field is often a formula Text field (e.g. combining a name with an ID number), and since formula fields are read-only, they cannot be added to an Add/Edit form. When the field isn’t present in the form, the record data returned on submit simply doesn’t contain it — resulting in a blank Identifier.

The solution: [identifier]

A new optional group parameter lets you explicitly specify which field to use as the Identifier. There are two approaches:

  1. Add a Details view to the page that includes your Display Field, and point _arh to it. You can hide it with _hv if you don’t want it visible to users.

  2. Use a specific field already in your form that clearly identifies the record being processed (e.g. a name or serial number field).

Syntax

The parameter uses Universal Selectors, so you can reference fields and views by ID or by label:

_arh=[identifier, field_123, view_456]

_arh=[identifier, Client ID Name, Client Details View]

_arh=[identifier, field_123] — when the field is in the current view

This can be combined with all existing parameters as usual:

_arh=[context, Client Updates], [identifier, Client ID Name, Client Details View], [expiry, 90d]

Documentation: _arh keyword

Enjoy,

Normand