Excel Add-In for Salesforce

Build 25.0.9434

Changelog

General Changes

DateBuild
Number		Change
Type		Description
10/24/20259428SalesforceChanged
  • Changed queries such as: SELECT TableA.a, TableB.a FROM TableA INNER JOIN TableB where multiple columns have the same name, so that the columns now retain the same name in the result set. They can be differentiated by using their positional index. We recommend setting aliases for the columns for differentiation at a glance.
10/17/20259421SalesforceAdded
  • Added the Search stored procedure. This stored procedure executes a global search of your organization's data. It can perform a simple plain text or an advanced SOSL query search. It returns a JSON response from the API.
10/06/20259410GeneralAdded
  • Support for parsing datetime formats using ".S" and ",S" for milliseconds and nanoseconds.
09/16/20259390SalesforceAdded
  • Added the GetDefinitions pseudocolumn to the Formulas view.
09/15/20259389SalesforceDeprecated
  • The ColumnDelimiter column in the JobRecordResultsV2 view has been deprecated.
09/12/20259386GeneralAdded
  • Added the IsInsertable, IsUpdateable, and IsDeleteable columns to the sys_tables table.
09/10/20259384GeneralChanged
  • All columns in statically defined Views are now reported as read-only.
09/05/20259379SalesforceAdded
  • Added support for a new property, PushEmptyValuesAsNull. This property specifies how empty values returned by Bulk API v2 queries are handled. This is a breaking change for queries returning empty rows.
    • When set to true (default), empty values are pushed as NULL.

Changed
  • The default behavior when returning empty rows changed.
    • When set to false, empty values are pushed as empty strings for VARCHAR columns and 0 for numeric fields.
09/03/20259377GeneralChanged
  • Corrected the behavior when IN criteria with NULL values are used in the projection part. It now returns NULL instead of 0. For example, "NULL IN (1,2)" returns "NULL".
09/01/20259375GeneralAdded
  • Added support for using the CAST function with infinity values. This function can cast "inf" and "-inf" to DOUBLE, FLOAT, or REAL.
08/21/20259364GeneralChanged
  • Report behavior change:
    • Fixed inconsistent string value comparisons in non-table queries.
    • For example, "SELECT 'A' = 'a'" previously returned false, but it now returns true.
08/15/20259358SalesforceAdded
  • Added the Scope connection property.
08/13/20259356GeneralChanged
  • Changed the maximum number of pages held in memory from 15 to 5 for the page providers to decrease heap usage.
07/18/20259330SalesforceRemoved
  • Removed the OAuthGrantType property. The grant type is now set implicitly through the 'AuthScheme' property. For example, you can use the 'OAuthPassword' AuthScheme instead of AuthScheme=OAuth with OAuthGrantType=Password.
07/11/20259323SalesforceChanged
  • Changed the default BulkAPIVersion to v2.

Removed
  • Removed the BatchId from the LastResultInfo temporary table in v2. Results from the bulk operation can still be retrived by executing GetJobRecordResultsV2 and by retrieving the JobId from LastResultInfo#TEMP or Info#TEMP.

Added
  • Added IsCalculated field to the sys_tablecolumns table to indicate whether a Salesforce column is a calculated field.
07/02/20259314SalesforceAdded
  • Added support for a new stored procedure, QueryParallelResultsV2.
06/25/20259307GeneralRemoved
  • Removed the "ADLS Gen 1" value from the ConnectionType property.
06/20/20259302GeneralAdded
  • Created the following functions:
    • TEXT_ENCODE: encodes a string into a different charset (UTF8 → UTF7 and returns a binary array as the result).
    • TEXT_DECODE: takes a binary array and decodes it back into a string when provided the charset.
    • BASE64_ENCODE: takes a binary array and encodes it as a base64 string (varchar).
    • BASE64_DECODE: takes a base 64-encoded string and decodes it into a binary array.
06/18/20259300GeneralChanged
  • The internal code for exception handling has been refactored. Exception messages returned during certain error conditions may now have different wording or formatting.
06/17/20259299SalesforceAdded
  • Added IsTimeCheckColumn and CanOrderTimeCheckColumn columns to sys_tablecolumns table. TimeCheckColumns are now listed last when getting metadata, changing the ordering of columns.
