Webform Field Mapper

Webform Field Mapper

Introduction

The Webform Field Mapper module allows you to map webform fields to different field names on remote posts, enhancing the flexibility of webform submissions. This module is ideal for users who need to integrate their webform submissions with external systems or APIs that require different field names.

Features

Basic Functionality:

• Map local webform fields to remote field names for external posting.
• Add custom hidden fields to the data sent with the webform submission.

Unique Features:

• Provides a user-friendly interface to configure field mappings.
• Supports dynamic addition of custom hidden fields.
• Ensures compatibility with external APIs that have specific field name requirements.

Use Cases:

• Integrating webform submissions with CRM systems.
• Posting webform data to external APIs that have strict field naming conventions.
• Enhancing data interoperability between Drupal and other systems.

Post-Installation

Configuration Process:

• Install the Webform Field Mapper module.
• Navigate to the webform settings where you want to add the handler.
• Add a new handler and select "Field Mapper Post".
• Configure the remote URL where the data should be posted.
• Define field mappings by providing remote field names for each local field.
• Optionally, add custom hidden fields that will be included in the submission.

Special Considerations:

• Ensure the remote URL is correctly specified.
• Verify that field mappings match the requirements of the external system.

Additional Requirements

This module requires the following:

• Drupal Webform module: https://www.drupal.org/project/webform
• Guzzle HTTP client (included with Drupal core).

Recommended Modules/Libraries

To enhance the functionality of this module, consider using:

• Webform: For creating and managing webforms.
• Token: To use tokens in your field mappings and custom hidden fields for dynamic data.

Similar Projects

There are a few other modules that provide similar functionality:

• Webform Remote Post: Allows posting webform submissions to remote URLs but lacks the field mapping flexibility.
• Webform Custom Fields: Provides custom field capabilities but does not support remote posting.

Supporting this Module

If you find this module helpful and want to support its development, consider:

Contributing to the module's issue queue on Drupal.org.

Providing feedback and feature requests.