Glyue User Docs
  • What is Glyue?
  • Tutorials
    • Start Here
    • Building a Single-Step Integration
      • 1. Creating the Integration
      • 2. Calling the External System
      • 3. Running the Integration
      • 4. Crafting the Output
    • Building a Multi-System Integration
      • 1. Connecting to the Core
      • 2. Field Mapping
      • 3. Running the Integration
    • Building an Event-Driven Integration
      • 1. Setting up the Mock CRM
      • 2. Receiving Inbound Requests
      • 3. Triggering the Integration from the CRM
    • Building an Email Integration
      • 1. Create and Configure the Integration
      • 2. Input Validation
      • 3. Get Story IDs from Hacker News
      • 4. Get Story Content
      • 5. Sending the Email
      • 6. Wrapping Up
      • 7. Extra credit
        • extra_credit.json
    • Building a RESTful CRUD Web Service
      • 1. Integration Setup
      • 2. Vault Setup
      • 3. Create Web Service Endpoints
      • 4. Execute Web Service Endpoints with Vault Methods
      • 5. Vault Code Examples and Explanation
    • Building a Retrieval API against FIS CodeConnect
      • 1. Integration Setup
      • 2. Service Request Setup
      • 3. Field Mapping Setup
      • 4. Integration and Service Request Hook Setup
      • 5. Testing the Integration
      • 6. Common Errors
    • What is Pre-Mapping?
      • Before you start
      • Bookmarks
      • Source and Targets
      • Field Mapping Status
      • Field Mapping Comments
      • Summary
  • How-To Guides
    • How to Run an Integration from Glyue
    • How to Invite New Users
    • How to Create a Value Mapping Set
    • How to Build and Deploy a Custom Frontend
    • How to Migrate an Integration
    • How to Set Up Single Sign On (SSO)
      • Glyue Setup
      • JumpCloud Setup
      • Azure Setup
      • Okta Setup
      • Glyue SAML Config Reference
    • How to Install the Glyue App for Zoom Contact Center
    • How to use the Vault
  • Reference
    • Integration Builder Page
    • Integration Anatomy
    • Integration Components
      • Integration
      • Service Request
      • Field Mapping
      • Value Mapping Set
      • Value Mapping
      • Validation Rule
      • Mask
      • Integration Config
      • Integration Engine Versions
    • Integration Lifecycle
    • Special Functions
      • add_run_label
      • callint
      • debug
      • end
      • get_namespace
      • humanize
      • import_helper
      • keep
      • list_files
      • map_value
      • open_glyuefile
      • open_vault
      • Data Manipulation Utilities
      • calladapter
    • Special Variables
      • __adapter_config__
      • input
      • parentint
      • retvalue
      • run_history_id
      • Iterables
        • fitem/fidx
        • sritem/sridx
        • vritem/vridx/vrmsg
    • Adapters
      • Generic HTTP Adapter
      • Email SMTP Adapter
    • Web Service Endpoints
    • Vault Reference
  • Glyue Platform Reference
    • Banking Core Connectivity Guide
    • Authentication
    • Permissions
      • Service Accounts
      • Organizations
    • Frontends
    • Idempotency Layer
    • Integration Scheduler
    • Governance Reports
    • Arbitrary Integration Request Content Support
    • Admin Components
    • Logging
  • ETL
    • Glyue ETL Overview
    • Data Connectors
    • Workflows
    • Run History
    • Scheduler
Powered by GitBook
On this page
  • Creating a request
  • Request customization
  • Payload
  • Headers
  • Query Parameters
  • Path Parameters
  • Re-running an integration
  • Appendix

Was this helpful?

  1. How-To Guides

How to Run an Integration from Glyue

Using the Integration Runner

PreviousSummaryNextHow to Invite New Users

Last updated 8 months ago

Was this helpful?

Running an integration in Glyue involves composing a payload that matches the integration's requirements, then sending that payload to the integration. This can be used as the primary way to run an integration, or to mimic an expected call from a 3rd party service for testing purposes.

Creating a request

Glyue makes it easy to compose the exact request that your integration expects.

  1. To start, right-click on the integration on the Build page and click Run Integration to bring up the Run Integration modal.

  2. If the integration has webservices, use the Method, Prefix, and Webservices dropdowns along the top of the page to select the webservice you wish to trigger.

  3. Configure the content of the request across the Payload, Headers, Query Parameters, and Path Parameters (see below for further details)

To learn more about .

Request customization

Payload

Payload refers to information sent in the body of the request. This information can come in various forms, outlined below:

  • JSON: A JSON editor will appear to input JSON-structured content

  • XML: An XML editor will appear to input XML-structured content

  • Multipart: Accepts a combination of uploaded files (up to 10MB) and form data

  • Binary: Accepts a single file (up to 10MB)

  • Empty: The request body will contain no data

Headers

Headers will be automatically populated based on the content of the payload and other details of the integration. When uploading multipart or binary payloads, the Integration Runner will suggest appropriate headers based on the file type(s) that are uploaded.

Query Parameters

To set query parameters (information passed in via the url, e.g. sandbox.com/endpoint?flavor=chocolate ), enter their key and value. New pairs can be added using the green plus button at the top-left.

Notice the url-encoded form of the query parameters will update in the displayed URL along the top of the Integration Runner.

Path Parameters

Integrations with webservices may have variables in the webservice path. These are represented by {variable} in the path name. As you enter values for each path parameter(s), you should see the value(s) update in the displayed URL along the top of the Integration Runner.

All path parameters must have specific values before the request can be executed.

Note that path parameters cannot be added/edited/deleted from this page — modifications to the path occur on the webservice itself.

Re-running an integration

Oftentimes it is useful to re-use the same request, either for simplicity or debugging purposes. This is done by hovering over an entry in the Run History and clicking the re-run icon.

The Run Integration modal will be pre-filled with the same request details as the selected run. If the selected run involved sending Binary or Multipart files, the same files will be re-used by default. Feel free to change the pre-filled values as desired.

Appendix

Ignored headers (will not be sent even if set in Headers tab)

  • accept-encoding

  • connection

  • content-length

  • host

  • user-agent

Hidden headers (automatically set by Gylue on integration execution)

  • authorization

  • content-type

  • origin

  • referer

  • x-csrftoken

Some headers are omitted from the display and set automatically when the integration is sent. Certain headers will be ignored even if specified, for security reasons. See the full list ignored/hidden headers in the.

Appendix
webservices, see this reference
The payload interface, with Multipart selected.
The Headers interface.
The query parameters interface.
The path parameters interface.
The re-run icon within the Run History list.