06/16/20259298SalesforceAdded
  • Added the TriggerAutoResponseEmail, TriggerOtherEmail, and TriggerUserEmail pseudocolumns to the Case, CaseComment, Contact and User tables.
05/27/20259278GeneralRemoved
  • Removed the "Proprietary" enum option from ProxyAuthscheme.
05/27/20259278ExcelRemoved
  • Removed support for the C# implementation of SQLite. Features that previously used this implementation by default, such as AutoCache and EF6 schema caching, now require the native SQLite driver.
05/09/20259260SalesforceChanged
  • Various views no longer report a primary key.
  • Various tables have been changed into read-only views.
05/05/20259256SalesforceAdded
  • Added support for a new stored procedure, GetBatchRecords. This stored procedure returns the original rows submitted for a V1 batch.
04/15/20259236SalesforceChanged
  • The default version of the Salesforce API used by the driver (set in the APIVersion connection property) has changed from 62.0 to 63.0.
03/21/20259211SalesforceAdded
  • Added the IncludeItemURL connection property. When set to 'true', this connection property exposes an ItemURL column for a subset of tables. This column shows the resource URL from the UI for the entity represented by the table. The default value for this property is 'false'.
02/18/20259180SalesforceAdded
  • Added a new connection property, NullBooleanBehavior. This property specifies how the driver treats Boolean columns where the value is null. Permitted options are:
    • IGNORE: The driver ignores the mull value for CUD operations; for SELECT operations, the driver compares it with the null value. (Default)
    • FALSE: The null value is converted to False for CUD operations and SELECT operations.
02/15/20259177GeneralAdded
  • Added support for converting unsigned integer types to the nearest signed data type that has enough precision to hold the unsigned value.This is done for JDBC only because it does not have support for unsigned data types.
01/29/20259160SalesforceAdded
  • Added the DefaultedOnCreate column to the sys_tablecolumns system table.
12/12/20249112SalesforceAdded
  • Added the BulkAPIVersion connection property. This property controls the version of the Bulk API used by the driver. The default is v1.
  • Added support for the Ingest API v2. To use this API, set BulkAPIVersion to v2.

Changed
  • The default version of the Salesforce API used by the driver (set in the APIVersion connection property) has changed from 61.0 to 62.0.
12/09/20249109SalesforceAdded
  • Added the PKCEVerifier output field to the GetOAuthAuthorizationUrl and GetOAuthAccessToken stored procedures. This output contains an auto-generated PKCE Verifier.
11/27/20249097GeneralAdded
  • Added ThreadId to LogModule output. Logfile lines now include the Thread ID associated with the action being performed.
09/06/20249015SalesforceChanged
  • Changed the default API version to 61.
06/27/20248944SalesforceAdded
  • Added a new connection property called "TranslatePickListFields", which toggles translation of PickList fields into the user's language.
05/09/20248895GeneralChanged
  • The ROUND function previously did not accept negative precision values. That feature has now been restored.
03/28/20248853SalesforceAdded
  • Added a new stored procedure, CreateCustomField, which enables the creation of new custom field components within an organization.
03/20/20248845SalesforceAdded
  • Added two new stored procedures GetJobInfoV2 and QueryResultsV2.
03/15/20248840GeneralAdded
  • Created a new SQL function called STRING_COMPARE that provides java's String.compare() ability to SQL queries. Returns a number representative of the compared value of two strings
02/17/20248813SalesforceAdded
  • FileStream input was added for the DownloadAttachment and DownloadDocument stored procedures, it can be used to download the content into an input stream.
  • Content was added for UploadAttachment, UploadContentDocument and UploadDocument stored procedures, it can be used to upload the content from a stream.
02/15/20248811SalesforceAdded
  • Added support for the 'QueryMode' input in the QueryBatch stored procedure. This feature enables users to execute either a SQL or SOQL query using this stored procedure.
12/31/20238765ExcelAdded
  • Added support for dialect SELECT queries in UI, VBA, and UDF =CDATAQUERY function.
12/26/20238760SalesforceAdded
  • Added support for OAuthPKCE (Authorization Code Flow with Proof Key for Code Exchange).
11/29/20238733GeneralChanged
  • The ROUND function doesn't accept the negative precision values anymore.

