Merge Method (PIGroups collection)

               

 

The Merge method is passed an existing PIGroups collection (typically from another Server) and adds the user groups to the current Server.

 

Not Implemented

 

Syntax

object.Merge NewGroups, MergeFlag, nvErrors

The Merge method syntax has these parts:

Part

Description

object

An object expression that evaluates to a PIGroups collection.

NewGroups

A PIGroups collection containing users to be added to the Server

MergeFlag

A flag indicating how the merge is to be performed (see Settings below for possible values).

nvErrors

A reference to a NamedValues collection which is used to return errors. When a Merge is executed it may only be partly successful. The nvErrors collection contains a NamedValue object for each group that was not added to the server. The object’s name is that of the group and the value is an error constant.

 

Settings

The settings for mergeFlag are:

Setting

Description

mrgIgnoreDuplicates

If the passed collection contains a PIGroup with the same name as an existing PIGroup, that passed PIGroup is not added and no error is indicated.

mrgFlagDuplicates

 If the passed collection contains a PIGroup with the same name as an existing PIGroup, an error is reported in the nvErrors collection for that group.

 

Enabling Operational Intelligence