Skip to main content
The actions method is used if you need to trigger new processing - which could be processing another schema or pushing generated views to a third-party application - using web hooks or such as Algolia.

​
ActionsContext object

The ActionsContext object is passed into the actions method and gives you access to the reprocess and destination functions which are described below.

​
Methods

MethodDescription
reprocessReprocess a schema based on its alias.
destinationSpecifies the destination where the generated view is pushed to.

​
reprocess

reprocess(schemaAlias)
Note that reprocess only triggers whenever the source entity is changed. This means that a deploy of the schema will not trigger the reprocess.
Read more about how reprocessing is working, when to use it and when not to use it in the key concepts.

​
Parameters

ParameterTypeDescription
schemaAliasstringThe alias of a schema.

​
Required function calls

After the reprocess function it’s required to call one of the following functions to define what source entities you want to reprocess.
Use the byOriginId function to reprocess a specific entity based on its originId.

​
Parameters

ParameterTypeDescription
originIdstringThe original id from the source system.
reprocess by byOriginId
context
    .reprocess('mySchemaAlias')
    .byOriginId(sourceEntity.properties.link.id)
Use the bySchema function to reprocess all source entities a specific schema has a trigger on.Caution: Often it’s better to reprocess a specific source entity instead a schema and all of its matching source entities, but sometimes it’s necessary to reprocess an entire schema.Note: Even though you are reprocessing an entire schema, you still need to specific the source group (see optional function call) if it’s different from the source group of the source entity triggering the reprocess.
reprocess by bySchema
context
    .reprocess('mySchemaAlias')
    .bySchema()
Using the filter function lets you do a dynamic search for source entities you want to reprocess.

​
Parameters

ParameterTypeDescription
filterstringYour filtering criteria. See list of filter examples
reprocess by filter
 context
    .reprocess('mySchemaAlias')
    .filter("type eq 'account' and properties.internalId eq '1234'")
The filter function is limited to a maximum number of items to return, based on the tenant plan. It can however be increased per tenant basis. Please reach out to Enterspeed if needed.The default limits are:
  • Free & Premium plans: 100 items
  • Enterprise plan: 500 items
Use the parent function to reprocess the parent entity based on its originParentId.
reprocess by byOriginId
context
    .reprocess('mySchemaAlias')
    .parent()

​
Optional function calls

To filter the source entities you want to reprocess even further you can call some of the following optional functions.
The limit function limits the number of source entities.

​
Parameters

ParameterTypeDescription
limitnumberThe maximum number of source entities.
reprocess by filter and limit
 context
    .reprocess('mySchemaAlias')
    .filter("type eq 'account'")
    .limit(5)
The orderBy function sorts the source entities. This is typically used in combination with limit.

​
Parameters

ParameterTypeDescription
orderBy{ propertyName: string, direction: “asc” | “desc” }Allows you to specify your desired sorting order.
reprocess by filter and orderBy
 context
    .reprocess('mySchemaAlias')
    .filter("type eq 'account'")
    .orderBy({ propertyName: "properties.createdDate", direction: "desc"})
Defines the source group of an source entity to process. If the source entity you want to reprocess is located in another source group than the current source entity, you must specific the source group.Note: sourceGroup can’t be used on parent as parent is implicit in the same source group as the child.

​
Parameters

ParameterTypeDescription
sourceGroupAliasstringThe alias of the source group for the source entity you want to reprocess.
reprocess by origin id and source group
context
    .reprocess("mySchemaAlias")
    .byOriginId(sourceEntity.properties.link.id)
    .sourceGroup('anotherSourceGroup')

​
destination

destination(destinationAlias) The destination method is used to push generated views for a schema to a webhook, to Algolia or another third-party application.

​
Parameters

ParameterTypeDescription
destinationAliasstringThe alias of the destination you want the generated view is pushed to.

​
Examples

actions example
actions: function(sourceEntity, context) {
    context.reprocess('productCategory')
            .byOriginId(sourceEntity.properties.productCategoryPage.id)
            .sourceGroup('commerce');
    context.reprocess('account')
            .filter("type eq 'account' and properties.internalId eq '1234'");
    context.destination('webhook');
}
actions can also be expressed as an arrow function expression to make it even more compact
actions: (sourceEntity, context) => context.reprocess('productCategory').parent()