NetSuite CRM Samples have been redone!

admin — Thu, 03 Jan 2008 15:18:44 +0000

We’ve broken a tradition of modeling our .NET sample applications on the original CRM sample released by NetSuite. Celigo has two enhanced versions of this sample app available: one that was a basic port of the original with few additional features, and another which further enhances it with the integration of the free ServiceManager library. We had initially kept the source code of these, similar to that of NetSuite’s sample. But, starting from this version, Celigo is pulling out all the stops to make these samples richer with much more functionality.

In these new versions, we’ve completely refactored the code, seperating the SuiteTalk logic from the application specific nuts and bolts. All of SuiteTalk based operations have now been partitioned into “Action” classes inheriting from a common abstract base. These classes have been structured
in to namespaces reflecting the functionality that they demonstrate. In order to understand how to implement certain functionality, you can take a look at the relevant “Action” and follow the flow of logic from there.

For example, take a look at the “Get Customer” option. The logic of this operation is bundled into the GetCustomerAction class. The code for the ServiceManager integrated version of this class and the regular version differ only in two lines. Without the presence of the ServiceManager, you’d have to ensure that your app is logged into NetSuite before performing an operation. This requires the regular version to have a bit of extra code. All this was previously packed into few methods making the old source code much harder to read and comprehend. So, you’d appreciate the clarity of our new approach.

The samples are available on our .NET samples page here. Please do check them out… as always, your feedback is much appreciated.

Introducing Celigo’s ServiceManager library

admin — Wed, 01 Aug 2007 13:04:05 +0000

It just works! There exists no better term to describe Celigo’s Service Manager.

Webservices are a whole lot of fun. They let you focus on implementing a rich feature set in your application, and then extend it using a separate set of rich functionality that was developed and perfected elsewhere. But, life isn’t easy when you have to work with a secure system over the wire; you have to worry about authentication, session management, request/response size limitations, etc.

This is where Celigo’s ServiceManager comes in. The ServiceManager or SM (as we often refer to it), is an abstraction over the ground work that needs to be implemented when dealing with the SuiteTalk API.

Here’s a look at some of the features offered:

Session Management

One of the chores you almost always have to deal with is login and relogin in the face of session timeouts. The SM handles this entirely transparently to the developer. In fact, other than having to setup the login credentials once, you as the developer can remain oblivious of the entire login/re-login process. The Service Manager will completely automate this. The SM actually goes one step further: it handles errors such as network failures, NetSuite session expirations, and automatic login retries transparently. All these features are fully configurable.

Batching & Record Limiting

For obvious reasons, SuiteTalk imposes several limitations on the size of the requests it processes. So what happens if you have thousands of records you wish to update? Well, all you have to do is drop them on to the ServiceManager the same way you would update (say) five records. The SM lets you pre-configure a request size threshold, and every mass add, update, or delete would automatically be chunked up into smaller requests and sent synchronously to NetSuite.

Other Features

The ServiceManager is also 100% thread safe. So you can safely share it among multiple threads, which is great if you want to perform any web services operations in a background thread.

In addition to the above, our SM library also includes a robust and full featured solution for connection pooling and queuing through the SessionPool interface. We will cover this topic in more detail in a future post.

Availability

Celigo has made the SM available as a free download. It’s available for Java and .NET. If you take a look at the CRM sample and the enhanced version of the same app using SM, you will get a pretty good idea as to how this abstraction works.

There’s a whole lot more we’d like to share about the ServiceManager. In addition to the details listed in our code snippet pages, we will continue to post more tidbits here on our blog. The SM is something we use across all our SuiteTalk projects, and therefore, have spirited arguments on how to continue to improve it on a daily basis. So we encourage you to give it a go, and don’t forget to get back to us on what features you like to see.

Celigo Blog » .NET