Connector Builder - webMethods CloudStreams Connectors

webMethods.io Integration is an integration platform as a service (iPaaS) that lets you connect web apps, on-premises systems, and devices to create integrations and automate tasks.

Create custom cloudstreams connectors with our developer platform. Know how it works and how to install it. In addition, learn how to create a connector, add triggers, actions, lookups, and authentications to it, deploy it, and share it with other users.

You can also create custom cloudstreams connectors using the Connector Builder.

About webMethods CloudStreams

The webMethods CloudStreams provides a scalable approach for the development and governance of integration flows between SaaS applications and on-premise applications. Using webMethods CloudStreams you can perform the following:

For more details about webMethods CloudStreams, refer to either CloudStreams Connector Developer Program or CloudStreams documentation.

Publishing and unpublishing custom webMethods CloudStreams connectors using Software AG Designer

Using Software AG Designer, you can deploy custom webMethods CloudStreams connectors to your desired webMethods.io Integration tenant.

Note: Publishing and unpublishing custom webMethods CloudStreams connectors using Software AG Designer is restricted and is not publicly available. Contact Software AG Support for more information.

The following figure provides a basic overview of the process involved in deploying custom webMethods CloudStreams connectors.

In Software AG Designer, you can do the following:

  1. Configure the desired webMethods.io Integration tenant.

  2. Publish the custom webMethods CloudStreams connector to the desired webMethods.io Integration tenant.

    a. Select the webMethods CloudStreams connector provider associated with the connector you want to publish.
    b. Select the connector provider package you want to publish.
    c. Select the webMethods.io Integration tenant(s) where you want to publish the connector.
    d. Select the custom webMethods CloudStreams connectors you want to publish.

  3. Unpublish the custom webMethods CloudStreams connector from the webMethods.io Integration tenant and unregister the tenant from Software AG Designer.

    a. Select the webMethods CloudStreams connector provider associated with the connector you want to unpublish.
    b. Select the connector provider package you want to unpublish.
    c. Select the webMethods.io Integration tenant(s) from where you want to unpublish a connector.
    d. Select the custom webMethods CloudStreams connectors you want to unpublish.

Prerequisites

To deploy a custom webMethods CloudStreams connector to your desired webMethods.io Integration tenant, install the latest version along with the latest fixes of the following products or components:

Configuring a tenant to webMethods.io Integration

Configure a tenant to the required webMethods.io Integration tenant in Software AG Designer. For this, ensure that a valid URL exists to connect to the tenant and a valid username and password are created on the tenant.

To configure a tenant to webMethods.io Integration, you need to provide specific information in Software AG Designer. You can add, edit, and update tenant configurations in Software AG Designer.

Adding a tenant configuration

Do the following to add a tenant configuration for webMethods.io Integration:

  1. In Software AG Designer, select Window > Preferences.

  2. In the Preferences navigation tree, select Software AG > webMethods.io Integration.

  3. Click Add.

  4. In the Add tenant configuration dialog box, enter the following details:

    Field Description
    Name The name to use for the webMethods.io Integration tenant configuration.
    Note: The name cannot contain control characters, special characters, and characters outside of the basic ASCII character set, such as multi-byte characters.
    URL URL of the webMethods.io Integration tenant to which Software AG Designer is to connect, for example, https://sample.int-aws-us.webmethods.io
    User The user for a tenant on webMethods.io Integration.
    Save password (in the Eclipse secure storage) Indicates whether the password for the specified user account should be saved in Eclipse secure storage.
    webMethods.io Integration uses this password from the Eclipse secure storage whenever user authorization is required. If you want to save the password in Eclipse secure storage, select this option. If you decide not to save the password in Eclipse secure storage, you must specify your password each time your user authorization is required for connecting to webMethods.io Integration.
    Password The password for the specified user.

  5. To verify whether the added webMethods.io Integration tenant can be accessed by using the specified information, click Test.

  6. To store the tenant configuration details, click OK. A tenant configuration is added to the Connections page with the specified details. The first tenant configuration that you create is automatically marked as the default. This default configuration is indicated with a check mark on the Connections page. Software AG Designer always uses the default tenant configuration for webMethods.io Integration. If there are multiple tenants configured, you can select the tenant that you want to make as the default.

Editing a tenant configuration

You can edit a tenant configuration for webMethods.io Integration if there are any changes in the configuration values.

  1. In Software AG Designer, select Window > Preferences.

  2. In the Preferences navigation tree, select Software AG > webMethods.io Integration.

  3. Click Edit.

  4. Enter new values in the tenant configuration fields you want to change.

  5. In the Edit Tenant Configuration dialog box, click OK.

  6. In the Connections page, click OK.

Removing a tenant configuration

You can remove tenant configurations for webMethods.io Integration one at a time from the Connections page.

Do the following to remove a tenant configuration for webMethods.io Integration:

  1. In Software AG Designer, select Window > Preferences.

  2. In the Preferences navigation tree, select Software AG > webMethods.io Integration.

  3. Select the webMethods.io Integration tenant configuration you want to remove.

  4. Click Remove. Software AG Designer prompts you to confirm that you want to remove the selected tenant configuration.

  5. Click OK.

Publishing custom webMethods CloudStreams connectors to webMethods.io Integration

Using Software AG Designer, you can deploy a custom webMethods CloudStreams connector to webMethods.io Integration.

Before you publish a custom webMethods CloudStreams connector to webMethods.io Integration, ensure that Software AG Designer is configured to connect to webMethods.io Integration. For more information on configuring a tenant to webMethods.io Integration, see the Configuring a tenant to webMethods.io Integration section.

Note: You can also configure the tenant to webMethods.io Integration by clicking on the Configure option located at the right-side of the List of Target(s) dialog box.

Do the following to publish a custom webMethods CloudStreams connector to the desired webMethods.io Integration tenant:

  1. In the webMethods CloudStreams Development View, select and right-click on the webMethods Cloudstreams connector provider package associated with the connector that you want to publish to webMethods.io Integration and click Publish.

  2. In the List of Connector(s) dialog box, select one or more connectors you want to publish from the provider package and click Next.

    Note: Connectors that have at least one resource or operation will be available for publishing.

  3. In the List of Target(s) dialog box, go to webMethods.io Integration Tenant(s) and select the configured tenant to publish the connector and click Next.

    Note: You can configure the connection to webMethods.io Integration by clicking on the Configure option located at the right-side of the List of Target(s) dialog box.

  4. In the Publish Connector dialog box, select the connector(s) you want to publish. On clicking the required connector package from the left-side of the dialog box, its corresponding properties will appear on the right-side of the dialog box. You can optionally configure the connector properties before publishing the package to webMethods.io Integration. These properties define the behavior of the selected connector(s) for webMethods.io Integration. Click Finish.

    The selected connectors are now published to the selected webMethods.io Integration tenant and the status is displayed in the log at the lower part of the screen.

Unpublishing custom webMethods CloudStreams connectors from webMethods.io Integration

Using Software AG Designer, you can unpublish a published custom webMethods CloudStreams connector from the webMethods.io Integration tenant.

Do the following to unpublish a custom webMethods CloudStreams connector from the desired webMethods.io Integration tenant:

  1. In the webMethods CloudStreams Development View, select and right-click on the webMethods CloudStreams connector provider package associated with the connector that you want to unpublish from webMethods.io Integration and click Unpublish.

  2. In the List of Target(s) dialog box, go to webMethods.io Integration Tenant(s) and select the tenant from where you want to unpublish the connector(s). Click Next.

    The connector(s) associated with the selected webMethods.io Integration tenant(s) will be retrieved.

  3. In the List of Connector(s) dialog box, select the connector(s) you want to unpublish and click Finish.

The selected tenant will be unregistered from Software AG Designer and its associated connector(s) will be unpublished from webMethods.io Integration.