View Source Ash.Resource.Change behaviour (ash v2.15.0)

The behaviour for an action-specific resource change.

init/1 is defined automatically by use Ash.Resource.Change, but can be implemented if you want to validate/transform any options passed to the module.

The main function is change/3. It takes the changeset, any options that were provided when this change was configured on a resource, and the context, which currently only has the actor.

Summary

Callbacks

Runs on each batch result after it is dispatched to the data layer.

Replaces change/3 for batch actions, allowing to optimize changes for bulk actions.

Runs on each batch before it is dispatched to the data layer.

Types

@type context() :: %{
  optional(:actor) => Ash.Resource.record(),
  optional(any()) => any()
}
@type ref() :: {module(), Keyword.t()} | module()
@type t() :: %Ash.Resource.Change{
  change: term(),
  description: term(),
  on: term(),
  only_when_valid?: term(),
  where: term()
}

Callbacks

Link to this callback

after_batch(list, t, context)

View Source (optional)
@callback after_batch(
  [{Ash.Changeset.t(), Ash.Resource.record()}],
  Keyword.t(),
  context()
) ::
  Enumerable.t(
    {:ok, Ash.Resource.record()}
    | {:error, Ash.Error.t()}
    | Ash.Notifier.Notification.t()
  )

Runs on each batch result after it is dispatched to the data layer.

Link to this callback

batch_change(list, t, context)

View Source (optional)

Replaces change/3 for batch actions, allowing to optimize changes for bulk actions.

Link to this callback

before_batch(list, t, context)

View Source (optional)

Runs on each batch before it is dispatched to the data layer.

@callback change(Ash.Changeset.t(), Keyword.t(), context()) :: Ash.Changeset.t()
@callback init(Keyword.t()) :: {:ok, Keyword.t()} | {:error, term()}

Functions