Step 3: Pull In Custom Content Types

If your Drupal pages use content types beyond the five we have built-in data connectors for (article, event, page, person, place), follow these instructions to pull in entities of any type.

light bulb
Note
New to data connectors? We recommend going through the Data Connectors training module prior to building out your own custom data connector to pull in your Drupal entities.

Create Custom Entities and Fields

Before setting up the connector, you’ll have to make sure you have a Custom Entity Type and Fields set for the new content type you want to pull in. You can do this by following these guides:

Set up your Connector

Once your custom entity type is set up and enabled:

  1. Go to Apps > App Directory in the navigation bar. Download the Drupal data connector that pulls in the entity type most similar to the custom entity type you wish to pull in.

    • Note: if your custom entity type isn’t similar to any of the five shown, you can select any of the available options.
  2. After installing, you will be redirected to the connector’s overview page. Click Edit Configuration.

  3. Click Source. Update the Entity Type to the new custom entity type you created.

  4. Now, click on API Settings in the left-hand sidebar.

  5. The Request URL will take the form http://example.com/jsonapi/node/[content_type_name].

  6. Replace the current content type (e.g. “article”) with the entity type ID for the entity type you’d like to pull in. You can find the custom content type name in your Drupal account.

  7. Click Continue in the bottom right corner to go to the Specify Selectors page.

  8. Selectors such as Name and Entity ID may stay the same for your new entities, though you’ll likely want to select different fields to pull into the platform. Learn more about specifying selectors in the Extract — Source, Source Settings & Selectors training unit .

  9. Add any transforms that may be necessary to format your data properly in Content (more info on Transforms in the Transforms training unit ).

  10. Map the appropriate fields to fields on the Yext entity (more info mapping fields in the Load — Map & Run training unit .

  11. Run the connector and watch your new entities enter Yext Content!