Skip to main content

EnsLib.EDI.ASTM.Document

persistent class EnsLib.EDI.ASTM.Document extends %Library.Persistent, EnsLib.EDI.Document, EnsLib.EDI.Segmented, EnsLib.EDI.ASTM.MsgBodyMethods

SQL Table Name: EnsLib_EDI_ASTM.Document

Represents an Interchange or a TransactionSet. FunctionalGroups are represented as Segments within an Interchange.

Property Inventory

Method Inventory

Parameters

parameter DEFSEARCHCLASS = EnsLib.EDI.ASTM.SearchTable;
Name of the default SearchTable indexing class used in UI choices and MessageBank submissions
parameter DOCCLASSFULLNAME = ASC ASTM EDI Document;
Inherited description: Full descriptive name for this subclass of document
parameter DOCCLASSNAME = ASTM Document;
Inherited description: Compact descriptive name for this subclass of document
parameter DOCSHORTNAME = ASTM;
parameter DOMAIN = Ensemble;
Use our own domain for localization
parameter EXTENTSIZE = 2000000;
Inherited description: The EXTENTSIZE parameter is used to inform the Caché SQL Query Optimizer of the approximate number of instances in the extent containing instances of this class.

For example, a class that expects to have about 1,000,000 instances should define:

parameter EXTENTSIZE = 1000000;
parameter SCHEMACLASS = EnsLib.EDI.ASTM.Schema:DS;
Name of the associated schema class and, after a colon, the schema class code that represents a DocType

Properties

