Release Notes

June 2018

Version 2.0.5 (current version)

You can now use the startIndex search parameter to page through search results when you search using ContextObject properties. Previously, you could only use the startIndex search parameter with searches that used Context Service fields. For more information on how to use the startIndex search parameter, see the Search Objects section.

May 2018

Version 2.0.5

• 2.0.5 Updated Features
• 2.0.5 New Features
• 2.0.5 Deprecated Features
• 2.0.5 Open Source

2.0.5 Updated Features

• Pod, Customer, and Request are now types of ContextObject. For more information, see the Context Service SDK Javadoc or the Object section of the Context Service SDK Guide.

• contextServiceClient().search() now has the ContextObject type as a required search parameter. For more information, see the Search for Objects section of the Context Service SDK Guide.

2.0.5 New Features

• This versions adds detail as a type of ContextObject. You can use the detail type of ContextObject to store additional information about an activity or a request.

• This version introduces state to all objects in Context Service. Objects are either active or closed. You cannot update a closed object or set a closed object to open. For more information, see Object State in the Context Service SDK Guide.

• You can now use get methods a field to determine the enumeration values used in that field, the enumeration translations, and the visibility of the enumerations in the application UI. For more information, see Field Enumerations in the Context Service SDK Guide.
  <!---
  Requests automatically change from active to closed 5 days after the most recent update to the request or to an activity associated with the request.

• -->

• This version adds notExists as a special search key. You can use notExists to search for all objects that do not contain the specified value or object property. For more information, see Special Search Keys in the Context Service SDK Guide.

2.0.5 Deprecated Features

• The Pod, Customer, and Request class are deprecated. Pods (activities), customers, and requests are now different types of ContextObject. ContextObject extends the ContextBean class and is managed with the ContextServiceClient() interface. For more information, see the Context Service SDK Javadoc or the Object section of the Context Service SDK Guide.

• You cannot update or get requests created using the deprecated Request class.

• PodState is deprecated. The ACTIVE and CLOSED constants are now part of ContextObject.States.

2.0.5 Open Source Software Acknowledgements

2.0.5 Open Source Software Acknowledgements

September 2017

Version 2.0.3

2.0.3 Open Source Software Acknowledgements

January 2017

Version 2.0.1

Updated Features

You can now use doubles and 32-bit integers as data types for fields. See Create New Fields for more information.

October 2016

Version 2.0.1

Updated Features

In this version you can no longer create publicly accessible fields. This prevents collision with your organization's private fields.

September 2016

Version 2.0.1

• 2.0.1 New Features
• 2.0.1 Updated Features
• 2.0.1 Deprecated or Removed Features
• Third-party Software Impacts

2.0.1 New Features

• This version introduces proxy support with the new property contextservice.proxyURL. To get changes, reinitialize the client:

  updateAndReloadConfigAsync()

See Connect to Context Service for more information.

• You can get the latest contributor with the new method Contributor getLastContributor().

• When you initialize the SDK, the automatic upgrade check blocks the init method until the check is complete and the upgrade, if needed, is complete.

• Newly created and updated activities are not returned in the search method results immediately. This can cause Read POD Step/node to return stale results. Use get POD if you need to retrieve activities immediately after you create or update an activity.

• You can now configure Context Service SDK to use a different logger. For more information, see SDK Client Logging.

• You can now flush data created in lab mode before you set up your organization. For more information, see Flush Object Data.

2.0.1 Updated Features

• Your connection state will no longer change from Registered to Stopped during automatic upgrades. Only connector events like destroy can cause state changes. For more information in connections states, see Monitoring Connection State.

• The context-service-sdk.jar file now has fewer dependencies, which allow the use of various libraries and library versions. The change also removes some restrictions imposed in the earlier versions of the SDK. This change results in a modified SDK with these changes:

  • Connector configuration properties are now supplied to the ContextServiceClient.init() method using an instance of the com.cisco.thunderhead.connector.ConnectorConfiguration class instead of the Apache Configuration class.

  • ClientResponse class used as the return type from ContextServiceClient interface methods including create() and update() is now located in the com.cisco.thunderhead.client package and not the com.sun.jersey.api.client.

  • ContextServiceClient.search() method now uses com.cisco.thunderhead.client.SearchParameters class. This class extends Map<String, List<String>> and replaces Map<String, String> and MultiValueMap<String, String>.

  • You will no longer see case-specific derived exception class. The only exception class is ApiException. Use the error type member of this class to see other case specific exceptions.

2.0.1 Deprecated or Removed Features

These methods have been removed or changed in Context Service SDK Version 2.0.1:

Removed Method	Removed Method Result	Valid Method	Compatibility Notes
setContributors(List )	Errors	setNewContributor()	Replace all instances of setContributors(List ) with setNewContributor(). See Add New Contributor to an Activity
encryptAndCreate	Errors	create()	Replace all instances of encryptAndCreate with create().
encryptAndUpdate()	Errors	update()	Replace all instances of encryptAndUpdate() with update().
getAndDecrypt	Errors	get()	Replace all instances of getAndDecrypt with get().
searchAndDecrypt()	Errors	search()	Replace all instances of searchAndDecrypt() with search().
Request.getPods()	Does not return any results	search() by POD ID	Change code with Request.getPods() to search for activities (PODs) using POD Ids.