ClaimItems API - Optionally return the "run as" (contact ID/domain ID)

[totten]

Overview

The ClaimItems API provides a facade for remote workers calling CRM_Queue_Queue_*::claimItems(). Some items have "run as" flags (eg CRM_Queue_Task::$runAs). This patch makes it easier to read "runAs".

Before

Not specifically returned.

After

Available as an optional value "select" field.

Comments

This makes it easier/cheaper for coworker to run tasks from various users/domains. It complements this draft update: https://lab.civicrm.org/dev/coworker/-/commit/d92fe0892b2602a99df78ed7f74b381925d481eb

This currently only returns the "run as" for CRM_Queue_Task. Using identities with other types of queue-items is currently hypothetical. Dealing with that hypothetical is a longer write-up/topic, but IMHO this is reasonably aligned with how that edge-case should get resolved.

[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).

[eileenmcnaughton]

I stepped through this & was able to add to the import job - #24805 and via stepping through the code verify it is checked. I have not succeeded in getting coworker to work yet so was unable to verify that but this seems like one of the pieces