Craig’s Musings

Thoughts about software architecture, books and life

Craig’s Musings Dive In and Be Aware

Documentum RESTful Services EAP

July 1st, 2009 · Content management, Documentum RESTful Services

Rest Area

Today I’m pleased to announce a new Early Access Program (EAP) for a new RESTful HTTP-based interface to the EMC Documentum ECM Platform called Documentum RESTful Services. The engineering team has been hard at work on this and is looking forward to sharing the first early access release (EA1) with you via a community site on the EMC Community Network.

Please go here to see what Documentum RESTful Services is about and to apply for the EAP.

We’re looking forward to working closely with you during this EAP. Cheers! :-)

→ No CommentsTags:········

Automated post signature in WordPress

June 24th, 2009 · Site, Syndication

Recently I noticed that my colleague, Steve Todd, has adopted a consistent signature to his blog posts. This seems like a good idea, especially as one who’s been “syndicated” elsewhere without my approval.

While he’s a TypePad guy, I favor WordPress. Fortunately, WordPress has rich plugin ecosystem, and there are already plugins that support automated signatures.

Although not yet listed in the codex, I adopted DDAddSig for my needs.

Once I activated the plugin, I simply went to my WordPress dashboard Settings | DDAddSig panel, edited my Primary Signature and checked the Usage box “Display on posts.” VoilĂ ! :-)

→ No CommentsTags:····

Subject To Change

June 3rd, 2009 · Books, Non-fiction, Reading, Technology

I recently finished reading Subject To Change: Creating Great Products & Services for an Uncertain World, and I can recommend this book to anyone who wants, for example, to build software that resonates with its users.

Here are a list of thoughts and quotes this read produced:

  • Empathy is an understanding of a person or group’s subjective experience by sharing that experience vicariously that can be developed and cultivated through practice (i.e. it’s not innate). Using your sense of empathy can help you focus on the experience you want to deliver in a manner that is effective for those who will engage with it. Don’t confuse customer briefings with developing customer-focused empathy; there’s more to it!
  • Experience accounts for motivations, expectations, perceptions, abilities, flow, and culture.
  • Parity isn’t a strategy; neither is being the best.
  • Don’t craft the story of a product in isolation form the actual creation of that product.
  • Human life is complex–embrace this reality; don’t ignore it. Capture complexity with qualitative research (e.g. conduct interviews to elicit stories about experiences). Differentiate process (i.e. the how and why) from outcomes (i.e. the what, where, and when).
  • Sometimes experience strategy isn’t about hiding complexity as much as it’s about managing it (e.g. distribute complexity across a system so as not to overwhelm at any particular point). That is, the overall experience should never become too complex. There needs to be coordination among the experiences touch points, allowing each to fully exhibit its strengths.
  • “You have to recognize that a system will degrade, and make it such that such entropy doesn’t shatter the entire experience. The true success of experience design isn’t how well it works when everything is operating as planned, but how well it works when things start going wrong.” For example, provide meaningful seams into which people can insert themselves (i.e. leave an impression).
  • Great experience is difficult to plan for, and almost impossible to specify.
  • Good experiences require systematic coordination with the customer in mind (i.e. a focus on qualitative customer insights).
  • “Design is a way of approaching problem solving, decision making, and strategy planning that can yield better outcomes.”
  • “[Design-centric organizations] peer into the needs and desires of their customers, identify patterns of behavior, refine ideas that tap into those behaviors, then push into the unknown–or at least the uncertain.” -Roger Martin
  • “You can’t build a design competency overnight; it requires difficult changes in process, skills, and perhaps most importantly, culture.”
  • In my development organization we deploy a risk-driven iterative development process, with phases we call inception, elaboration, construction and transition. I’d liked the book’s description of “the fuzzy front end,” which I would liken to inception (e.g. “anticipation exceeds insight”).
  • “Good ideas need to fail early and often so you can arrive sooner at a great one.” Process won’t turn mundane ideas into stars–nor will great effort (strong execution). Therefore, avoid premature execution of an idea. For example, presuppose multiple solutions and suggest alternatives based on partial data. Define constraints that drive great solutions (e.g. think like a newbie, leverage empathy (that you’re developing, right? ;-) ).
  • “Strategy should bring clarity to an organization; it should be a signpost for showing people where you, as their leader, are taking them–and what they need to do to get there…. People need to have a visceral understanding–an image in their minds–of why you’ve chosen a certain strategy and what you’re attempting to create with it…. Because it’s pictorial, design describes the world in a way that’s not open to many interpretations.” -Tim Brown

On Monday, I noted 11 years with EMC (via its acquisition of Documentum). I can certainly say that “change happens” in the content management space and my own career.

My first engineering responsibilities were centered around the Documentum Desktop (aka Desktop Client) offering–client/server architecture implemented as a mixture of C++ and VB. Then I was called on to drive the first major release of WDK, a web-based application implemented in Java, JSP, HTML and XML. Next stop: creating an integration bridge between Documentum and authoring environments like Office, Adobe and XML editors (i.e. Application Connectors), which was specified as an N-tier architecture implemented as a mixture of C# (on the desktop) and Java (on the middle tier. Currently I’m focused on providing a rich set of services (i.e. local Java APIs, WSDL-based web services and RESTful web services) that drive a diverse set of applications, each with its own presentation layer technology decisions (e.g. Flash/Flex, ExtJS/DWR, etc.).