Changed
  • The returning types of the FDMonth, FDQuarter, FDWeek, LDMonth, LDQuarter, LDWeek functions are changed from Timestamp to Date.
  • The return type of the ABS function will be consistent with the parameter value type.
11/28/20238732GeneralAdded
  • Added the HMACSHA256 formatter to allow for secrets to be decoded if it is in base64 format
11/14/20238718SalesforceAdded
  • Added the 'QueryBatchId' and 'QueryJobId' outputs in the QueryBatch stored procedure.

Removed
  • The 'Id' output corresponding to the batch ID in the QueryBatch stored procedure has been removed. To get the id of the batch use the new 'QueryBatchId' output instead.
11/08/20238712SalesforceAdded
  • Added the IsUpdateable, IsCreateable columns in sys_tablecolumns table which indicate whether the fields can be edited/created.
10/20/20238693SalesforceRemoved
  • The 'CreateReportSchema' and 'GetCustomReport' stored procedures have been removed and can no longer be used.

Replacements
  • We have changed and improved support for querying Salesforce reports. The 'CreateReportSchema' and 'GetCustomReport' stored procedures have been removed and cannot longer be used. To query Salesforce reports set the IncludeReports property to true and query the reports as normal tables. The new feature supports additional report types such as SUMMARY, MATRIX reports.

Added
  • Added support for IncludeReports property, which indicates if salesforce reports should be exposed as views.
  • Added support for IsReport column in sys_tables table which indicates if a view is a Salesforce report.
10/06/20238679SalesforceAdded
  • Added the InLineHelpText column in sys_tablecolumns table which outputs the user-defined help text information for each of the fields.
10/05/20238678SalesforceChanged
  • Changed the default Salesforce API Version to 58.

Added
  • Added support for eight new PK Chunking-Enabled Objects with Bulk API and Bulk API 2.0 as of v57.0: CaseRelatedIssue, ChangeRequestRelatedIssue, ChangeRequestRelatedItem, Contract, Entitlement, IncidentRelatedItem, ProblemIncident, ProblemRelatedItem.
08/02/20238614SalesforceAdded
  • Added support for FileId, Success, and FailureMessage outputs in the download stored procedures. These outputs are helpful in showing the status of each download in multi-file downloads.
06/20/20238571GeneralAdded
  • Added the new sys_lastresultinfo system table.
05/29/20238549SalesforceRemoved
  • Removed the ContentType input of the GetBatchResults stored procedure. The driver automatically resolves the content type.
05/23/20238543SalesforceRemoved
  • Removed the SOQL input of the CreateSchema stored procedure. Instead, for running SOQL queries directly, the QueryPassthrough connection property should be set to true.
05/10/20238530ExcelAdded
  • Added the ability to cancel an in-progress test connection in the Connection Dialog Box.
05/02/20238522SalesforceAdded
  • Added support for the ‘EmptyValueBehavior’ hidden connection property which takes two values: ‘ConvertEmptyStringsToNull’ and ‘IgnoreEmptyValue’.The property impacts CUD statements when UseBulkAPI = true.'ConvertEmptyStringsToNull' is the default behavior which updates/creates a field value to NULL if the user has specified an empty string or NULL value,while 'IgnoreEmptyValue' will consider empty string values and NULL as no change made to the field's value.
04/26/20238516SalesforceChanged
  • The BulkPageSize connection property has been marked as hidden. To continue using this property, you should append it to the Other connection property
04/25/20238515GeneralRemoved
  • Removed support for the SELECT INTO CSV statement. The core code doesn't support it anymore.
01/06/20238406SalesforceAdded
  • Added support for RemoveBOMCharacter hidden connection property which if set to true, is used to remove the BOM character from the content.
12/14/20228383GeneralChanged
  • Added the Default column to the sys_procedureparameters table.
12/13/20228382SalesforceAdded
  • Added the IsQueryable column in sys_tables table which is useful to differentiate queryable objects when the ExposeNonQueryable connection property is set to true.
12/09/20228378SalesforceRemoved
  • Removed the OutputFolder parameter for the CreateReportSchema stored procedure. The Location connection property must be used to set the output directory for writing schemas to a file.

Added
  • Added the WriteToFile parameter for the CreateReportSchema and CreateSchema stored procedures. It defaults to true and specifies whether to write the contents of the generated schema to a file or not. Set it to false to write the schema to FileStream or FileData.
