Discover how a bimodal integration strategy can address the major data management challenges facing your organization today.
Get the Report →Access Workday Data from MySQL in PHP
Connect to Workday through the standard MySQL libraries in PHP.
You can use the CData SQL Gateway and ODBC Driver for Workday to access Workday data from MySQL clients, without needing to perform an ETL or cache data. Follow the steps below to connect to Workday data in real time through PHP's standard MySQL interfaces, mysqli and PDO_MySQL.
Connect to Workday Data
If you have not already done so, provide values for the required connection properties in the data source name (DSN). You can use the built-in Microsoft ODBC Data Source Administrator to configure the DSN. This is also the last step of the driver installation. See the "Getting Started" chapter in the help documentation for a guide to using the Microsoft ODBC Data Source Administrator to create and configure a DSN.
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.
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.
Configure the SQL Gateway
See the SQL Gateway Overview to set up connectivity to Workday data as a virtual MySQL database. You will configure a MySQL remoting service that listens for MySQL requests from clients. The service can be configured in the SQL Gateway UI.
Connect in PHP
The following examples show how to use object-oriented interfaces to connect and execute queries. Initialize the connection object with the following parameters to connect to the virtual MySQL database:
- Host: Specify the remote host location where the service is running. In this case "localhost" is used for the remote host setting since the service is running on the local machine.
- Username: Specify the username for a user you authorized on the SQL Gateway's Users tab.
- Password: Specify the password for the authorized user account.
- Database Name: Specify the system DSN as the database name.
- Port: Specify the port the service is running on; port 3306 in this example.
mysqli
<?php $mysqli = new mysqli("localhost", "user", "password", "CData Workday Sys","3306"); ?>
PDO
<?php $pdo = new PDO('mysql:host=localhost;dbname=CData Workday Sys;port=3306', 'user', 'password'); ?>
Query in PHP
With the connection established, you can then access tables. The following steps walk through the example:
- Query the table; for example, Workers. The results will be stored as an associative array in the $result object.
- Iterate over each row and column, printing the values to display in the PHP page.
- Close the connection.
mysqli
$result = $mysqli->query("SELECT Worker_Reference_WID, Legal_Name_Last_Name FROM Workers WHERE Legal_Name_Last_Name = 'Morgan'"); while($row = $result->fetch_assoc()) { foreach ($row as $k=>$v) { echo "$k : $v"; echo "<br>"; } } $mysqli->close();
PDO
$result = $pdo->query("SELECT Worker_Reference_WID, Legal_Name_Last_Name FROM Workers WHERE Legal_Name_Last_Name = 'Morgan'"); while($row = $result->fetch(PDO::FETCH_ASSOC)) { foreach ($row as $k=>$v) { echo "$k : $v"; echo "<br>"; } } $result = null; $pdo = null;