And “tomorrow” this will all be subject to change once again… :-)

→ 1 CommentTags:···

Inoculating a Reply All plague

June 1st, 2009 · Content management, Lessons, Technology

The “Reply All” feature of most email programs like Outlook is a convenience ripe for abuse. Unfortunately such abuse seems to occur about once a quarter or so where I work. Folks add an alias to their message (To or Cc) that ends up involving a multitude of folks who could care less about the message just received.

So, unfortunately (!), what many folks do in reply is Reply All, yet again. :-(

When you Reply All to a Reply All asking not to Reply All, you defeat your purpose. Instead, be surgical and just educate the offenders. That is, be sure to remove all aliases from your reply–if you really feel the need to reply in the first place–and communicate solely with individuals on the To line of the diseased message.

Surely there is a way in Outlook to establish a rule as follows:

    Apply this rule after the message arrives
    with INOCULATION_KEYWORD(S)_HERE in the subject
    reply using INOCULATION_EMAIL_TEMPLATE_HERE
        and move it to the Deleted Items folder

If you really feel compelled to Reply All, then at least do others the favor of changing the Reply-To address in your message to something less hideous (e.g. (in Outlook) Options | Direct Replies To | Have replies sent to: no-reply@…).

→ 2 CommentsTags:··

EMC Documentum Developer Edition

May 14th, 2009 · Content management, DFS, Development Toolbox, Services, Technology

Today we launched a new EMC Documentum developer-oriented community within the EMC Community Network. Front and center is the new developer edition of the EMC Documentum ECM Platform.

So, what does this developer edition include? We believe it includes a lot of goodness for the development of content-enabled applications.

  • First of all, free software for developers
  • A new one-click installation process for the core of the EMC Documentum ECM Platform
  • xDB and new XML components – please visit the just-launched XML Technology Developer Community for more details about our native XML database and other technologies
  • Integration between the resulting development environment and online community resources and support mechanisms – think of this as a starting point and means to the ends you want to pursue, not an end in itself

Essentially, we’re trying to provide a low-touch, DIY experience. That being said, by integrating your local installation to an online community, the developer edition enables you to reach out to fellow developers and EMC employees as your pursuit your content management development interests grows. For example, you’ll find a range of white papers, documents and videos, as well as sample code in, for example, Java and C# (.NET). Topical tutorials available online are drawn from our Education Services library.

So, what is the process to obtain the free developer edition? We hope that it’s straightforward.

  1. Browse here and login into ECN/EDN
  2. Navigate here and complete a short (less than 30 seconds) registration form. Click the “Continue” button to proceed to the download site. (You may need to add ecn_communications@emc.com to your email safe senders list so as not to miss messages from that address (i.e. have them interpreted by Outlook as junk).)
  3. Navigate the EMC SubscribeNet links to arrive at the FTP download (or HTTPS-based download, if you prefer). Note that the download is a bit more than 1.73 GB and represents a Zip archive, which means that you should ensure adequate disk space to extract, deploy, etc.
  4. Commence your download.

In a follow-up post, I’ll walk you through the installation experience and how to leverage the version of DFS that comes with the developer edition. BTW, if you’re too anxious to dive in and can’t wait for my post, go for it! There is an online getting started guide as well as an online tutorial for building your first application.

Cheers! :-)

Update 5/20/2009: Well, I’m about to take a much needed vacation, and I have yet to follow-up with a walk-thru post. So, I wanted to at least provide some details here as to what this software requires system-wise. System requirements are as follows (and are displayed in the initial installer screen):

  • No Microsoft SQL Server or SQL Server Express installed [1]
  • No other Documentum software installed [2]
  • Microsoft .NET 2.0 or higher [3]
  • Browser with Sun JRE 5.0 update 16 or higher [4]
  • Minimum of 3 GB RAM (4 GB RAM is recommended)
  • 5 GB of free disk space [5]
  • Intel x86 CPU
  • Operating system–again 32-bit only for this release–is one of the following: Windows XP SP3, Windows Server 2003 SP2 or Windows Server 2003 R2 SP2
  • You must be logged in as a member of the Windows Administrators group, but not necessarily as Administrator

Notes:
[1] Be aware that if you already have Visual Studio (e.g. 2005 or 2008) installed on your target machine, you may need to first uninstall the version of SQL Server that may have been installed with the IDE. If you are running Windows SharePoint Services or UDDI on your target (Windows Server 2003) machine, you may also need to see what embedded database is supporting these services before proceeding with this developer edition installation.
[2] Be sure to understand where you may still have Documentum-related configuration files on disk (e.g. dfc.properties, C:\Documentum, etc.).
[3] Microsoft .NET Framework 3.0 is required for WCF-based consumption of DFS endpoints; so, I recommend .NET 3.0, which includes (requires as its foundation) .NET 2.0. .NET 3.5 is also supported by DFS, if you prefer to leverage WCF “v2.”
[4] This is supported by Webtop and DA.
[5] Keep in mind that, as I noted above, the Zip archive download is a bit more than 1.73 GB. The total size of its extracted contents is not that much larger, but you’re also starting to approach 4 GB; so, I recommend that you have 10 GB free disk space in order to complete the installation with room to spare before cleaning up the extracted bits and the original archive to reclaim that 4 GB.

…and, welcome, CMS Watch readers! :-)

→ 1 CommentTags:········