11/25/20228364SalesforceAdded
  • Added support for ExposeConceptualEntities connection property which is used to expose Salesforce objects' record types as tables.
11/18/20228357SalesforceAdded
  • Added support for ReplaceInvalidUTF8Chars connection property which is used to replace invalid UTF8 characters with a '?'.
11/11/20228350SalesforceDeprecated
  • The SOQL input of the CreateSchema stored procedure has been deprecated and will be removed in the next version.Instead, for running SOQL queries directly, the QueryPassthrough connection property should be set to true.
11/04/20228343SalesforceChanged
  • We have updated our SQL joins validation logic. We internally resolve and translate more SQL joins into salesforce relationship queries for faster and better performance.
10/27/20228335SalesforceChanged
  • Changed the default Salesforce API Version to 56.
10/17/20228325SalesforceAdded
  • Added support for retrieving PickListValues only for a specific record type. RecordTypeId should be specified in the WHERE clause along TableName.
09/30/20228308GeneralChanged
  • Added the IsPath column to the sys_procedureparameters table.
09/28/20228306ExcelAdded
  • Added a config file option STATUSBAR_UPDATE=TRUE. This indicates whether the Excel Add-In will update the Excel Status Bar with progress status on completed tasks. The default value is TRUE. This way, there is the option to NOT update the Status Bar by setting it to FALSE.
09/28/20228306SalesforceAdded
  • Added the IsIdLookup column in sys_tablecolumns table.
09/20/20228298SalesforceAdded
  • Added the ContentDocumentId output for the UploadContentDocument stored procedure.
09/14/20228292ExcelChanged
  • Improved the User Experience of the Connection Editor by introducing a Basic tab for the most imporant connection properties.
09/13/20228291SalesforceAdded
  • Added an option for directly executing SOQL queries. This mode is enabled by setting QueryPassthrough to true.
09/07/20228285SalesforceAdded
  • Added the State output for the GetJobBatchIds stored procedure and JobId output for the CreateBatch, GetBatch stored procedures.
08/26/20228273SalesforceAdded
  • Added the UseToolingAPI connection property.
08/25/20228272SalesforceAdded
  • Added the SupportNativeDataType connection property which if set to true, will report types using the original Salesforce data type with no translation to the generic type.
08/24/20228271SalesforceChanged
  • Changed the default Salesforce API Version to 55.
05/19/20228174SalesforceDeprecated
  • The OAuthGrantType connection property has been deprecated.

Replacements
  • The AuthScheme connection property will be used as a replacement for OAuthGrantType. Its new option OAuthPassword replaces OAuthGrantType=PASSWORD while OAuth replaces OAuthGrantType=CODE.
05/10/20228165SalesforceAdded
  • Added the Encoding input and FileData output for the DownloadAttachment, DownloadContentDocument, DownloadDocument stored procedures.
04/08/20228133SalesforceChanged
  • Changed the default Salesforce API Version to 54.
03/17/20228111ExcelChanged
  • Changed the behavior so that auto-refreshing continues even if the worksheet is not active anymore or loses focus.
03/05/20228099ExcelAdded
  • Added support for inserting rows on tables when no primary key is defined on a given table.
02/19/20228085ExcelAdded
  • The button "Get Data -> From ProviderX" now displays a submenu with existing connections buttons and a separator, with the "New ProviderX Connection" button, if a connection exists. If no connections exist, then clicking "Get Data -> From ProviderX" will prompt the user to create a new connection before selecting the data.

Removed
  • In the "Table Selection" form, the "Source", "New Connection", "Connection", and "Edit Connection" fields are removed as they are out of the scope of the "Table Selection" form.
02/09/20228075SalesforceAdded
  • Added support for the PolymorphicColumnsRelationships table, which lists tables and columns details of polymorphic relationships.
02/08/20228074SalesforceAdded
  • Added support for the AggregateCompoundFieldsFormat connection property. This property controls the format of the compound fields that will be aggregated. It accepts two values: JSON(defaut) and NONE.

Changed
  • Changed aggregate compound fields format to JSON for when the connection property AggregateCompoundFields is set to true. The format of the compound fields can be controlled with the AggregateCompoundFieldsFormat connection property.
