1.0.0 • Published 7 months ago

@directus-labs/algolia-operation v1.0.0

Weekly downloads
-
License
MIT
Repository
-
Last release
7 months ago

Algolia Operation

Use Algolia to index and search your data with Directus Flows. This Operation allows you to create, update, delete and even search records in your index.

Screenshot of the Algolia Operation in action

Installation

Refer to the Official Guide for details on installing the extension from the Marketplace or manually.

Usage

Once installed, add the Algolia Operation to your flow. Then fill the required options and select which action you would like to perform.

FieldDescription
Application IDYour Algolia application ID found in your dashboard
API KeyA key with sufficient permissions, also found in your dashboard
IndexName of the index on which to perform the action you select.
ActionWhich action to perform: Add or replace record, Add or update attributes, Delete record, Retrieve record or Search

Add or replace record

Creates a record, or if a record already exist with the same Object ID, replace it with a new object.

FieldDescription
Object IDUnique record identifier
BodyAn object with fields that are useful for search and discovery

Example usage

  1. Create an Event Hook flow that is triggered on item.create and choose which collection to include (if you select multiple collections, you can use {{$trigger.collection}} in the Index field).
  2. Add the Algolia Operation and Object ID to {{$trigger.key}}
  3. Add which attributes you want to save in the Body field.

Add or update attributes

Adds new attributes to a record, or update existing ones.

FieldDescription
Object IDUnique record identifier
BodyAttributes to update. It is also possible to update attributes with Algolia's built-in operations.

Example usage

  1. Create an Event Hook flow that is triggered on item.update and choose which collection to include (if you select multiple collections, you can use {{$trigger.collection}} in the Index field).
  2. Add the Algolia Operation and Object ID to {{$trigger.keys[0]}}
  3. Add which attributes you want to save in the Body field.

Delete record

Removes a record from the index.

FieldDescription
Object IDUnique record identifier

Example usage

  1. Create an Event Hook flow that is triggered on item.delete and choose which collection to include (if you select multiple collections, you can use {{$trigger.collection}} in the Index field).
  2. Add the Algolia Operation and Object ID to {{$trigger.keys[0]}}

Retrieve record

Retrieve a record by its Object ID. The Operation will contain all attributes that are currently saved in the record.

FieldDescription
Object IDUnique record identifier

Search

Search for records in your index. Results will be returned in the hits array.

FieldDescription
Search ParametersSee Algolia Documentation for details.