New in AM2004: Programming and Customization

Visual Basic Customization

• The version number of the AMEDM and AMOML type libraries has been upgraded to 5.0. Customization projects should reference these new type libraries to be able to access newly introduced functionality.
  
  The 3.0 type libraries are still installed for backwards compatibility.
  
  Note:
  The sample projects and project templates installed with this release still reference the 3.0 type libraries.
   
• A more flexible server method has been created to change property values of objects (documents) in the vault. For detailed information please read the AutoManager Developer Help.
   
• Invoking a Task from a UIExtension would fail if the selected object was not a document. This has been corrected.

Scripting

• Property names in scripting are no longer case sensitive.
   
• It is now possible to use custom functions. See also: Using custom functions in scripting expressions
   
• Document properties have been added to the scripting model to test for references.

• HasIncomingReferences - Returns True if the document is referenced.
   
• HasOutgoingReferences - Returns True if the document references other documents.
   

The sample script below demonstrates how to use the HasOutgoingReferences property to warn the user when deriving an assembly.

Sub DocCopyMoveEvent_BeforeDerive(Batch, TargetFolder)

    ' Only show the NOTE for documents with outgoing references

    If Document.HasOutgoingReferences Then

        ' Only show the NOTE once per batch

        If Not Batch.Argument("NoteShown") Then

            WinMsgBox "NOTE: You are about to Derive an Assembly, be sure " &

                            "you manually Derive all Parts and/or Sub Assemblies " &

                            "that will be changed as well." , vbOKOnly

            Batch.Argument("NoteShown") = True

        End If        

    End If

End Sub

• Document properties have been added to check or change the existence of Redlines:
  Document.HasRedlines - Returns the value of the 'Has Redlines' property. See 'Has Redlines' property.
  Document.ClearRedlines - Removes any existing redlines for the document.
  
• A new constant has been added to the 'Confirmation' options in scripting. The AS_CONFIRM_DOC_OPENREADONLY constant can be used to hide the confirmation dialog that is by default shown when opening a read-only document for editing. Please refer to the Configurator Guide for an explanation of the 'Client.Confirmation' option.
  
• A property, AMFSPath, has been added to reporting to get the AMFS path of a document. This property can also be used for vaults that use Local Workspace.