Connectors give your applications the ability to access external data from different sources, such as from a database or in the cloud. To add a Connector:
- Install the Connector.
- Configure the Connector.
- Use the Connector.
Search for connectors
To see an available list of Connectors, go to the Axway Marketplace and select Connector in the Categories list. To see a list of the available API Builder connectors, select API Builder in the API Management list.
The following API Builder model-first connectors are offered on the Axway Marketplace: ArrowDB, Box.com, CompositeJS, Elastic Search, Google Custom Search, HL7 FHIR Swagger Docs, LokiJS, Microsoft Azure, Microsoft SQL Server, MongoDB, MySQL, OData, Oracle Database, Redis, Salesforce, SOAP, Swagger, and Twilio.
Beginning with API Builder 3.0.0 (Included in CLI 7.0.0), the following new API Builder service connectors are offered on the Axway Marketplace: , , , , , , , , , , , , , Cloud , , , , , .
The following sections describe how to install and configure the new service connectors offered with API Builder 3.0.0 (Included in CLI 7.0.0).
Install a service connector
To install a service connector:
- Download the service connector from the Axway Marketplace.
- Unzip the service connector into the
/serviceconnectors/<connector name>folder in your project directory.
Note: The new service connectors are plain flow-node modules but they are not installed as such in API Builder V3.0.0. The zip file will contain the
packagefolder that contains the actual connector. Rename the
packagefolder after unzipping to match your connector name.
From the project directory, execute the following command to install the HTTP communication module:
From the project directory, execute the following command:
Open the API Orchestration flow editor in the API Builder Console and verify that the service connector is listed and is available for use in flows.
Configure a service connector
A service connector configuration file is not mandatory since all the options for invoking the service connector functions invocation are provided in the API Orchestration user interface. However, if you need to configure the service connector to set common parameters, you must copy the config file from
**connector/config/connector_name.default.js and place it in the
The following sections describe how to install, configure, use, and remove the model-first connectors.
Install a model-first connector
To install a model-first connector, execute the
appc install connector/<CONNECTOR_NAME> command from the project's directory. The command downloads and installs the connector in the
node_modules/connector directory, updates the
appc.json file, and creates a connector configuration file in the project's
Configure the model-first connector
Depending on the connector you installed, you may need to modify the configuration settings of the connector. Open the project's
conf/<CONNECTOR_NAME>.js file to modify its settings. Some connectors have multiple files for different deployment environments, such as the
appc.arrowdb connector. For example, the MySQL connector's configuration file contains keys for you to define the database host URL, port number, admin user, admin password, and database name as well as additional database access settings.
Disable API endpoints
By default, when you install a connector, it will add its API endpoints to the application, for example,
api/myconnector/model. If you do not want to generate these API endpoints, set the
modelAutogen key to
false in the connector's configuration file in the project.
Use the model-first connector
To use the connector, simply assign the
connector key in a Model file to the name of the connector. For example, the model file below is using the
employee table (or model) accessed by the MySQL connector.
Remove a model-first connector
To remove a connector from your project, you need to manually update the
appc.json file and remove some files.
appc.jsonfile and delete the connector you want to remove from the
dependenciesobject. For example, if you want to remove the MySQL connector, remove the
"connector/appc.mysql": "^1.0.34". Note that you will need to remove the trailing comma at the end of the
- Delete the connector's configuration file(s) from the project
confdirectory. The file(s) will contain the name of the connector.
- Delete the connector's directory in the
node_modules/connectors/directory. The directory will contain the name of the connector.