useLock

useLock is a low-level hook that returns a callback to call dataProvider.lock(), leveraging react-query’s useMutation.

This feature requires a valid Enterprise Edition subscription.

Installation

npm install --save @react-admin/ra-core-ee
# or
yarn add @react-admin/ra-core-ee

Usage

const [lock, { isLoading, error }] = useLock(
    resource,
    { id, identity, meta },
    options
);

The payload is an object with the following properties:

• id: the record id (e.g. 123)
• identity: an identifier (string or number) corresponding to the identity of the locker (e.g. 'julien'). This usually comes from authProvider.getIdentity().
• meta: an object that will be forwarded to the dataProvider (optional)

The optional options argument is passed to react-query’s useMutation hook.

For most use cases, you won’t need to call the useLock hook directly. Instead, you should use the useLockOnMount or useLockOnCall orchestration hooks, which are responsible for calling useLock and useUnlock.