FireDAC Components for Xero

Build 23.0.8839


General Changes

  • 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.
  • Deprecated SwitchTenant stored procedure. To switch tenants dynamically, specify the desired TenantId in a WHERE clause on individual queries instead.
  • Added the new sys_lastresultinfo system table.
  • Added CreateReportSchema stored procedure to save a dynamic Profit and Loss report as a view.
  • Removed support for the SELECT INTO CSV statement. The core code doesn't support it anymore.
  • Added DownloadPDF stored procedure to download documents from Invoices, CreditNotes, and Quotes table in PDF format.

  • Added DownloadPDF stored procedure to download documents from Invoices, CreditNotes, and Quotes table in PDF format.
  • Added bulk INSERT support for tables which model line items in PayrollAUS and Accounting data models. These are: BankTransactions, ManualJournals, PaySlipDeductions, PaySlipEarnings, PaySlipLeaveAccrual, PaySlipReimbursements, PaySlipSuperAnnuations, PaySlipTaxes, PayslipTimesheetEarnings, and Timesheets.
  • Added CUD operation support for PaySlip line item tables in PayrollAUS data model.
  • Added the Default column to the sys_procedureparameters table.
  • Added the IsPath column to the sys_procedureparameters table.
  • Added the OAuthClient AuthScheme for Xero custom connections. These are machine-to-machine OAuth applications that authenticate using OAuthClientId and OAuthClientSecret. Unlike normal apps they are specific to an organization and do not require user interaction.
  • Added an embedded OAuth application that can be used from all editions, not just within Connect and other hosted apps. This required changing the default AuthScheme to PKCE because the new app uses PKCE for security.
  • Added columns for compliance with STP-related changes in PayrollAUS. This affects Employees, PayItemsEarnings and PaySlipEarnings. Note that this does not include any changes related to cashing out leave as those are still in development within Xero.
  • Added support for querying payslip line-item tables in the PayslipAus schema (PayslipEarnings, PaySlipDeductions, etc.) without requiring that a PayslipID be present in the WHERE clause. If no PayslipID is given then the relevant line item type will be retrieved from all payslips.
  • Added support for reading all allocations from credit notes, prepayments and overpayments. These are exposed as the new tables CreditNoteAllocations, PrepaymentAllocations and OverpaymentAllocations.
  • Added support for transactions.
  • Removed embedding of the VC++ runtime. Users will need to install the Microsoft Visual C++ 2010 x64/x86 Redistributable going forward.
  • Added foreign key metadata to the table definitions across all supported APIs.
  • Added support for reporting API limits via the GetLimitInfo stored procedure. This procedure can be called to report the last known API limits (minute, daily and app) for any tenant that has been queried on the current connection. It also reports the suggested retry delays in case applications want to handle long-term daily and app retries.
  • 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.
  • 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 Framework 3.5.
  • Added support for the TenantId pseudo-column, which can be used as an alternative to the SwitchTenant to query an organization different than the one the connection was configured for. DML isn't supported but queries work, including sliced queries and queries which split the filter across multiple contexts like SELECT * FROM Contacts UNION SELECT * FROM Contacts WHERE TenantId = '...'
  • Added support for the OrganisationActions view, which lists out special permissions granted to the current OAuth app within the organisation it is connected to.
  • Added support for accessing the Budgets and BudgetLines APIs within Accounting.
  • 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.
  • Updated implicit and metadata caching to improve performance and support for multiple connections. Old metadata caches are not compatible - you need to generate new metadata caches if you are currently using CacheMetadata.
  • Added support for using WHERE filters inside of PayrollAus. This has been a long-standing limitation due to limited support for server-side WHERE, but we now annotate each table supporting that parameter explicitly. Most of the non-report and non-history tables in Accounting have this option in addition to these tables from PayrollAus:
    • Employees
    • LeaveApplications
    • PayrollCalendars
    • PayRuns
    • SuperFunds
    • Timesheets
  • Made extesnsions to XML aggregate support now that column#1, column#2 syntax is deprecated
    • Added insert aggregate support to ContactGroups, ExpenseClaims and LeaveApplications
    • Added support for using aggregates when a row ID is provided. This is intended to allow queries like (1), which used to be the recommended way to insert multiple line items onto an existing entity.
    • Added support for using aggregates in UPDATE. When given this way, the provider will overwrite any existing line items with the content of the aggregate.
  • Everything to do with OAuth1 support is gone. Xero is going to remove it from their service at the end of the Mar 2021.
  • Removed the certificate store properties, they no longer exist even as hidden properties since none of the OAuth2 flows need them.
  • Removed the MigrateOAuth1Token procedure, that API will stop working when the rest of the OAuth1 functionality does so there's no reason to keep it.
  • It is no longer possible to use OAuth1 by specifying AuthScheme=Auto and providing the XeroAppAuthentication properties via Other.
  • Deprecated OAuth2 as an AuthScheme, it is now called OAuth
  • Added support for revoking tenants using the RevokeTenant stored procedure.

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