Excel Add-In for ServiceNow

Build 23.0.8839


General Changes

  • Added support for dialect SELECT queries in UI, VBA, and UDF =CDATAQUERY function.
  • The ROUND function doesn't accept the negative precision values anymore.

  • 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.
  • Added DisplayValueColumnName property, which takes a pattern value to format column names for display values when DisplayValue=ALL. By default, the value of the property is '{0}_display_value'.
  • Added the new sys_lastresultinfo system table.
  • Added the ability to cancel an in-progress test connection in the Connection Dialog Box.
  • Removed support for the SELECT INTO CSV statement. The core code doesn't support it anymore.
  • Added UploadAttachment as a stored procedure. UploadAttachment can be used to upload a file as an attachment to a specified record. The SP outputs the generated metadata from the uploaded file.
  • Added DownloadAttachment as a stored procedure. DownloadAttachment can be used to download a file attachment from a specific record.
  • Added the Default column to the sys_procedureparameters table.
  • Added the IsPath column to the sys_procedureparameters table.
  • 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.
  • Improved the User Experience of the Connection Editor by introducing a Basic tab for the most imporant connection properties.
  • Added support for server-side GROUP BY, HAVING, IS NULL, IS NOT NULL and aggregate functions such as: min, max, avg, sum, count.
  • The new OAuthPassowrd authentication method has been added, which will replace the GrantType Password functionality. OAuthPassword requires OAuthClientId, OAuthClientSecret, Username, and Password.

  • OAuthGrantType has been deprecated. Use AuthScheme instead.

  • Column sizes reported by the ServiceNow Metadata API for the columns of type STRING are not taken into consideration anymore because the endpoint is unreliable.
  • Changed the behavior so that auto-refreshing continues even if the worksheet is not active anymore or loses focus.
  • Added support for inserting rows on tables when no primary key is defined on a given table.
  • 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.

  • 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.
  • Added batch support for CDATAINSERT, CDATAUPDATE, and CDATADELETE user-defined functions.
  • Added support to expose the ServiceNow database views as views when the the IncludeDatabaseViews connection property is set to true.
  • 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.

  • Improved performance when loading data from Get Data/Refresh and the CDATAQUERY function.
  • Added support for Single Sign On (SSO) connection with PingFederate as the Identity Provider (IdP).
  • Added new VBA functions: GetLastErrorCode and GetLastError.
  • Added new VBA functions: GetUpSertedRows, UpSertRows, UpSertAll and UpSert.

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

  • The "Add Rows" button has been removed.
  • Added the GetColumnsMetadata connection property, which controls when and how the driver should get the columns metadata. When setting it to 'OnUse', the driver will execute the table specific metadata calls the first time the table is referenced, provided the metadata for the table in question aren't already cached.
  • 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 the maximum characters that a cell can retreive from the data source from 8,192 to 32,767.
  • Added support for the STRING_SPLIT table-valued function in the CROSS APPLY clause.
  • Added the KeySeq column to the sys_foreignkeys table.
  • Added the new sys_primarykeys system table.
  • You can sort and reorder columns on the "CData Query" form to alter the sort order.
  • 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.
  • 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.
  • 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.
  • Added the ability to move the columns up and down on the "CData Query" form grid view and change their order via the UI.
  • Added the default parameter "showPopups" so the user may decide whether to show popups when calling VBA functions.
  • 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.
  • Added support for handling client side formulas during insert / update. For example: UPDATE Table SET Col1 = CONCAT(Col1, " - ", Col2) WHERE Col2 LIKE 'A%'
  • Updated how display sizes are determined for varchar primary key and foreign key columns so they will match the reported length of the column.
  • Non-conditional updates between two columns is now available to all drivers. For example: UPDATE Table SET Col1=Col2
  • Reduced the length to 255 for varchar primary key and foreign key columns.

  • Updated index naming convention to avoid duplicates.
  • Deprecated Instance connection property.

  • The URL connection property replaces the Instance connection property. The user should now set the base URL of the ServiceNow instance site, instead of the instance Id. For example: https://MyInstance12345.service-now.com.
  • 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.
  • Deprecated SSOUser, SSOPassword, SSOProvider, OktaAppEmbedLink and OKTAApiToken connection properties.

  • User and Password replaces SSOUser and SSOPassword.
  • Authscheme replaces SSOProvider.
  • SSOLoginURL replaces OktaAppEmbedLink as it is more generic and applicable to other SSO providers.
  • ApiToken replaces OKTAApiToken as it is more generic and applicable to other SSO providers.
  • Implemented user awareness during the upgrade process from 2019 to 2020 or 2021 editions.
  • Added the "is null" and "is not null" filters on the "CData Query" form.

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 23.0.8839