cf7 Admin API

I've just been through the process of re-configuring our cold fusion servers and thought I'd share my experience in using the new cf7 admin API. Let me start by saying this is a great new feature. Although I found the overall experience fairly intuitive, the amount of documentation leaves a little to be desired.

There's only a single page on livedocs that outlines some of the features.

You can also view all the methods for each class through the cfc explorer introspection features, but they also don't show you everything you need to know. There's no information on the types, values and defaults for the argument values, so I posted a comment on the live docs about it. Anne Sandstrom from Macromedia got back to me and has registered it as bug (#60168). 

There were also a few technical issues I came across that are outlined below:

  • Also found a bug in the debugging class. The issue is with . When you set the debugTemplate property as follows, debugging stops working. I've spoken to Sean Corefield about this and he's registered it as debugging issue is (60170). i.e. myObj.setDebugProperty(propertyName="debugTemplate", propertyValue="classic.cfm");
  • Another bug exists in the mail class. When you set the mail server, for some reason it appends port 25 to the end of the server domain. i.e. mail.whatever.com:25 .. Setting the port doesn't seem to have any effect. This causes the mail server connection to fail so i had to set it manually through the admin console. :(
  • When I set the timeout and interval values in the datasource api the result comes out as timeout=0 interval=0. If I don't set them they come out as defaults timeout=20 interval=7. Wierd. It doesn't matter what I set them to, they always come out as 0. AMENDMENT: Sean Corfield has verified that this is also a documentation bug. The values should be passed in in seconds instead of minutes. 

Anyhow, with those small annoyances aside and my api script written I can now deploy multiple clustered instances of cf without having to go through the same settings over and over. It makes it so much easier to re-install/add new servers. Here's a copy of my script file for your references.

Comments

heh sounds like you've been bugging Sean.. get it..bugging..bugs...

its why i code and don't do standup.

nice heads up though.

yes .. very funny Scott. ;)

News Feed

Recent comments

love it, tag/watch, [url="http://mediastop.info/...
rdnheczuftqsjoh, Compare chart electronic...
We're pretty much trying things to see what works...
Still going. I try to keep it agile, but I wouldn...
Yes, the mythical PO, what process are you using...