02/01/20228067SalesforceChanged
  • Changed the default Salesforce API Version to 53.
12/31/20218035ExcelAdded
  • Added batch support for CDATAINSERT, CDATAUPDATE, and CDATADELETE user-defined functions.
12/31/20218035SalesforceChanged
  • Due to a recent improvement we have replaced the instance url format in the OAuthSettings.txt file. If possible, we advise users to remove the existing OAuthSettings.txt file and reissue a new connection.
11/18/20217992SalesforceAdded
  • Added support for persisting the session token retrieved with OKTA MFA. These tokens are short lived and expire after two hours. At that point, the driver will send a request for a new MFAPasscode which should be reissued in a new connection. Retrieve your MFA Token from you phone, email, or other method you have configured with OKTA to handle MFA.
  • Added support for the CredentialsLocation connection property which specifies the location of the settings file where the token retrieved with OKTA MFA is saved. This works the same as the OAuthSettingsLocation.
11/11/20217985ExcelAdded
  • Added a config file option called RETRIEVE_DATA_ROWS_PERCOUNT. When getting data, this indicates how many rows will be populated into the sheet at a time. The default value is 1000.

Changed
  • Improved performance when loading data from Get Data/Refresh and the CDATAQUERY function.
11/03/20217977ExcelAdded
  • Added new VBA functions: GetLastErrorCode and GetLastError.
10/29/20217972ExcelAdded
  • Added new VBA functions: GetUpSertedRows, UpSertRows, UpSertAll and UpSert.

Changed
  • The "Update Rows" button will now update changes made to existing rows or insert newly created rows.

Removed
  • The "Add Rows" button has been removed.
09/28/20217941ExcelAdded
  • When loading data, table columns are auto-fitted to display all cells' content. In cases when cells have large amounts of text and the table has many rows, this operation might be slow.
  • Added a config file option DISABLE_AUTOFIT_COLUMN. Setting DISABLE_AUTOFIT_COLUMN==TRUE will speed up the process in those cases. The default value is FALSE.

Changed
  • Changed the maximum characters that a cell can retreive from the data source from 8,192 to 32,767.
09/02/20217915GeneralAdded
  • Added support for the STRING_SPLIT table-valued function in the CROSS APPLY clause.
08/07/20217889GeneralChanged
  • Added the KeySeq column to the sys_foreignkeys table.
08/06/20217888GeneralChanged
  • Added the new sys_primarykeys system table.
07/26/20217877ExcelAdded
  • You can sort and reorder columns on the "CData Query" form to alter the sort order.
07/23/20217874GeneralChanged
  • Updated the Literal Function Names for relative date/datetime functions. Previously, relative date/datetime functions resolved to a different value when used in the projection as opposed to the predicate. For example: SELECT LAST_MONTH() AS lm, Col FROM Table WHERE Col > LAST_MONTH(). Formerly, the two LAST_MONTH() methods would resolve to different datetimes. Now, they will match.
  • As a replacement for the previous behavior, the relative date/datetime functions in the criteria may have an 'L' appended to them. For example: WHERE col > L_LAST_MONTH(). This will continue to resolve to the same values that were previously calculated in the criteria. Note that the "L_" prefix will only work in the predicate - it not available for the projection.
07/21/20217872ExcelRemoved
  • Removed support for .NET 3.5. Before upgrade/downgrade, a clean uninstall and then the same product versions install should be performed. So, if you want to downgrade, all the downgrade build versions must support .NET 3.5. If you want to upgrade, all the upgrade build versions will drop .NET 3.5 support.
07/13/20217864SalesforceAdded
  • Added support for CUD operations on polymorphic fields.
07/06/20217857ExcelAdded
  • Added a config file option REPLACE_SYSTEM_LOCALE=TRUE. This indicates whether Office culture replaces system locale. The default value is TRUE. This way, there is the option to disable overriding system locale by setting it to FALSE.
06/26/20217847ExcelAdded
  • Added the ability to move the columns up and down on the "CData Query" form grid view and change their order via the UI.
06/24/20217845ExcelAdded
  • Added the default parameter "showPopups" so the user may decide whether to show popups when calling VBA functions.
06/17/20217838SalesforceAdded
  • Added support for OAuth JWT.
