Drupal

The following steps will guide you through configuring Drupal to work with Azuqua.

Step 1: Set up REST API Endpoints

  • {{auth.domain}}/node?_format=json
  • {{auth.domain}}/node/{{input.Read By.Content ID}}?_format=json
  • {{auth.domain}}/node/{{input.Delete By.Content ID}}
  • {{auth.domain}}/node/{{input.Update By.Content ID}}?_format=json
  • {{auth.domain}}/node/{{input.Update By.Content ID}}
  • {{auth.domain}}/comment
  • {{auth.domain}}/comment/{{input.Read By.Comment ID}}?_format=json
  • {{auth.domain}}/taxonomy/term
  • {{auth.domain}}/taxonomy/term/{{input.Read By.Tag ID}}?_format=json
  • {{auth.domain}}/entity/date_format/medium?_format=json

These two endpoints are setup via Drupal views:

  • {{auth.domain}}/api/v1/searchTags
  • {{auth.domain}}/api/v1/searchNodes?_format=json

Enable and create a REST API Endpoint

  1. Install Rest IU module: https://www.drupal.org/project/restui
    1. Download https://www.drupal.org/project/restui/releases/8.x-1.15
    2. Install module: /admin/modules/install
  2. Click Extend from Manage menu and enable Web Services

Step 2: Set up Views

  1. Click on Structure on the top left. Click on **Views.

    **

  2. Click on Add View button.

  3. Complete setting up the following views:

    • searchNodes
    • searchTags

searchNodes

path: /api/v1/searchNodes

  1. Click Format: Settings to enable request formats
  2. Click Show: fields

    1. Add the following fields: ID, Title, Body, Changed, Content type, Authored on, Promoted to front page, Sticky at top of list, Tags
    2. Update Filter Criteria, Sort Criteria, Path settings per this screenshot

    3. For the fields “Changed” and “Authored” on Date format should be “HTML Datetime format:2018-02-23T09:34:28+0000”

searchTags

path: /api/v1/searchTags

  1. Format settings

  2. Set up fields, sort criteria, path settings per screenshot

  3. Configure fields

    1. Name – unselect the “Link to the Taxonomy term”

    2. Descriptions – select “Strip HTML tags”

Configure REST Server Settings

Under Configuration -> REST

Enable the following 4 resources with configurations displayed under “Description”:

Authentication

Note: when creating a connection to Drupal in Azuqua, the ‘Domain’ field should be something like ‘http://test.pantheonsite.io' that includes¬†the ‘http://’ or ‘https://’ and excludes the ending slash.

Events:

  • New Content - Start FLO when new content is created.
  • Updated Content - Start FLO when existing content is updated.

Actions:

  • Create Comment - Create a comment on content.
  • Create Content - Create content with HTML in the body.
  • Create Tag - Create a tag and return the tag ID.
  • Delete Content - Delete content using the content ID.
  • Read Comment - Read a comment using the comment ID.
  • Read Content - Read content using the content ID.
  • Read Tag - Read a tag using tag ID.
  • Search Tags - Search tags using filters.
  • Update Content - Update content using the content ID.