Build Workday-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 Cloud, you gain effortless no-code access to Workday data for streamlined app development. This article guides you through the integration process from Bubble to Workday using CData Connect Cloud.

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

Getting Started

---

Connect to Workday from Bubble

To work with Workday data from Bubble, we need to connect to Workday from Connect Cloud, provide user access to the connection, and create OData endpoints for the Workday data.

(Optional) Add a New Connect Cloud User

As needed, create Users to connect to Workday through Connect Cloud.

1. Navigate to the Users page and click Invite Users
2. Enter the new user's email address and click Send to invite the user
3. You can review and edit users from the Users page

Add a Personal Access Token

If you are connecting from a service, application, platform, or framework that does not support OAuth authentication, you can create a Personal Access Token (PAT) to use for authentication. Best practices would dictate that you create a separate PAT for each service, to maintain granularity of access.

1. Click on your username at the top right of the Connect Cloud app and click User Profile.
2. On the User Profile page, scroll down to the Personal Access Tokens section and click Create PAT.
3. Give your 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.

Connect to Workday from Connect Cloud

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

1. Log into Connect Cloud, click Connections and click Add Connection
2. Select "Workday" from the Add Connection panel
3. Enter the necessary authentication properties to connect to Workday.

   To connect to Workday, users need to find the Tenant and BaseURL and then select their API type.

   Obtaining the BaseURL and Tenant

   To obtain the BaseURL and Tenant properties, log into Workday and search for "View API Clients." On this screen, you'll find the Workday REST API Endpoint, a URL that includes both the BaseURL and Tenant.

   The format of the REST API Endpoint is: https://domain.com/subdirectories/mycompany, where:

   • https://domain.com/subdirectories/ is the BaseURL.
   • mycompany (the portion of the url after the very last slash) is the Tenant.
   For example, in the REST API endpoint https://wd3-impl-services1.workday.com/ccx/api/v1/mycompany, the BaseURL is https://wd3-impl-services1.workday.com and the Tenant is mycompany.

   Using ConnectionType to Select the API

   The value you use for the ConnectionType property determines which Workday API you use. See our Community Article for more information on Workday connectivity options and best practices.

   API	ConnectionType Value
   WQL	WQL
   Reports as a Service	Reports
   REST	REST
   SOAP	SOAP

   
   

   Authentication

   Your method of authentication depends on which API you are using.

   • WQL, Reports as a Service, REST: Use OAuth authentication.
   • SOAP: Use Basic or OAuth authentication.

   See the Help documentation for more information on configuring OAuth with Workday.

   
4. Click Create & Test
5. Navigate to the Permissions tab in the Add Workday Connection page and update the User-based permissions.

Configure Workday Endpoints for Bubble

After connecting to Workday, create a workspace and virtual dataset for your desired table(s).

1. Navigate to the Virtual Datasets 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 Workday connection (e.g. Workday1) 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 and Workspace configured, you are ready to connect to Workday data from Bubble.

Build a Workday-Connected App

With OData endpoints added to Connect Cloud, you can build an app in Bubble with live access to Workday data.

Configure the Bubble API Connector

To start, Configure the API Connector for accessing CData Connect Cloud 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 Cloud user (e.g. [email protected])
   • Set Password to the PAT for the above 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}/Workers)
   
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 Workday 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 Cloud - API Call's value" (or equivalent)
6. Click "Preview" to ensure the data was retrieved from Workday.

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

Live Access to Workday Data from Cloud Applications

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

To get live data access to 100+ SaaS, Big Data, and NoSQL sources directly from your cloud applications, see the CData Connect Cloud.