Bug #600
closedeml-storedProcedure - problems & proposal
0%
Description
As I began documenting storedProcedure it seemed to me that it is not
appropriately modeled. In eml-view, there is "queryStatement" which allows the
user to provide the sql code necessary to produce the view that is being documented.
In storedProcedure, however, "parameter" replaces queryStatement. In order to
invoke a stored procedure, however, you need more than just the parameters. You
need the name of the storedProcedure or something equivalent to the
queryStatement found in eml-view. I would proposed a structure for
storedProcedure that resembles eml-view.
I am assuming that storedProcedure is meant to apply primarily to a DBMS. If so,
then the storedProcedure syntax and execution must be system specific. If the
intent is to describe the stored procedure, then that should be done in
eml-software.
Files
Updated by David Blankman about 22 years ago
This is a proposed replacement for the storedProcedure schema.
Updated by David Blankman about 22 years ago
Peter McCartney & I discussed the storedProcedure module. We both agreed that
the current structure is inadequate. The problems and proposed changes are
related to the structure of the parameter element.
We came up with three possible modifications. In each option the datatype field
is removed. (in order of complexity):
1. Remove datatype and substitute it with a field called domainDescription. The
content of this field would be a text description of the allowable values. This
is a human readable description with no pretense of machine processing. (my
preference).
2. Remove datatype and replace it with the attributeDomain complex type. This
allows for more structured description of the allowable values.
3. Remove datatype and replace it with a choice of options 1 and option2, that is,
<choice>
<domainDescription>
<att:attributeDomain>
<choice>
I have attached a png file of what option 3 might look like.
Updated by David Blankman about 22 years ago
Changed parameter/datatype to parameter/domainDescription and added documentation.
The domainDescription still needs a good example in the documentation.
Updated by David Blankman about 22 years ago
I provided an example for domainDescription. The example isn't as good as I
would like, but should be sufficient for technical documentation (especially
since the user population is likely to be relatively small.