absent_users()

Returns all users marked as absent in a workflow organisation via wfm.GetAbsentUsers.

1. Signature

  • Sync

  • Async

ecm.workflow.absent_users(organisation_id: str) -> list[str]
await ecm.workflow.absent_users(organisation_id: str) -> list[str]

2. Parameters

Parameter Type Default Description

organisation_id

str

 — 

ID of the workflow organisation. Valid IDs can be obtained from ecm.workflow.organisations().

3. Return value

A list of user-object GUIDs (str). Returns an empty list when no users are marked as absent.

4. Examples

4.1. Absent users of the active organisation

  • Sync

  • Async

active_org = next(org for org in ecm.workflow.organisations() if org.active)
absent = ecm.workflow.absent_users(active_org.id)
print(f"{len(absent)} users absent")
for guid in absent:
    print(f"  {guid}")
orgs = await ecm.workflow.organisations()
active_org = next(org for org in orgs if org.active)
absent = await ecm.workflow.absent_users(active_org.id)
print(f"{len(absent)} users absent")
for guid in absent:
    print(f"  {guid}")

4.2. Combine with user details

  • Sync

  • Async

active_org = next(org for org in ecm.workflow.organisations() if org.active)
absent_guids = ecm.workflow.absent_users(active_org.id)
users = ecm.security.users()
absent_users = [u for u in users if u.guid in absent_guids]
for user in absent_users:
    print(f"{user.display_name} is absent")
orgs = await ecm.workflow.organisations()
active_org = next(org for org in orgs if org.active)
absent_guids = await ecm.workflow.absent_users(active_org.id)
users = await ecm.security.users()
absent_users = [u for u in users if u.guid in absent_guids]
for user in absent_users:
    print(f"{user.display_name} is absent")

5. See also

  • organisations() — Query workflow organisations (provides valid organisation_id values)

  • users() — Retrieve all users with details