NEW AMMGetReportTableRowValues function

NEW

AMMGetReportTableRowValues function

Returns the array of column values for the Excel report.

Syntax

Function AMMGetReportTableRowValues(TagId As String, Status As Byte, VaultObjectProperties As String, DrawingObjectProperties As String, AccumulatedData As Variant) 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 – a string value that uniquely identifies the object in Meridian Enterprise. If the object is not found in Meridian Enterprise, the value is Nothing. Referenced – a 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 – A string that contains the X coordinate provided by PnIDLink_GetAssetCoordinates. Y – A string that contains the Y coordinate provided by PnIDLink_GetAssetCoordinates. LayerName – The string name of the layer on which the asset exists. PnIDProperties – An array of property values for the asset in the form Array(PnIDProperty1, … PnIDPropertyN). The names of the properties are returned by the NEW AMMPropertiesToBeRequested function.
AccumulatedData	A variant that contains user-defined data that can be accumulated from call to call and then passed to the NEW AMMGetReportCustomHeaderValues function.

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 – a string value that uniquely identifies the object in Meridian Enterprise. If the object is not found in Meridian Enterprise, the value is Nothing.
Referenced – a 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 – A string that contains the X coordinate provided by PnIDLink_GetAssetCoordinates.
Y – A string that contains the Y coordinate provided by PnIDLink_GetAssetCoordinates.
LayerName – The string name of the layer on which the asset exists.
PnIDProperties – An array of property values for the asset in the form Array(PnIDProperty1, … PnIDPropertyN). The names of the properties are returned by the NEW AMMPropertiesToBeRequested function.

AccumulatedData

A variant that contains user-defined data that can be accumulated from call to call and then passed to the NEW AMMGetReportCustomHeaderValues function.

Status parameter byte values
Value	Status	A	B	C	D	E	F	Comment
0	NotDefined	Status is not calculated yet. This status cannot be sent during a correct request.
1	Ok	+	+	+	+	-	-
2	NotLinked	+	+	-	+	-	-
3	OnlyInDocument	-	+	n/a	n/a	n/a	-
4	MismatchFound	+	+	-	-	-	-
5	MismatchReferenced	+	+	+	-	-	-
6	CoercedReference	+	-	+	n/a	-	n/a
7	OnlyInVault	+	-	-	n/a	-	n/a	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	+	?	?	?	+	-
9	DuplicatesInDrawing	?	+	?	?	-	+
10	Duplicates	+	+	?	?	+	+
254	Error	Status calculation failed for any reason.

Status parameter byte values

Value

Status

Comment

NotDefined

Status is not calculated yet. This status cannot be sent during a correct request.

NotLinked

OnlyInDocument

n/a

MismatchFound

MismatchReferenced

CoercedReference

n/a

OnlyInVault

n/a

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.

DuplicatesInVault

DuplicatesInDrawing

Duplicates

254

Error

Status calculation failed for any reason.

Conditions

A – Vault object exists

B – Drawing object exists

C – Reference exists

D – Tag type of vault object is matched with one of drawing object

E – Vault objects with duplicate tag values exist