property %maps [ MultiDimensional , Transient ];
A local array of orefs "orefs" - a local map of integer ids to segment objects And either a subscript into ^CacheTemp for this object's LVD maps (for notes on LVD implementation see EnsEDI.inc) or local storage for these additional maps: "runtimeIndex" - array for runtime index to segment; will always be defined unless mapRuntimePath is defined "runtimePath" - array for runtime path to segment "bidirectionalLink" - array for runtime path and index linkage
Property methods: %mapsDisplayToLogical(), %mapsGet(), %mapsIsValid(), %mapsLogicalToDisplay(), %mapsLogicalToOdbc(), %mapsNormalize(), %mapsSet()
property ComponentSeparator as %String [ Calculated , Transient ];
Sub-element component separator character
Property methods: ComponentSeparatorDisplayToLogical(), ComponentSeparatorIsValid(), ComponentSeparatorLogicalToDisplay(), ComponentSeparatorLogicalToOdbc(), ComponentSeparatorNormalize()
property DocTypeCategory as %String [ Transient , ReadOnly ];
the category portion of the DocType
Property methods: DocTypeCategoryDisplayToLogical(), DocTypeCategoryGet(), DocTypeCategoryIsValid(), DocTypeCategoryLogicalToDisplay(), DocTypeCategoryLogicalToOdbc(), DocTypeCategoryNormalize(), DocTypeCategorySet()
property DocTypeName as %String [ Transient , ReadOnly ];
Stored raw document type name ; the secondary type name portion of the DocType
Property methods: DocTypeNameDisplayToLogical(), DocTypeNameGet(), DocTypeNameIsValid(), DocTypeNameLogicalToDisplay(), DocTypeNameLogicalToOdbc(), DocTypeNameNormalize()
property Envelope as %String);
'Envelope' information for the ASTM document message. Used in propagating info about the return Service address for reply documents
Property methods: EnvelopeDisplayToLogical(), EnvelopeGet(), EnvelopeGetStored(), EnvelopeIsValid(), EnvelopeLogicalToDisplay(), EnvelopeLogicalToOdbc(), EnvelopeNormalize(), EnvelopeSet()
property EscapeSeparator as %String [ Calculated , Transient ];
Escape separator character
Property methods: EscapeSeparatorDisplayToLogical(), EscapeSeparatorIsValid(), EscapeSeparatorLogicalToDisplay(), EscapeSeparatorLogicalToOdbc(), EscapeSeparatorNormalize()
property FieldSeparator as %String [ Calculated , Transient ];
Data-field separator character
Property methods: FieldSeparatorDisplayToLogical(), FieldSeparatorIsValid(), FieldSeparatorLogicalToDisplay(), FieldSeparatorLogicalToOdbc(), FieldSeparatorNormalize()
property FullSize as %Integer [ Calculated , Transient , ReadOnly ];
Size in bytes of the message content. The calculation assumes 2-byte segment terminators and includes any segments that use more than one storage node.
Property methods: FullSizeCompute(), FullSizeDisplayToLogical(), FullSizeIsValid(), FullSizeLogicalToDisplay(), FullSizeNormalize(), FullSizeSQLCompute()
property Identifier as %String [ Calculated , Transient , ReadOnly ];
Unique document identification string found in document content
Property methods: IdentifierCompute(), IdentifierDisplayToLogical(), IdentifierIsValid(), IdentifierLogicalToDisplay(), IdentifierLogicalToOdbc(), IdentifierNormalize(), IdentifierSQLCompute()
property Name as %String [ Calculated , Transient , ReadOnly ];
Raw type name of document
Property methods: NameCompute(), NameDisplayToLogical(), NameIsValid(), NameLogicalToDisplay(), NameLogicalToOdbc(), NameNormalize(), NameSQLCompute()
property RawContent as %String (MAXLEN = 10000) [ Calculated , Transient , ReadOnly ];
The raw text content of the document. Note that this is a truncated version suitable for use in SQL results and visual inspection, but not a complete or definitive representation of the document.
Property methods: RawContentCompute(), RawContentDisplayToLogical(), RawContentIsValid(), RawContentLogicalToDisplay(), RawContentLogicalToOdbc(), RawContentNormalize(), RawContentSQLCompute()
property RepetitionSeparator as %String [ Calculated , Transient ];
Repetition separator character
Property methods: RepetitionSeparatorDisplayToLogical(), RepetitionSeparatorIsValid(), RepetitionSeparatorLogicalToDisplay(), RepetitionSeparatorLogicalToOdbc(), RepetitionSeparatorNormalize()
property SegCount as %Integer [ Calculated , Transient , ReadOnly ];
Count of segments composing this document
Property methods: SegCountCompute(), SegCountDisplayToLogical(), SegCountIsValid(), SegCountLogicalToDisplay(), SegCountNormalize(), SegCountSQLCompute()
property Separators as %String (MAXLEN = 4, MINLEN = 4) [ Transient ];
All 4 Separators as a String,FLDSEP_REPSEP_COMSEP_ESCSEP
Property methods: SeparatorsDisplayToLogical(), SeparatorsGet(), SeparatorsIsValid(), SeparatorsLogicalToDisplay(), SeparatorsLogicalToOdbc(), SeparatorsNormalize(), SeparatorsSet()
property TypeVersion as %String [ Calculated , Transient , ReadOnly ];
Raw type version name of message found at H:13 in message content
Property methods: TypeVersionCompute(), TypeVersionDisplayToLogical(), TypeVersionIsValid(), TypeVersionLogicalToDisplay(), TypeVersionLogicalToOdbc(), TypeVersionNormalize(), TypeVersionSQLCompute()

Methods