06/11/20217832SalesforceChanged
  • Bulk queries use a new downloader when running against API v1. The new downloader downloads and process chunks of result data in parallel and uses temporary files to store data that has not yet been processed. It is both faster and more resilient against slower readers than the previous download mechanism.
  • The BulkAPIVersion property is hidden. It's not recommended for users to set this property since bulk API v2 is slower and has fewer features.
05/21/20217811ExcelAdded
  • A new UI implementation is added for "in" and "not in" filter options on the "CData Query" form. The user is able to select via an interface from a list of distinct column values.
05/20/20217810SalesforceChanged
  • Added support for GETDELETED to the ContentDocument and ContentVersion tables.
04/25/20217785GeneralAdded
  • Added support for handling client side formulas during insert / update. For example: UPDATE Table SET Col1 = CONCAT(Col1, " - ", Col2) WHERE Col2 LIKE 'A%'
04/23/20217783GeneralChanged
  • Updated how display sizes are determined for varchar primary key and foreign key columns so they will match the reported length of the column.
04/16/20217776GeneralAdded
  • Non-conditional updates between two columns is now available to all drivers. For example: UPDATE Table SET Col1=Col2
04/16/20217776GeneralChanged
  • Reduced the length to 255 for varchar primary key and foreign key columns.

Changed
  • Updated index naming convention to avoid duplicates.
04/13/20217773SalesforceChanged
  • The OneLogin method we used previously has been deprecated by OneLogin. We have updated our design to use the latest version of the OneLogin API, which now requires a seperate OAuthClientId and OAuthClientSecret associated with your OneLogin app to be passed in through SSOProperties. The APIKey that was formerly passed in through SSOProperties for OneLogin is removed.
  • OneLogin also no longer uses SSOLoginURL. Instead, Subdomain and AppId should be specified inside the SSOProperties.
04/07/20217767SalesforceAdded
  • Added GetLimitInfo stored procedure.
03/31/20217760SalesforceDeprecated
  • IdpURL, AppEmbedLink, OktaAppEmbedLink, OktaDomain, IdpSystemPassword, SSOUser, SSOPassword, IdPPassword, IdpSystemUserName, IdpUser, OneLoginAPIKey, OktaApiToken, IdpSystemScheme, IdPSystemSSLClientCert, IdPSystemSSLClientCertType, IdPSystemSSLClientCertSubject, IdPSystemSSLClientCertPassword, and SSOTokenURL are deprecated.

Replacements
  • Deprecated the SSOTokenURL connection property. Instead SSOExchangeTokenURL should be used to specify the endpoint for exchanging SAML token with an oauth token.
  • IdpURL is replaced by SSOLoginURL.
  • The OktaDomain longer needs to be specified for any SSO connections as it can be extracted from SSOLoginURL.
  • SSOLoginURL replaces OktaAppEmbedLink and AppEmbedLink as it is more generic and applicable to other SSO providers.
  • SSOUser, SSOPassword, IdpUser, IdpPassword, IdpSystemUserName, IdpSystemPassword are replaced with the User / Password connection properties.
  • OneLoginAPIKey and OktaApiToken are replaced by APIToken.
  • IdPSystemSSLClientCert, IdPSystemSSLClientCertType, IdPSystemSSLClientCertSubject, IdPSystemSSLClientCertPassword are replaced with the standard SSL cert connection properties.
12/30/20207669ExcelAdded
  • Implemented user awareness during the upgrade process from 2019 to 2020 or 2021 editions.
12/18/20207657ExcelAdded
  • Added the "is null" and "is not null" filters on the "CData Query" form.
12/16/20207655SalesforceAdded
  • Added an embedded OAuth app.
12/11/20207650SalesforceAdded
  • Added OrderItemsRest table by implementing the two endpoints from the Place Order REST API: https://developer.salesforce.com/docs/atlas.en-us.api_placeorder.meta/api_placeorder/sforce_placeorder_rest_api_add_orderprod.htm https://developer.salesforce.com/docs/atlas.en-us.api_placeorder.meta/api_placeorder/sforce_placeorder_rest_api_get_details_order.htm The table can be enabled with the EnablePlaceOrderRESTAPI connection property.
11/02/20207611SalesforceChanged
  • Changed the default Salesforce API Version to 50.

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 25.0.9434