Build Sage 300-Connected Apps in Bubble

Bubble is a no-code platform that simplifies the process of developing and launching apps and businesses. When coupled with CData Connect AI, you gain effortless no-code access to Sage 300 data for streamlined app development. This article guides you through the integration process from Bubble to Sage 300 using CData Connect AI.

CData Connect AI provides a pure cloud-to-cloud OData interface for Sage 300 data that allows you to integrate from Bubble to Sage 300 data in real time.

Connect to Sage 300 from Bubble

To work with Sage 300 data from Bubble, we need to connect to Sage 300 from Connect AI, provide user access to the connection, and create a Workspace for the Sage 300 data.

Connect to Sage 300 from Connect AI

CData Connect AI uses a straightforward, point-and-click interface to connect to data sources.

1. Log into Connect AI, click Sources, and then click Add Connection

2. Select "Sage 300" from the Add Connection panel

3. Enter the necessary authentication properties to connect to Sage 300.

   Sage 300 requires some initial setup in order to communicate over the Sage 300 Web API.

   • Set up the security groups for the Sage 300 user. Give the Sage 300 user access to the option under Security Groups (per each module required).
   • Edit both web.config files in the /Online/Web and /Online/WebApi folders; change the key AllowWebApiAccessForAdmin to true. Restart the webAPI app-pool for the settings to take.
   • Once the user access is configured, click https://server/Sage300WebApi/ to ensure access to the web API.

   Authenticate to Sage 300 using Basic authentication.

   Connect Using Basic Authentication

   You must provide values for the following properties to successfully authenticate to Sage 300. Note that the provider reuses the session opened by Sage 300 using cookies. This means that your credentials are used only on the first request to open the session. After that, cookies returned from Sage 300 are used for authentication.

   • Url: Set this to the url of the server hosting Sage 300. Construct a URL for the Sage 300 Web API as follows: {protocol}://{host-application-path}/v{version}/{tenant}/ For example, http://localhost/Sage300WebApi/v1.0/-/.
   • User: Set this to the username of your account.
   • Password: Set this to the password of your account.
   
4. Click Save & Test
5. Navigate to the Permissions tab in the Add Sage 300 Connection page and update the User-based permissions.

Add a Personal Access Token

When connecting to Connect AI through the REST API, the OData API, or the Virtual SQL Server, a Personal Access Token (PAT) is used to authenticate the connection to Connect AI. It is best practice to create a separate PAT for each service to maintain granularity of access.

1. Click on the Gear icon () at the top right of the Connect AI app to open the settings page.
2. On the Settings page, go to the Access Tokens section and click Create PAT.
3. Give the PAT a name and click Create.
4. The personal access token is only visible at creation, so be sure to copy it and store it securely for future use.

Configure Sage 300 Endpoints for Bubble

After connecting to Sage 300, create a workspace for your desired table(s).

1. Navigate to the Workspaces page and click Add to create a new Workspace (or select an existing workspace).
2. Click Add to add new assets to the Workspace.
3. Select the Sage 300 connection (e.g. Sage3001) and click Next.
4. Select the table(s) you wish to work with and click Confirm.
5. Make note of the OData Service URL for your workspace, e.g. https://cloud.cdata.com/api/odata/{workspace_name}

With the connection, PAT, and Workspace configured, you are ready to connect to Sage 300 data from Bubble.

Build a Sage 300-Connected App

With OData endpoints added to Connect AI, you can build an app in Bubble with live access to Sage 300 data.

Configure the Bubble API Connector

To start, Configure the API Connector for accessing CData Connect AI from Bubble.

1. In your app, click the Plugins tab and click Add plugins
2. Search for "API Connector" and click Install
3. After installation, click the "Add another API" button and configure the API:
   • Name the API
   • Set Authentication to "HTTP Basic Auth"
   • Set Username to a Connect AI user (e.g. [email protected])
   • Set Password to the PAT for the user
   • Expand the API Call, select the "GET" command and set the URL to a Workspace endpoint you previously configured (e.g. https://cloud.cdata.com/api/odata/{workspace_name}/OEInvoices)
   
4. Click the "Initialize call" button to adjust data types in the response (as needed)
5. After making any necessary changes, click "Save"

Configure the App UI

With the API Connector configure, you are ready to retrieve Sage 300 data in your Bubble app. In this article, we request the data with a UI component that can display an Excel-like table.

1. On the Plugin tab, install the "Excel-like HandsonTable"
2. On the Design tab, add an "Excel Table" to the workspace
3. In the Excel Table, in Data source, select "Get data from an external API"
4. Set Type of content to "API Call value"
5. Set Data source to "CData Connect AI - API Call's value" (or equivalent)
6. Click "Preview" to ensure the data was retrieved from Sage 300.

At this point, you can develop applications with live access to Sage 300 data without needing to know the complexities of the back-end API.

Live Access to Sage 300 Data from Cloud Applications

Now you have a direct connection to live Sage 300 data from Bubble. You can create more Sage 300-connected apps — all without writing any code or replicating Sage 300 data.

To get live data access to hundreds of SaaS, Big Data, and NoSQL sources directly from your cloud applications, see the CData Connect AI.