method BuildMap(pKeepParsingAfterError As %Boolean = 1) as %Status
pKeepParsingAfterError means keep trying to parse after errors are encountered; returned Status will contain all errors encountered
method Clear() as %Status
Delete All Content and reset all properties
method ComponentSeparatorGet() as %String
method CopyValues(pSource As EnsLib.EDI.ASTM.Document, pSourcePath As %String, pTargetPath As %String, pAction As %String, pKey As %String, pEmptyFieldAsNull As %Boolean = 0, pIgnoreMissingSource As %Boolean = 0) as %Status
Inherited description: Copy a whole set of values from source to target when iteration is implied between 2 VDocs pSourcePath contains the property path to the source set
pTargetPath contains the property path to the target set
pAction contains an action code: "set", etc..
pKey contains an optional key value or a set of comma-separated key values to be used as array indices where empty array index placeholders are present in pPropertyPath.
method DocTypeSet(pDocType As %String, pBuildMap As %Boolean = 1) as %Status
method DumpMaps() as %Status
classmethod EnumerateDocTypesClose(ByRef qHandle As %Binary) as %Status
classmethod EnumerateDocTypesExecute(ByRef qHandle As %Binary, Category As %String = "", IncludeBase As %Boolean) as %Status
classmethod EnumerateDocTypesFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer) as %Status
classmethod EnumerateSegTypesClose(ByRef qHandle As %Binary) as %Status
classmethod EnumerateSegTypesExecute(ByRef qHandle As %Binary, Category As %String, Level As %String, IncludeBase As %Boolean) as %Status
classmethod EnumerateSegTypesFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer) as %Status
classmethod EnumerateTypeCategoriesClose(ByRef qHandle As %Binary) as %Status
classmethod EnumerateTypeCategoriesExecute(ByRef qHandle As %Binary, Standard As %String = "") as %Status
classmethod EnumerateTypeCategoriesFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer) as %Status
method EscapeSeparatorGet() as %String
method FieldSeparatorGet() as %String
method FindSegment(pSegName As %String, ByRef pIndex As %String = "", Output pStatus As %Status) as EnsLib.EDI.ASTM.Segment
Gets the next segment after index pIndex with name pSegName. Supports pSegName = '*' to match any segment.
method FullSizeGet() as %Integer
classmethod GetAlias(pContentArrayName As %String, pArrayPos As %String) as %String
This method computes the Alias string for a property name, given the property's node in the Content Array.
classmethod GetContentArray(Output pContents, pMode As %String, pDocType As %String, pLevel As %Integer, pIncludeBase As %Boolean) as %Status
Inherited description: Returns array of properties that make up the contents of this object.
This method in implemented within the document class.
The content array is in the form:
pContents(n,"type")="%String"
pContents(n,"name")="Field"
pContents(n,"alias")=alias code
If pContents(n) is non-zero then the property is a composite type with
sub-properties. The sub-properties are indexed with a similar structure under
pContents(n,m) where m is the index of the subtype property.
classmethod GetFullSize(pMsgId) as %Integer
Returns an array of links to manager pages for this type of VDoc; item 0 is the family description
method GetNextGroupPath(pGroup As %String, pPath As %String, ByRef pStatus As %Status = $$$OK) as %String
Gets the next path in a group
method GetNextIndex(pPath As %String, pIndex As %String, ByRef pStatus As %Status = $$$OK) as %String
Gets the next index in an array
method GetSegmentIndex(pPath As %String, Output pStatus As %Status) as %Integer
Given a segment path, find the corresponding segment index
method GetSegmentPath(pIndex As %Integer, Output pStatus As %Status) as %String
Given a segment index, find the corresponding segment path
method GetValueAt(pSegmentPropertyPath As %String, pSeparators As %String, Output pStatus As %Status) as %String
Inherited description: Return the value of the designated virtual property.
pPropertyPath contains a text expression representing the address within the document of the value of interest.
pFormat contains additional context that may be used to influence the form of the result value
If no value can be found matching pPropertyPath in the current document an empty string is returned and output argument pStatus returns status information explaining the failure
This is implemented by the document subclass.
method IdentifierGet() as %String
classmethod ImportFromDevice(Output pStatus As %Status, ByRef pConfigItem As %String, pIOFormatClassname As %String) as EnsLib.EDI.ASTM.Document
classmethod ImportFromFile(pFilename As %String, pDocNum As %Integer = 1, Output pStatus As %Status, ByRef pConfigItem As %String, pIOFormatClassname As %String) as EnsLib.EDI.ASTM.Document
classmethod ImportFromIOStream(pIOStream As %IO.I.CharacterStream, Output pStatus As %Status = $$$OK, ByRef pConfigItem As %String = "", pIOFormatClassname As %String = "") as EnsLib.EDI.ASTM.Document
classmethod ImportFromLibraryStream(pLibStream As %Stream.Object, Output pStatus As %Status, ByRef pConfigItem As %String, pIOFormatClassname As %String) as EnsLib.EDI.ASTM.Document
classmethod ImportFromString(pString As %String, Output pStatus As %Status, ByRef pConfigItem As %String, pIOFormatClassname As %String) as EnsLib.EDI.ASTM.Document
classmethod KillGlobals(Output pDeletedCount, pKeepExtentCount=0, pDisplayLog=1)
method NameGet() as %String
method NewReplyDocument(pDocType As %String = "", pLocalApplicationID As %String, Output pSC As %Status) as EnsLib.EDI.ASTM.Document
method OutputHTML() as %Status
Display Segments as HTML, using DocType info if available
method OutputHTMLZen() as %Status
Display Segments as HTML, using DocType info if available
method OutputToDevice(pSeparators As %String, pDoFraming As %Integer, pResponseTimeout As %Numeric = -1, pIOFormatClassname As %String) as %Status
method OutputToFile(pFilename As %String, pOverwrite As %Boolean, pSeparators As %String, pDoFraming As %Integer, pResponseTimeout As %Numeric = -1, pIOFormatClassname As %String) as %Status
method OutputToIOStream(pIOStream As %IO.I.CharacterStream, pSeparators As %String, ByRef pDoFraming As %Integer = 0, pResponseTimeout As %Numeric = -1, pIOFormatClassname As %String = "") as %Status
method OutputToLibraryStream(pLibStream As %Stream.Object, pSeparators As %String, pDoFraming As %Integer, pResponseTimeout As %Numeric = -1, pIOFormatClassname As %String) as %Status
method OutputToString(pSeparators As %String, pDoFraming As %Integer, pResponseTimeout As %Numeric = -1, Output pStatus As %Status, pIOFormatClassname As %String) as %String
method PokeDocType(pDocType As %String) as %Status
classmethod Purge(Output pDeletedCount As %Integer, pDaysToKeep As %Integer = 7, pDummy As %Boolean = 0) as %Status
method RawContentGet() as %String
method RepetitionSeparatorGet() as %String
method SegCountGet() as %Integer
method SetValueAt(pValue As %String, pSegmentPropertyPath As %String, pAction As %String = "set", pKey As %String = "") as %Status
Inherited description: Set the value of the designated virtual property.
pValue contains the value to set.
pPropertyPath contains a text expression representing the address within the document of the value of interest.
pKey contains an optional key value or a set of comma-separated key values to be used as array indices where empty array index placeholders are present in pPropertyPath.
pAction contains an action code: "set", "clear", "append", etc.
classmethod TotalCount() as %Integer
method TypeVersionGet() as %String
Inherited description: Subclasses should override this if the version can be gotten from the document content
method buildRuntimePathFromIndex(pId As %String, pPath As %String, pContentArray As %String, pType As %String, ByRef pCurrSeg As %Integer, pParentGrpOpt As %Boolean, pSC As %Status, pKeepParsingAfterError As %Boolean) as %Status
Build a segment map for the current segment index array based on the document schema
If pKeepParsingAfterError is false then stop parsing when first error is encountered
classmethod checkDocType(ByRef pDocType As %String) as %Status
method commitSegmentByIndex(pIndex As %Integer) as %Status
collapse segment object into just ID; Save if necessary
method commitSegmentByPath(pPath As %String) as %Status
collapse segment object into just Id; Save if necessary
method convertRuntimePathToSchemaPath(pPath As %String) as %String
method getId() as %String
The same as %Id(), but allocates the Id even if the object hasn't been saved already
method getSegmentIdByIndex(pIndex As %Integer, Output pStatus As %Status) as %String
method getSegmentIdByPath(pPath As %String, Output pStatus As %Status) as %String
classmethod getSegsAsString(pId As %String, pMaxLen As %Integer = 10000, pStartOffset As %Integer = 1) as %String
This method is for use from the RawContent property's SQL Compute invocation

