d061001c: info.odma.practical100 0.01alpha Evolutionary Prototype

Latest version: The latest info.odma.practical100 components are at <http://ODMA.info/dev/devNotes/2006/10/d061001b.htm>.
Next version: 0.05alpha Evolutionary Prototype <http://ODMA.info/dev/devNotes/2006/10/d061001d.htm>
This version: 0.01alpha Evolutionary Prototype 0.05 <http://ODMA.info/dev/devNotes/2006/10/d061001c.htm>. This version is obsoleted by the 0.05alpha version. Later versions provide greater functionality. There are also breaking changes between the interfaces in the 0.01alpha prototype and later ones.
Downloads: The material of the 0.01alpha Evolutionary Prototype is provided in two files:
1. practical100.txt Manifest of the 0.01alpha package, version 0.01 in a 2,735 byte file dated 2006-10-19-00:29.
2. Practical100-0.01alpha.zip Archive of the 0.01alpha Material, version 0.01 in a 7,718 byte file dated 2006-10-19-01:04. Please review the manifest to first determine whether it is worthwhile to download the full archive.

1. Summary

Practical100-0.01alpha is the starter package used to confirm simple compilation procedures, organization of the class path, and trial building of two info.odma.practical100 package interfaces.

This package is also the seed for evolutionary prototype development where working code is refined by progressive steps until acceptable functionality and stability are achieved.

There is no operational code in this version. Its purpose is to confirm the basic alpha-level build process and correct installation of the development software:

Command-line operation of the Java JDK 1.5.0 is confirmed.
The folder hierarchy and Java classpath are confirmed as set properly for the package.
Simple scripts for building the initial code are verified, along with the proper reporting of their setup and progress.
The basic setup is documented in an accompanying file, with instructions for reproducing the setup and operation by modifying two settings in a simple file.
Editing of the Java source code (with jEdit 4.2final) and management of development under a source-code management system (Microsoft Visual SourceSafe 6.0d) is confirmed.
Packaging of the code in a properly-structured Zip file is demonstrated and used for archiving and sharing with other developers.
An ODMdev Development Note package (this folio) is set up for archiving the progression of versions, with technical level documentation and links to other resources.

2. Developer Notes: Changes

The following changes were made from Review Draft 0.20 Guide & Usage Scenarios as the files were created for the first time::

The name of the package was changed from info.odma.simple100 to info.odma.practical100. The simple100 term seemed too simple and possibly misleading from the very beginning. The substitution of "practical" didn't occur until starting to enter and edit the definitions. This is much more in the spirit of what is intended for ODMJNI 1.0.
The Connection.dmsAvailable() method was renamed to Connection.connectionAvailable() to reflect the difference between having no connection with the ODMA Connection Manager and having a default DMS at hand.
Although it seems useful to have a single Document interface, it was noticed that delivering a fresh DMS document's content to the ODMA DMS is quite different than when a DMS document is retrieved as a working document. The possible need for a PendingDocument interface was noticed for further consideration and introduction later.
Document.dmsAvailable() was added at that level, where failing to have a DMS available is relevant to ways that operations can fail, including the
{Author Note: There is still more information needed here. Also, the obsolescence by future stages and how that happened needs to be accounted for in an emphatic way and with cross-linking.}

Attribution:

Hamilton, Dennis E.

info.odma.practical100 Component Development -- 0.01alpha Evolutionary Prototype. AIIM ODMA Interoperability Exchange, ODMdev Development Note d061001 page d061001c 0.05, August 16. Available at <http://ODMA.info/dev/devNotes/2006/10/d061001c.htm>.

Revision History:
0.05 2007-08-16-15:57 Repaving Complete

This page is repaved to satisfy the construction structure in a clean way as part of preview ramp-up to the 0.60 public beta.

0.04 2006-10-25-20:49 Clean up text.

Correct some typographical errors in the text are corrected, with some wording repairs. Remove the Harvard-style coding from the attribution.

0.03 2006-10-24-01:34 Identify as obsolete.

The next improvement is linked and this material is identified as obsolete.

0.02 2006-10-20-13:34 Add Summary and Developer Notes

Capture information about the purpose of this material, and note the thinking that went into the form arrived at.

0.01 2006-10-20-13:21 Branch for 0.05alpha Refactor and Initial Null Implementation

Capture changes made as 0.05alpha is developed and tested in a new page.

0.00 2006-10-19-20:40 Provide Placeholder for Already-Created 0.01alpha Package

This page is put up as a placeholder so that the 0.01alpha package has a home the first step in evolutionary prototyping.

You are navigating ODMdev.
This work is licensed under a
Creative Commons Attribution 2.5 License.

created 2006-10-19-20:40 -0700 (pdt) by orcmid
$$Author: Orcmid $
$$Date: 08-04-23 21:11 $
$$Revision: 85 $