Skip to content

Martini Workflows Invoke Service Node

Overview

The Invoke Service Node lets you call existing Martini services directly from your workflow. This makes it easy to reuse services across multiple workflows, helping you build modular, maintainable solutions without duplicating logic.

What You Will Learn

  • How to add Invoke Service Nodes to your workflow
  • How to use the Invoke Service Mapper Panel for property mapping and transformation
  • How to create and map properties visually
  • How to troubleshoot common issues

Prerequisites

Adding Invoke Service Nodes to Workflows

To add an Invoke Service Node to your workflow:

  1. Open your Martini package in the Navigator and double-click your workflow to open the Workflow Designer.
  2. Locate the service(s) you want to invoke in your workflow from the same package.

    Services are marked with a icon.

  3. Drag the service onto the Workflow Designer canvas.
  4. The service becomes an Invoke Service Node.
  5. Connect it to other nodes using workflow edges.

Quick Add: Invoke Service Node via Edge

To quickly add an Invoke Service Node using the content assist popup:

  1. Drag an edge from any node and drop it onto a blank area of the Workflow Designer canvas.
  2. In the popup, type to search for the desired service name.
  3. Double-click the service in the results or press Enter.
  4. The Invoke Service Node is added and automatically connected by the edge.

Expected result: An Invoke Service Node appears in your workflow, ready for property mapping and transformation in the Invoke Service Mapper Panel.

Invoke Service Mapper Panel

The Invoke Service Mapper Panel uses Martini's standard Data Mapper Panel with the Double Mapper Layout to connect and transform data between your workflow and the services you invoke.

What makes it specific to Invoke Service Nodes:

Invoke Service Nodes use the Double Mapper Layout with separate input and output mapping sections:

  • Input Mapper (Left): Map workflow properties to the service inputs.
  • Output Mapper (Right): Map service outputs to workflow properties.

For complete details on using the Data Mapper Panel, including creating map lines, set expressions, and property management, see the Data Mapping Guide.

Getting Started

  1. Click the expand icon on your Invoke Service Node to open the Data Mapper Panel
  2. The panel appears in the lower half of the Workflow Designer

Expected result: The Data Mapper Panel opens showing your workflow properties and the selected service's input/output parameters using the Double Mapper Layout.

Input Mapper Layout for Invoke Service

The Input Mapper (left side) shows:

1
2
3
4
| Workflow Properties      | Mapping Lines | Service Input Properties |
|--------------------------|---------------|--------------------------|
|        [input1]          |   ------->    |      [serviceIn1]        |
|        [input2]          |   ------->    |      [serviceIn2]        |
  • Workflow Properties (left): These are the available properties from your workflow, including both workflow inputs and any properties created or updated by the current and previous nodes. You use these as sources to pass data into the service.
  • Mapping Lines (middle): Visual connectors showing how data flows.
  • Service Input Properties (right): These are the fields that your service expects as input. Any workflow property you map here will be passed into the service when the workflow runs.

Output Mapper Layout for Invoke Service

The Output Mapper (right side) shows:

1
2
3
4
| Service Output Properties | Mapping Lines | Workflow Current/Output Properties |
|---------------------------|---------------|------------------------------------|
|      [serviceOut1]        |   ------->    |         [workflowOut1]             |
|      [serviceOut2]        |   ------->    |         [workflowOut2]             |
  • Service Output Properties (left): Source properties produced by the service.
  • Mapping Lines (middle): Visual connectors showing how data flows.
  • Workflow Current/Output Properties (right): Target properties in your workflow, including workflow outputs and any properties created or updated by the current and previous nodes.

Map Lines

Map lines work exactly as described in the Data Mapping Guide. For Invoke Service Nodes specifically:

Mapping Workflow Properties to Service Input

  1. Open the Data Mapper Panel on your Invoke Service Node
  2. Find your source property in the Workflow Properties area (left side of Input Panel)
  3. Create a map line to the target Service Input Property (right side of Input Panel)

Result: Your workflow data is passed to the service when it executes.

Mapping Service Output to Workflow Properties

  1. Find your source property in the Service Output Properties area (left side of Output Panel)
  2. Create a map line to the target Workflow Property (right side of Output Panel)

Result: Service results become available to subsequent workflow nodes or workflow outputs.

For complete map line and property creation methods, including drag-and-drop and right-click shortcuts, see Working with Map Lines.

Set Expressions

Invoke Service Nodes support the full range of set expressions described in Assigning Dynamic Values to Properties with Set Expressions. This allows you to:

  • Transform service outputs before mapping to workflow properties
  • Calculate dynamic values for service inputs
  • Set static configuration values

Troubleshooting

Problem Detection Cause Fix Affected Versions
Service not invoked Workflow does not produce expected output There are no edges connecting the Invoke Service Node to the rest of the workflow, Mapping missing or incorrect Check Data Mapper Panel for correct property mapping v2.2+
Property not available Property missing in Data Mapper Panel Property not declared or mapped Declare property in Output Mapper and map correctly v2.2+

Helpful Resources