Queries

query EnumerateDocTypes(Category As %String = "", IncludeBase As %Boolean = 1)
Selects Type As %String
Returns a list of available DocTypes for this document class.
The DocType is returned as the first column in the result set.
The Category parameter can be used to restrict the list.
If Category is:
0 - return only DocTypes in standard categories
+ - return only DocTypes in user-defined categories
empty - return DocTypes from all categories
a category name - return only DocTypes in the named category
a partial name suffixed with '%' - return only DocTypes in categories matching the partial category name
other - return nothing
If IncludeBase is:
0 - return only DocTypes defined in the current schema category itself
1 - return all DocTypes in the current schema category's base category in addition to those defined in the current category itself
query EnumerateSegTypes(Category As %String = "", Level As %String = "")
Selects SegType As %String, Field As %String, Description As %String, IsStandard As %Boolean
Returns a list of schema categories and segment types and segment fields for this document class.
The Category and Level parameters can be used to restrict the list.
If Category is:
0 - return only standard categories
+ - return only user-defined categories
empty - return all categories
a category name - return only SegTypes in the named category
a category name:segment type name - return only information about the named SegType
a partial name suffixed with '%' - return only SegTypes in categories matching the partial category name
other - return nothing
If Level is:
0 - return all segment names
n - return the given number of levels of nested field names within each segment
empty - return all levels of nested field names within each segment
If IncludeBase is:
0 - return only segment names defined in the current schema category itself
1 - return all segment names in the current schema category's base category in addition to those defined in the current category itself
query EnumerateTypeCategories(Standard As %String = "")
Selects Category As %String, Description As %String, IsStandard As %Boolean, Base As %String
Returns a list of document type schema categories for the document class.
The Standard parameter can be used to restrict the list.
If Standard is: 0 - return only standard categories + - return only user-defined categories empty - return all categories a partial category name - return only categories starting with the given category name part
other - return nothing

Indexes

index (Extent on ) [Extent, Type = bitmap];
Index methods: ExtentClose(), ExtentExecute(), ExtentFetch(), ExtentFetchRows(), ExtentFunc(), ExtentGetInfo(), ExtentGetODBCInfo(), ExtentPrepare(), ExtentSendODBC()
index (IDKEY on ) [IdKey, Type = key];
Index methods: IDKEYCheck(), IDKEYDelete(), IDKEYExists(), IDKEYOpen(), IDKEYSQLCheckUnique(), IDKEYSQLExists(), IDKEYSQLFindPKeyByConstraint(), IDKEYSQLFindRowIDByConstraint()
index (OriginalDocId on OriginalDocId);
Index methods: OriginalDocIdDisplayToLogical(), OriginalDocIdExists(), OriginalDocIdGet(), OriginalDocIdGetStored(), OriginalDocIdIsValid(), OriginalDocIdLogicalToDisplay(), OriginalDocIdLogicalToOdbc(), OriginalDocIdNormalize(), OriginalDocIdSet()

Triggers

trigger OnDelete (BEFORE event DELETE);

Inherited Members

Inherited Properties

Inherited Methods

Storage

Storage Model: CacheStorage (EnsLib.EDI.ASTM.Document)

^EnsLib.EDI.ASTM.DocumentD(ID,"Attachments",n)
=
Attachments(n)

Storage Model: CacheStorage (EnsLib.EDI.ASTM.Document)

^EnsLib.EDI.ASTM.DocumentD(ID)
=
%%CLASSNAME
ParentId
DocType
IsMutable
TimeCreated
Source
OriginalDocId
Envelope

Storage Model: CacheStorage (EnsLib.EDI.ASTM.Document)

^EnsLib.EDI.ASTM.DocumentD(ID,"UserValues",n)
=
UserValues(n)
FeedbackOpens in a new tab