Progress DataDirect Cloud™
Progress DataDirect Cloud enables simple, fast connections to cloud and on-premise data regardless of source—SaaS apps, big data stores, or social networks—using a single standards-based ODBC or JDBC driver, or OData enabled application. For example, an organization might want to use a reporting application to predict travel budgets by analyzing travel data stored in the cloud. DataDirect Cloud can provide connectivity with simple configuration instead of extensive coding. In addition, when you install the DataDirect Cloud On-Premise Connector on a machine behind your firewall, you can connect to on-premise data sources using DataDirect Cloud, without opening ports or otherwise configuring the fire wall. The On-Premise Connector establishes a secure connection back to DataDirect Cloud when needed to provide access to the on-premise data stores.
DataDirect Cloud– September 5, 2015
Oracle Service Cloud
- Added the ability to specify whether the Name attribute of NamedID fields is exposed in the relational model, using the new NamedID Behavior mapping option on the Mapping tab.
- When set to 1, the Id and Name attributes of the NamedID fields are exposed in the relational model. This means that they will be included in the results for the queries. However, including these columns in certain queries can cause Oracle Service Cloud to return a “poor performing query” error if the table has a large number of rows.
- When set to 2, only the Id attribute of the NamedID fields is exposed in the relational model. This setting may improve performance of queries that use NamedID fields.
- Support for write operations to Oracle Service Cloud, using the Read Only option on the Advanced tab.
- If the Read Only check box is selected (set to true), write operations are not allowed.
- If the check box is not selected (set to false), write operations are permitted if the Oracle Service Cloud Database option is set to operational. Write operations are not supported if the Oracle Service Cloud Database is set to report.
- Added the ability to configure whether external events and business rules are run on the server side when performing a Create, Destroy, Get, or Update operation. Use the new Processing Options field to specify which are run.
- If set to 0, external events and business rules run after a Create, Destroy, Get, or Update operation completes.
- If set to 1, external events do not run after a Create, Destroy, Get, or Update operation completes.
- If set to 2, business rules do not run after a Create, Destroy, Get, or Update operation completes.
Oracle Service Cloud
Fixed a problem where fields were no longer present. (PSC00337716) Use the NamedID Behavior mapping option on the Mapping tab to specify whether the Id and Name attributes of NamedID fields are exposed in the relational model.words
Even with exhaustive testing, not all issues can be immediately resolved. The following issues have been noted:
All Data Sources
- It is recommended that Login Timeout not be disabled (set to 0) for a Data Source.
- Using setByte to set parameter values fails when the data source does not support the TINYINT SQL type. Use setShort or setInt to set the parameter value instead of setByte.
- Uninstalling and re-installing the On-Premise Connector causes the Connector Id of the On-Premise Connector to change. Any DataDirect Cloud data sources using the old Connector Id must be updated to use the new Connector Id. Installing to a new directory allows both the old and new On-Premise Connector to exist side-by-side. However, you must update the Connector Id option in previously-defined DataDirect Cloud data sources to point to the new On-Premise Connector.
In addition, you must update Connector Id wherever it was used, such as the definitions of Group Connectors and Authorized Users.
- Changing the name used to register an On-Premise Connector using an older On-Premise Connector Configuration Tool may cause the Connector to fail to register itself with D2C and cause 504 Gateway timeout errors to be returned. Installing the latest On-Premise Connector may resolve this issue.
- Once a Google Analytics OAuth profile is created for a specific Google account, changing the Google Account associated with the profile results in "the configuration options used to open the database do not match the options used to create the database" error being returned for any existing data sources.
- In this release, creating a Google Analytics OAuth profile with the Data Source Management API is not supported.
- $expand only supports one level deep.
For example, with the entity hierarchy:
| |-- OrderItems
The following queries are supported:
However, this query is not supported:
OrderItems is a second level entity with respect to
Customers. To query
OrderItems, the query must be rooted at Orders. For example:
- When manually editing the ODataSchemaMap value, the table names and column names specified in the value are case-sensitive. The case of the table and column names must match the case of the tables and column names reported by the data source.
Note: It is highly recommended that you use the OData Schema Editor to generate the value for the ODataSchemaMap data source option. The Schema Editor takes care of table and column name casing and other syntactic details.
- When using the substring function on properties that map to a CHAR column in the data source, it is data source dependent as to whether the substring function treats the trailing spaces as significant. When going against Oracle, the trailing spaces are preserved. When going against other data sources, the trailing spaces are discarded.
- The $expand clause is not supported with OpenEdge data sources.
- The day scalar function is not working when specified in a $filter clause when querying a DB2 data source.
Oracle Service Cloud
- When you create a custom object, your Oracle Service Cloud administrator must enable all four columns of the Object Fields tab of the Object Designer, or you cannot query against the custom objects.
- The initial connection when the relational map is created can take some time. It is even possible to receive an error "504: Gateway Timeout". When this happens, DataDirect Cloud continues to build the map in the background such that subsequent connection attempts are successful and have full access to the relational map.
Microsoft Dynamics CRM
- Testing has shown the following two errors from Microsoft Dynamics CRM Online when executing queries against the ImportData and TeamTemplate tables:
Note: We have filed a case with Microsoft and are waiting to hear back about the cause of the issue.
- Attribute errortype on Entity ImportData is of type picklist but has Child Attributes Count 0
- Attribute issystem on Entity TeamTemplate is of type bit but has Child Attributes Count 0
- The initial on-premise connection when the relational map is created can take some time. It is even possible to receive an error "504: Gateway Timeout". When this happens, DataDirect Cloud continues to build the map in the background such that subsequent connection attempts are successful and have full access to the relational map.
- Setting the MaxPooledStatements data source option in an OpenEdge data store to a value other than zero can cause statement not prepared errors to be returned in some situations.
- Data source connections by default now use Export Mode to communicate with the Sugar CRM server, providing increased performance when querying large sets of data. When query data contains timestamps using Export Mode, the precision of the timestamp values is only to the minutes. The values for seconds are not returned using the Export Mode. This can cause problems when trying to use timestamp values in a Where clause. For example, suppose a createdTime value had an actual value of 8:53:30 but the rounded value of 8:53:00 was fetched using Export Mode. Then, that value was used in the following Where clause: WHERE createdTime = '8:53:00'. This could end up returning no rows because the actual value for createdTime in the SugarCRM service has a seconds component that is not 00. One way to handle this is to use a range such as AND >= and AND <. For example, WHERE createdTime >= '8:53:00' AND createdTime < '8:54:00'.
DataDirect Cloud JDBC Drivers
- The JDBC 32-bit silent installation fails on Windows 10. Use the standard installer, instead.
- See the file d2cjdbcreadme.txt for the latest notes when accessing DataDirect Cloud through the DataDirect Cloud JDBC drivers. These files are located in the installation directory for the JDBC drivers.
DataDirect Cloud ODBC Drivers
- See the file d2codbcreadme.txt for the latest notes when accessing DataDirect Cloud through the DataDirect Cloud ODBC drivers. These files are located in the installation directory for the ODBC drivers.
Third Party Acknowledgments
Third party acknowledgments are listed on the following Web page.