Testing and Using the EnterpriseConnect Installation
After you have set up and configured your local EnterpriseConnect installation and started the Agent and adapters, you can test whether everything is working correctly from RunMyProcess DigitalSuite. If the tests are successful, you can start to access local resources from your projects in the Cloud.
For both purposes, you need to define a provider and appropriate connectors for your projects in RunMyProcess DigitalSuite.
Defining a Provider in RunMyProcess DigitalSuite
For connecting to your local EnterpriseConnect installation from a project in RunMyProcess DigitalSuite, you need to define a corresponding provider.
Log in to the Advanced IDE.
Go to the project in which you want to work with local resources by means of EnterpriseConnect.
In My Connectors on the Providers tab, define a new provider.
Enter a Title of your choice, for example,
EnterpriseConnect on Windows.
For the Live, Acceptance, and Test environments, specify the parameters of your EnterpriseConnect installation:
Url: Select HTTP. For accessing local resources by means of adapters, specify the host and port of the EnterpriseConnect Agent in your local environment, for example,
mywinsystem:8080. Use the port specified in the agent configuration.
For accessing the SOAP or REST API of a web service through the EnterpriseConnect Agent without using an adapter, specify the provider host and port of the web service, for example,
Authentication scheme: Select Login/Password and specify the user and password as defined in the agent configuration and in the domain you created for EnterpriseConnect in RunMyProcess DigitalSuite.
You can also select None for the authentication scheme. In this case, the user and password defined for the domain you specify is used by default.
Use Secure Enterprise Connector: Select this check box.
- With domain: Enter the domain you created for EnterpriseConnect
Based on the new provider, you can now create connectors for testing your EnterpriseConnect installation and accessing local resources through the individual adapters.
Testing the EnterpriseConnect Installation
To test your EnterpriseConnect installation:
In My Connectors on the Connectors tab, define a new connector for your project based on the provider created before.
Specify a Title of your choice, for example,
EnterpriseConnect Get Status, and specify the following information:
- Provider: Select the provider you created. Do not check the Danymic endpoint option.
- Provider url: The URL of the EnterpriseConnect Agent as specified for the provider,
- Connector url: Leave this field empty to test the adapter.
- Architecture: Select REST/XML-RPC
- Method: Select GET
- Result format: Select JSON
- Accept media type: Select application/json
To execute the test, click the Launch Test link above the dialog, then click the Launch test button.
If everything works as desired, the result will be something like the following:
The EnterpriseConnect Agent 2.n.n is running! Registered Adapters: FTP 2.n.n, fileReader 2.n.n
Congratulations! You can now call resources on your local servers from your RunMyProcess applications in the Cloud!
If problems occur or the test does not return the expected result, proceed as described under Troubleshooting.
Accessing Local Resources from RunMyProcess DigitalSuite
After you have successfully tested your EnterpriseConnect installation, you can use it to work on the local resources from your projects in RunMyProcess DigitalSuite.
To do this, you need to define additional connectors for the projects using the provider you have defined.
The connector parameters depend on the type of resource you intend to access, the EnterpriseConnect adapter to be used, and the operations to be carried out:
When working with adapters: Always select REST/XML-RPC as the architecture for the connector and leave the Connector url field empty. Specify further parameters as described in detail for the individual adapters.
When directly addressing the SOAP or REST API of a web service through the EnterpriseConnect Agent without using an adapter: Select the appropriate architecture (SOAP or REST/XML-RPC), and specify the URL and parameters required by the API.
Note: You can only use SOAP via HTTP. SOAP via SMTP is not supported by EnterpriseConnect.