The data is made available under the specified name and can then be used in textual content by means of placeholders.
Makes external data globally available to the application.
The data is made available under the specified name and can then be used in textual content by means of placeholders.
Params
name
(String
) – The name under which the external data should be made available globally.connection
(Function
or Object
) – A function the SDK uses as the get
callback, or an object containing an asynchronous callback for fetching and optionally one for updating the item data.Object
is provided, it needs to consist of:get
(Function
) – An asynchronous callback for fetching the external data.update
(Function
) – An optional asynchronous callback for updating the external data.get
The get callback retrieves external data. Scrivito executes the passed-in function and awaits the outcome of the returning promise. It is required to provide this callback to provideDataItem
as shown above.
Returns
Object
or null
– A plain JavaScript object containing the external data that can be used to provide an editing configuration. If the promise resolves with null
, the external data is assumed to be missing.Example
Make external data available under the name LoggedInUser
:
The external data can be referenced within textual content via placeholders:
When this text is rendered using Scrivito.ContentTag
, the placeholder is replaced with the referenced external data:
update
The optional update
callback updates the piece of external data passed in via the data
argument, and waits for the promise to resolve.
Params
data
(Object) – A plain JavaScript object containing the external data.Returns
Promise<unknown>
Example
Update the external data available under the name LoggedInUser
:
As an alternative to providing a connection
object containing the get
callback function, the latter can be provided to provideDataItem
directly as the second argument:
The external data is also available when content is being edited in place. Here’s how the object returned by Scrivito.provideDataItem
can be used to configure user-interface-related aspects:
See also Scrivito.provideEditingConfig
.
A placeholder consists of two underscores, followed by a valid identifier, a dot, then another valid identifier and another two underscores.
The first identifier references the name under which the external data was made available, e.g. LoggedInUser
or ProductDetails
, while the second identifier references the attribute name of the external data, e.g. email
or price
:
The key parts of a placeholder are its identifiers. They allow Scrivito to determine the value the placeholder stands for. Identifiers must follow these rules: