Home > Class Reference > ENSLIB namespace > EnsLib.DICOM.Util.AssociationContext

EnsLib.DICOM.Util.AssociationContext

persistent class EnsLib.DICOM.Util.AssociationContext extends %Library.Persistent, %XML.Adaptor

SQL Table Name: EnsLib_DICOM_Util.AssociationContext

This class represents a DICOM Association Context. It manages data which defines various parameters which are exchanged with the DICOM peer during the connection negotiation process. Items include the names of the calling and called Application Entity Titles (AETs), the maximum physical size of TCP data packets along with a list of one or more presentation context objects which defines of which services are/should be available and their associated transfer syntaxes

Property Inventory (Including Private)

Method Inventory (Including Private)

Properties (Including Private)

property CalledAET as %String (MAXLEN = 16) [ Required ];
This holds the Application Entity Title of the called DICOM Peer. Together with the CallingAET, this property uniquely defines the object instance
Property methods: CalledAETDisplayToLogical(), CalledAETGet(), CalledAETGetStored(), CalledAETIsValid(), CalledAETLogicalToDisplay(), CalledAETLogicalToOdbc(), CalledAETNormalize(), CalledAETSet()
property CallingAET as %String (MAXLEN = 16) [ Required ];
This holds the Application Entity Title of the calling DICOM Peer. Together with the CalledAET, this property uniquely defines the object instance
Property methods: CallingAETDisplayToLogical(), CallingAETGet(), CallingAETGetStored(), CallingAETIsValid(), CallingAETLogicalToDisplay(), CallingAETLogicalToOdbc(), CallingAETNormalize(), CallingAETSet()
property Description as %String (MAXLEN = 256);
This holds the Description of the Association Context
Property methods: DescriptionDisplayToLogical(), DescriptionGet(), DescriptionGetStored(), DescriptionIsValid(), DescriptionLogicalToDisplay(), DescriptionLogicalToOdbc(), DescriptionNormalize(), DescriptionSet()
property Name as %String (MAXLEN = 64);
This holds the Name of the Association Context
Property methods: NameDisplayToLogical(), NameGet(), NameGetStored(), NameIsValid(), NameLogicalToDisplay(), NameLogicalToOdbc(), NameNormalize(), NameSet()
property PresentationContexts as list of EnsLib.DICOM.Util.PresentationContext;
This holds the list of presentation contexts
Property methods: PresentationContextsBuildValueArray(), PresentationContextsCollectionToDisplay(), PresentationContextsCollectionToOdbc(), PresentationContextsDisplayToCollection(), PresentationContextsGet(), PresentationContextsGetObject(), PresentationContextsGetObjectId(), PresentationContextsGetStored(), PresentationContextsGetSwizzled(), PresentationContextsIsValid(), PresentationContextsOdbcToCollection(), PresentationContextsSet(), PresentationContextsSetObject(), PresentationContextsSetObjectId()

Methods (Including Private)

private method %OnNew(pCallingAET As %CacheString, pCalledAET As %CacheString) as %Status
Inherited description: This callback method is invoked by the %New() method to provide notification that a new instance of an object is being created.

If this method returns an error then the object will not be created.

It is passed the arguments provided in the %New call. When customizing this method, override the arguments with whatever variables and types you expect to receive from %New(). For example, if you're going to call %New, passing 2 arguments, %OnNew's signature could be:

Method %OnNew(dob as %Date = "", name as %Name = "") as %Status If instead of returning a %Status code this returns an oref and this oref is a subclass of the current class then this oref will be the one returned to the caller of %New method.

private method %OnValidateObject() as %Status
This callback method is invoked by the %ValidateObject() method to provide notification that the current object is being validated.

If this method returns an error then %ValidateObject() will fail.

classmethod ActiveClose(ByRef qHandle As %Binary) as %Status
classmethod ActiveDetailClose(ByRef qHandle As %Binary) as %Status
classmethod ActiveDetailExecute(ByRef qHandle As %Binary, pGUID As %String) as %Status
classmethod ActiveDetailFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) as %Status
classmethod ActiveExecute(ByRef qHandle As %Binary) as %Status
classmethod ActiveFetch(ByRef qHandle As %Binary, ByRef Row As %List, ByRef AtEnd As %Integer = 0) as %Status
classmethod CreateAssociation(pCallingAET As %String, pCalledAET As %String, pTransferSyntaxes As %List = $ListBuild($$$IMPLICITVRLETRANSFERSYNTAX)) as %Status
This method creates an AssociationContext instance for the specified calling and called AET for AbstractSyntaxes which supports ALL known SOPs. The TCP Adapter will use the definitions defined here to validate associations It should be noted that this association simply defines all SOP classes that are known in the data dictionary. There is a small performance penalty for this and it may be preferable to define just the SOP classes needed either with the UI tool found at EMP/Maintenance/DICOM SETTINGS or by using the ImportAssociation() method above. Note that the default transfer syntax here is the DICOM mandated IMPLICIT VR little endian syntax.
classmethod ExportXML(pFileName As %String, pCallingAET As %String, pCalledAET As %String) as %Status
This method exports an Association Context as XML into the specified file
classmethod ImportAssociation(pFileName As %String, pCallingAET As %String, pCalledAET As %String, pOverWriteExisting As %Boolean = 0)
This method is passed a filename containing a list of presentation contexts containing SOP/TransferSyntax pairs An Association will be created between the pair of AETs containing the information from the file
classmethod ImportXML(pFileName) as %Status
This method imports a file containing an AssociationContext
method OnAcceptPresentationContext(pAbstractSyntax As %String, ByRef pTransferSyntaxes, Output pSelect