Fullscreen Image

This section covers Meridian Enterprise 2026. View other versions.

AMMGetCustomColumnValues Function

Returns an array of column values for the Drawing Tags dialog box.

Syntax

Function AMMGetCustomColumnValues(TagId As String, Status As Byte, VaultObjectProperties As String, 
DrawingObjectProperties As String) As String
Parameters
Name Description

TagId

Tag number.

Status

Tag reference status described in the following table.

VaultObjectProperties

Array of the property values for the Meridian Enterprise object in the form Array(AMObjectId, Referenced).

The dimensions of the array are as follows:

  • AMObjectId: String value that uniquely identifies the object in Meridian Enterprise. If the object is not found in Meridian Enterprise, the value is Nothing

  • Referenced: Boolean value indicating whether the object has a tag reference

DrawingObjectProperties

Array of the property values for the asset in the form Array(TagType, X, Y, LayerName, PnIDProperties).

The dimensions of the array are as follows:

  • TagType: The string name of the tag type

  • X: String that contains the X coordinate provided by PnIDLink_GetAssetCoordinates

  • Y: String that contains the Y coordinate provided by PnIDLink_GetAssetCoordinates

  • LayerName: The string name of the layer on which the asset exists

  • PnIDProperties: Array of property values for the asset in the form Array(PnIDProperty1, … PnIDPropertyN). The names of the properties are returned by the AMMPropertiesToBeRequested Function.

Status parameter byte values
Value Status Vault Object Exists Drawing Object Exists Reference Exists

Tag Type of Vault Object is Matched with One of Drawing Object

Vault Objects with Duplicate Tag Values Exist

Drawing Objects with Duplicate Tag Values Exist

Comment
0 NotDefined Not Available Not Available Not Available Not Available Not Available Not Available Status is not calculated yet. This status cannot be sent during a correct request.
1 Ok Yes Yes Yes Yes No No  
2 NotLinked Yes Yes No Yes No No  
3 OnlyInDocument No Yes Not Available Not Available Not Available No  
4 MismatchFound Yes Yes No No No No  
5 MismatchReferenced Yes Yes Yes No No No  
6 CoercedReference Yes No Yes Not Available No Not Available  
7 OnlyInVault Yes No No Not Available No Not Available Object with this status exists just after unlink vault object with CoercedReference status. If the object will not be relinked (by Link or Assign) then the row will be deleted on the next refresh.
8 DuplicatesInVault Yes condition is not checked condition is not checked condition is not checked Yes No  
9 DuplicatesInDrawing condition is not checked Yes condition is not checked condition is not checked No Yes  
10 Duplicates Yes Yes condition is not checked condition is not checked Yes Yes  
254 Error Not Available Not Available Not Available Not Available Not Available Not Available Status calculation failed for any reason.

Example

Function AMMGetCustomColumnValues(TagId, Status, VaultObjectProperties, DrawingObjectProperties)
 Dim mCustomColumnValues(1)
    Dim mArray
    If Not IsNull(DrawingObjectProperties) And IsArray(DrawingObjectProperties) Then
        mArray = DrawingObjectProperties(4)
        If Not IsNull(mArray) And IsArray(mArray) Then
            mCustomColumnValues(0) = mArray(0)
            AMMGetCustomColumnValues = mCustomColumnValues
        End If
    End If
End Function

Remarks

Called for every asset in the drawing.