Objektrelationen

GetItems

Wichtig: Es wird empfohlen, diese Methode mit Vorsicht zu verwenden, da hierbei alle assoziierten Objekte geladen werden und dies zu einer Verschlechterung der Leistung führt.

GetItems ermittelt über die angegebene Assoziation die zu diesem Objekt assoziierten Objekte. Dabei können sowohl die untergeordneten als auch übergeordneten Objekte ermittelt werden.

Syntax	*GetItems(flags, nfirst, nlast, assocdef)*
Parameter	flags numerischer Wert. Sofern Sie übergeordnete Objekte abfragen möchten, vergeben Sie den Wert „&H10000“, andernfalls (also für die untergeordneten Objekte) wählen Sie den Wert 0 („&H00000“). nfirst numerischer Wert. Ein auf 0 basierender Index für das erste abzufragende Objekt. Sofern Sie alle Objekte abfragen möchten, geben Sie den Wert -1 an. nlast numerischer Wert. Ein auf 0 basierender Index für das letzte abzufragende Objekt. Sofern Sie alle Objekte abfragen möchten, geben Sie den Wert -1 an. assocdef Variant. Für diesen Wert kann entweder ein numerischer Wert, die Assoziations-Def-ID oder der Name der Assoziation (Variant(String)) angegeben werden.
Rückgabewert	assoziierte Processes-Objekte als Variant (Collection, IHlObject)

GetItems(&H10000,-1,-1,AssocDefID) – liefert die über eine bestimmte Assoziation übergeordneten Objekte als Array.

Beispiel:

hlobj.GetItems(&H10000,-1,-1,103413) – liefert die einem Produkt übergeordneten Organisationseinheiten.

GetItems(&H00000,-1,-1,AssocDefID) – liefert die über eine bestimmte Assoziation untergeordneten Objekte als Array.

Beispiel:

hlobj.GetItems(&H00000,-1,-1,100703) – liefert die einem Mitarbeiter zugeordneten Produkte.

GetItemCount

Wichtig: Es wird empfohlen, diese Methode mit Vorsicht zu verwenden, da hierbei alle assoziierten Objekte geladen werden und dies zu einer Verschlechterung der Leistung führt.

GetItemCount ermittelt die Anzahl assoziierter Objekte. Für die angegebene Assoziation kann dabei die Anzahl sowohl für untergeordnete als auch übergeordnete Objekte ermittelt werden.

Syntax	*GetItemCount(flags, assocdef)*
Parameter	flags numerischer Wert. Sofern Sie übergeordnete Objekte abfragen möchten, vergeben Sie den Wert „&H10000“, andernfalls (also für die untergeordneten Objekte) wählen Sie den Wert 0 („&H00000“). assocdef Variant. Für diesen Wert kann entweder ein numerischer Wert, die Assoziations-Def-ID oder der Name der Assoziation (Variant(String)) angegeben werden.
Rückgabewert	Anzahl der Objekte als numerischer Wert.
Beispiel	`hlobj.GetItemCount (&H10000,103413)` liefert die Anzahl der einem Produkt übergeordneten Organisationseinheiten.

AddItem

AddItem ordnet das angegebene Objekt dem Objekt unter, für das diese Methode aufgerufen wird. Mit dieser Funktion können Sie Assoziationen objektbezogen verwalten.

Syntax	*AddItem (flags, object, assocdef)*
Parameter	flags numerischer Wert. Wird nicht verwendet und sollte 0 sein. object zuzuordnendes Objekt als Variant(IHlObject). assocdef Variant. Für diesen Wert kann entweder ein numerischer Wert, die Assoziations-Def-ID oder der Name der Assoziation (Variant (String)) angegeben werden.
Beispiel	`Orgunit.AddItem (0, Person, 103410)` ordnet das Personenobjekt <Person> der Organisationseinheit <Orgunit> zu.

RemoveItem

RemoveItem löscht die angegebene Assoziation zwischen dem angegebenen untergeordneten Objekt und dem Objekt, für das diese Methode aufgerufen wird. Mit dieser Funktion können Sie Assoziationen objektbezogen verwalten.

Syntax	*RemoveItem(flags, object, assocdef)*
Parameter	flags numerischer Wert. Wird nicht verwendet und sollte 0 sein. object Objekt, zu dem die Assoziation gelöscht werden soll, als Variant(IHlObject) assocdef Variant. Für diesen Wert kann entweder ein numerischer Wert, die Assoziations-Def-ID oder der Name der Assoziation (Variant(String)) angegeben werden.
Beispiel	`Person.RemoveItem (0, Asset, 100703)` löscht die Assoziation zwischen dem Personenobjekt <Person> und dem zugeordneten Inventar <Asset>.