RE-Decoded

A technical look at the Raiser's Edge API from Blackbaud


Feeds:

API 7.82 – The Silent Revolution

November 19th, 2007 by David Zeidman

I normally keep up with the latest changes in the Raiser’s Edge version.  I thought that the jump from 7.81 to 7.82 was not that great. I knew that there were fixes so that RE would work with Office 2007, there were some more changes to optional modules (I was only really familiar with events), there were new names for items in query and export, another change to Gift Aid and that was about it. At least that was it until I saw an item on the conference pages talking about the new Batch API code that had been made available. What?? Batch API! This is something that I have been asking for forever and it completely threw me when I just stumbled across it.

What does this mean? Well in so many scenarios it is preferable to be able to import gifts into a batch and not directly into the gifts themselves. If you only ever use batch for mass gift entry and use none of the auditing facilities, none of the validation routines, none of the linking to events, proposals etc then maybe the Batch API functionality is not going to be so useful to you as you can clearly just add gifts en masse via the regular gifts part of the API.

For everyone else however the Batch API opens up a really useful module. You now have the ability to take a spreadsheet or another data source and “import” those gifts into batch. You can then use batch exactly the same way as you would otherwise.

The alternative is to create very complicated validation requirements in the code so that manual review is not required. These validation routines would otherwise be done in batch either automatically or by somebody checking through each gift before posting. Of course it is possible to create your own “batch” so that before the gifts are imported you display them in a grid but this is a lot of work for a module that already exists.

 So it is truly a revolution that Blackbaud opened the Batch API up. For me it was a big change and one that Blackbaud should have highlighted more prominently. This is definitely a big selling point of the API and one I can strike from my list of how to improve the API. Now to deal with the other items on the list…

Related posts:

  1. Small improvements that I like about Blackbaud Enterprise CRM Blackbaud Enterprise CRM (eCRM or BBEC as it seems to...
  2. Scheduling a plug-in After dispelling the myth that you do not need to...
  3. Recurring Gift Schedules One of the harder imports that you may have to...
  4. Replacing Excel Most of the Raiser’s Edge users that I speak to...

Posted in Not Code | 6 Comments »

6 Responses

  1. RE-Decoded » Blog Archive » How I would improve the API Says:

    [...] API 7.82 – The Silent Revolution [...]

  2. Chris Wang Says:

    This is great news. I look forward to hearing more about the batch Api development.

  3. RE-Decoded » Blog Archive » Adjust that tax claim at your peril Says:

    [...] is perhaps more of a rant than anything else but after being so pleased with the way Blackbaud introduced Batch into the RE:API I now found myself stuck with another piece of Raiser’s Edge functionality [...]

  4. David Wanless Says:

    David,

    Thanks so much for this tip. I’ve been waiting for and asking for this development. It looks like a great step forward, although having only just read your post and found out that this exists, and not having made the upgrade to RE7.82 yet, I’ve not been able to test it.

    I take it though, that this will enable us to create a batch using the API but then use the normal batch screen and processes to check it, modify it, validate it, report on it and commit it?

    Thanks again. I’m enjoying your blog,

    David Wanless.

  5. David Zeidman Says:

    David,

    Thanks for your kind words. Yes this is exactly what the new functionality does. It is a major advance. You are able to create a batch consisting of any of the fields available to you and populate them. This is a serious advance for, say importing gifts from a website. You often want to validate and check the data before adding the gifts and while I have created my own “batch” module for a client so that they can check the data before importing it, it is much better to use out of the box functionality.

  6. RE-Decoded » Blog Archive » Using the Batch API with Notepads or Attributes Says:

    [...] have started to use the Batch API in earnest now. I have said previously that it is a great long overdue piece of functionality but I am beginning to understand why it was [...]

Leave a Comment

Please note: Comment moderation is enabled and may delay your comment. There is no need to resubmit your comment.