MAGG IMAGE STATISTICS

TITLEVALUE
NAMEMAGG IMAGE STATISTICS
DESCRIPTIONThe MAGG IMAGE STATISTICS remote procedure queries the image file(s) and
returns various statistics/summary data. Currently, 2 queries are
implemented:

Counts of images captured in the provided date range
grouped by the image status codes.

Counts of images captured in the provided date range
grouped by users and image status codes.
TAGIMGQUERY
ROUTINEMAGGA03
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERFLAGS
DESCRIPTIONFlags that control the execution (can be combined):

C Capture date range. If this flag is provided,
then the remote procedure uses values of the
FROMDATE and TODATE parameters to select images
that were captured in this date range (see the
DATE/TIME IMAGE SAVED field (7) and the "AD"
cross-reference).

Otherwise, values of those parameters are
treated as the date range when procedures were
performed (see the PROCEDURE/EXAM DATE/TIME
field (15) and cross-references "APDTPX" and
"APDT").

D Include only deleted images (file #2005.1)
E Include only existing images (file #2005)

S Return image counts grouped by status
U Return image counts grouped by users and status

If neither 'E' nor 'D' flag is provided, then an error code (-6) is
returned.

If neither 'S' nor 'U' flag is provided, then an error code (-6) is
returned.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERFROMDATE
DESCRIPTIONBeginning of the date range for image selection. Dates can be in internal
or external FileMan format. If the parameter is not defined or empty, then
the date range remains open on this side.

Depending on the value of the FLAGS parameter, the date range filter is
applied either to the exam/procedure dates (PROCEDURE/EXAM DATE/TIME field
(15)) or image capture dates (DATE/TIME IMAGE SAVED field (7)).

Time parts of date range parameters are ignored and both ends of the date
range are included in the search. For example, in order to search images
for May 21, 2008, the internal value of both parameters should be 3080521.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERTODATE
DESCRIPTIONEnd of the date range for image selection. Dates can be in internal or
external FileMan format. If the parameter is not defined or empty, then
the date range remains open on this side.

Depending on the value of the FLAGS parameter, the date range filter is
applied either to the exam/procedure dates (PROCEDURE/EXAM DATE/TIME field
(15)) or image capture dates (DATE/TIME IMAGE SAVED field (7)).

Time parts of date range parameters are ignored and both ends of the date
range are included in the search. For example, in order to search images
for May 21, 2008, the internal value of both parameters should be 3080521.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
RETURN VALUE TYPEGLOBAL ARRAY
RETURN PARAMETER DESCRIPTIONZero value of the first '^'-piece of the Results[0] indicates that an
error occurred during the execution of the procedure. In this case, the
errors are returned in the Results array as shown below:

Results[0] Result descriptor
^01: 0
^02: Message

Results[i] Error descriptor
^01: Error code
^02: Message
^03: Error location
^04: Message type

Results[j] Line of the additional info (optional)
^01: ""
^02: Text

Otherwise, '1^Ok' is returned in the Results[0] and subsequent nodes
contain requested data:

Results[i] Header of the counts grouped by status
^01: "S"
^02: empty
^03: Number of "S"-items
^04: empty
^05: "Totals"
^06: Number of image entries
^07: Number of images/pages

Results[i+j] Image status record
^01: "S"
^02: Sequential number of the "S"-item
^03: empty
^04: Internal value of the STATUS field (113).
If this piece is empty or 0, then the
record contains counts of images with
empty STATUS field.
^05: External value of the STATUS field (113)
^06: Number of image entries
^07: Number of images/pages

Results[i] Header of the counts grouped by users and status
^01: "U"
^02: empty
^03: Number of "U"-items
^04: empty
^05: "Totals"
^06: Number of image entries
^07: Number of images/pages

Results[i+j] User record
^01: "U"
^02: Sequential number of the "U"-item
^03: Number of "US"-items
^04: User IEN (DUZ).
If this piece is empty or 0, then the
record contains counts of images that
are not associated with a user.
^05: User name
^06: Number of image entries
^07: Number of images/pages
^08: Percentage of verified images

Results[i+j+k] User/status record
^01: "US"
^02: Sequential number of the "US"-item
^03: empty
^04: Internal value of the STATUS field (113).
If this piece is empty or 0, then the
record contains counts of images with
empty STATUS field.
^05: External value of the STATUS field (113)
^06: Number of image entries
^07: Number of images/pages
AVAILABILITYRESTRICTED
INACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED