hlObj

AddItem

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

Syntax

hlObj.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

Das Personenobjekt „Person“ soll der Organisationseinheit „Orgunit“ zugeordnet werden:

Orgunit.AddItem 0, Person, 103410

AddItemEx

Diese Methode assoziiert das angegebene Objekt entsprechend der angegebenen Assoziation mit dem Objekt, für das die Methode aufgerufen wird. Im Unterschied zur Methode „AddItem“ wird bei der Methode „AddItemEx“ auch der Service-Einheiten-Index mit angegeben, so dass diese Methode verwendet werden kann, um den Anfrager bzw. das Produkt einer Service-Einheit zu setzen.

Syntax

hlObj.AddItemEx(flags,object, suidx, assocdef)

Parameter

flags: numerischer Wert (vgl. AddItem). Dieser Wert sollte immer 0 betragen.

object: zu assoziierendes Objekt als Variant (IHlObject).

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die die Assoziation erstellt werden soll.

Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu.

Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.

assocdef: Variant. Für diesen Wert kann entweder ein numerischer Wert, die Assoziations-Def-ID oder der Name der Assoziation (Variant (String)) angegeben werden.

AddValue

Diese Methode fügt einem multiplen Attribut einen Wert hinzu.

Syntax

hlObj.AddValue("attributeKey", langID, suidx, "val")

Parameter

attributeKey: Schlüssel des Attributs als Variant (String)

langID: Sprach-ID, z. B. 7 = Deutsch, 9 = Englisch

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die die Werte geprüft werden sollen.

value: Variant (String) oder Wert, der für das angegebene Attribut gesetzt werden soll (Definitionsname!)

Beispiel

Dem multiplen Attribut soll das Schlagwort „Sonstige“ hinzugefügt werden:

hlObj.AddValue „Keywords.Keyword“, 0, 0, „KeywordOther“

AppendAttachment

Diese Methode fügt dem Objekt einen neuen Anhang hinzu.

Syntax

hlObj.AppendAttachment("attributeKey", suidx, attachment)

Parameter

attributeKey: Schlüssel des Anhangsattributs als Variant (String). Der Standardschlüssel ist HLOBJECTINFO.ATTACHMENT.

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die der Anhang hinzugefügt werden soll.

Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu.

Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.

AppendServiceUnit

Diese Methode fügt dem Vorgang eine neue Service-Einheit hinzu.

Syntax	*hlObj.AppendServiceUnit(flags)*
Parameter	*flags*: numerischer Wert. Wenn Sie Anfrager, Produkt und Organisation aus der vorherigen Service-Einheit übernehmen möchten, setzen Sie den Wert auf &H1000, andernfalls auf 0.
Rückgabewert	Index der neuen Service-Einheit als numerischer Wert

Anmerkung: Wenn Sie eine SU über diese Methode hinzufügen, wird die Ansicht des SU-Navigators nicht automatisch aktualisiert. Sie können Sie aber aktualisieren, indem Sie die Methode „CurrentSUIndex“ in Verbindung mit dem zurückgegebenen Index der neuen Service-Einheit verwenden:

Dim index
index = hlObj.AppendServiceUnit(0)
model.CurrentSUIndex = index

CreateAttachment

Diese Methode erzeugt einen neuen Anhang.

Syntax

hlObj.CreateAttachment("attributeKey", suidx)

Parameter

attributeKey: Schlüssel des Anhangsattributs als Variant (String), also HLOBJECTINFO.ATTACHMENT oder SUINFO.ATTACHMENT. Der Parameter sollte auf „nothing“ gesetzt werden. Um die Anhangsdatei anzuhängen, verwenden Sie die Methode AppendAttachment (siehe Beispiel).

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die der Anhang angelegt werden soll.

Setzen Sie den Wert auf 0, um einen Anhang für die letzte Service-Einheit zu erzeugen.

Dieser Parameter wird ignoriert, es sei denn der Objekttyp ist „Vorgang“. Für andere Objekttypen sollten Sie den Wert auf 0 setzen.

Beispiel:

‘Anhangsobjekt erzeugen

Set hlAttach = hlObj.CreateAttachment(nothing, 0)

‘Daten des Anhangs

hlAttach.SetURL strFilepathDestination & strFileName & ".docx"

‘Anhang an das Objekt anhängen

hlObj.AppendAttachment "SUINFO.ATTACHMENT", model.CurrentSUIndex,hlAttach

Rückgabewert

Anhangsobjekt als Variant (IHlAttachment)

GenerateContentID

Diese Methode erzeugt eine neue eindeutige Content-ID.

Syntax	hlObj.GenerateContentID()
Rückgabewert	numerischer Wert

GetAttachment

Diese Methode ermittelt das Anhangsobjekt (Anhang) für die angegebene ID.

Syntax	*hlObj.GetAttachment("attributeKey", id, suidx)*
Parameter	*attributeKey: Schlüssel des Anhangsattributs als Variant (String). Der Standardschlüssel ist HLOBJECTINFO.ATTACHMENT. id: Anhangs-ID als numerischer Wert. Die Anhangs-IDs können mit der Methode „GetAttachmentKeys“ ermittelt werden. suidx*: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die der Anhang ermittelt werden soll. Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu. Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.
Rückgabewert	Anhangsobjekt als Variant (IHlAttachment)
Beispiel	Das Anhangsobjekt mit der ID „AttachID“ soll ermittelt werden: Set hlAttachment = hlCase.GetAttachment("HLOBJECTINFO.ATTACHMENT", AttachID, 0) Es kann dann mit Methoden wie „GetSize()“, „GetName()“ weiter bearbeitet werden.

GetAttachmentKeys

Diese Methode ermittelt für den angegebenen Attributschlüssel die IDs der an das Objekt angehängten Anlagen.

Syntax	*hlObj.GetAttachmentKeys("attributeKey", suidx)*
Parameter	*attributeKey: Schlüssel des Anhangsattributs als Variant (String). Der Standardschlüssel ist „HLOBJECTINFO.ATTACHMENT“. suidx*: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die die IDs der Anhänge ermittelt werden sollen. Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu. Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.
Rückgabewert	Anhangs-Ds als Variant (Collection, numerisch). Das Anhangsobjekt für eine bestimmte ID kann mit der Methode „GetAttachment“ ermittelt werden.
Beispiel	Die Content-IDs der Anhänge eines Vorgangs sollen ermittelt werden: AttachIDs = hlCase.GetAttachmentKeys("HLOBJECTINFO.ATTACHMENT",0)

GetBaseType

Diese Methode ermittelt den Basisobjekttyp des Objekts.

Syntax

hlObj.GetBaseType

Rückgabewert

numerischer Wert

2 = Vorgang

3 = Person

4 = Organisationseinheit

5 = Produkt

7 = Vertrag

GetContentIDs

Diese Methode ermittelt die Content-IDs für multiple Attribute als Array. Mit der Methode „GetValue“ kann über eine Content-ID der entsprechende Wert abgefragt werden.

Syntax	*hlObj.GetContentIDs("attributeKey", suidx)*
Parameter	*attributeKey: Schlüssel des Attributs als Variant (String) suidx*: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die die Content-IDs ermittelt werden sollen. Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu. Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.
Rückgabewert	Variant (Collection, numerisch)
Beispiel	Die Content-IDs der Kostenstellen einer Person (des Anfragers) sollen ermittelt werden: ContIDs = hlCaller.GetContentIDs("PersonBilling.CostCenter_CA",0)

GetID

Diese Methode ermittelt die ID der Anhänge.

Syntax	hlObj.GetID()
Rückgabewert	numerischer Wert

GetItemCount

VORSICHT: Es wird empfohlen, diese Methode mit Vorsicht zu verwenden, da hierbei alle assoziierten Objekte geladen werden und dies zu einer Verschlechterung der Performance führt. Aus diesem Grund werden beim Ausführen dieser Methode nur bis zu 1000 Objekte geladen.

Diese Methode 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	*hlObj.GetItemCount(flags, assocdef)*
Parameter	*flags: numerischer Wert. Sofern Sie übergeordnete Objekte abfragen möchten, gebenSie den Wert „&H10000“ ein, andernfalls (also für die untergeordneten Objekte) 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	Die Anzahl der einem Produkt übergeordneten Organisationseinheiten soll zurückgegeben werden: hlobj.GetItemCount(&H10000,103413)

GetItems

VORSICHT: Es wird empfohlen, diese Methode mit Vorsicht zu verwenden, da hierbei alle assoziierten Objekte geladen werden und dies zu einer Verschlechterung der Performance führt. Aus diesem Grund werden beim Ausführen dieser Methode nur bis zu 1000 Objekte geladen.

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

Syntax

hlObj.GetItems(flags, nfirst, nlast, assocdef)

Parameter

flags: numerischer Wert. Sofern Sie übergeordnete Objekte abfragen möchten, geben Sie den Wert „&H10000“ ein, andernfalls (also für die untergeordneten Objekte) den Wert „0“ („&H00000“).

nfirst: numerischer Wert. Ein 0-basierter Index für das erste abzufragende Objekt. Sofern Sie alle Objekte abfragen möchten, geben Sie den Wert „-1“ an.

nlast: numerischer Wert. Ein 0-basierter 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 helpLine Objekte als Variant (Collection, IHlObject).

HINWEIS: 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.

HINWEIS: 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.

GetItemsEx

VORSICHT: Es wird empfohlen, diese Methode mit Vorsicht zu verwenden, da hierbei alle assoziierten Objekte geladen werden und dies zu einer Verschlechterung der Performance führt. Aus diesem Grund werden beim Ausführen dieser Methode nur bis zu 1000 Objekte geladen.

Diese Methode ermittelt zu der angegebenen Assoziation die mit diesem Objekt assoziierten Objekte. Dabei können sowohl die untergeordneten als auch übergeordneten Objekte ermittelt werden. Im Unterschied zur Methode „GetItems“ wird bei der Methode „GetItemsEx“ auch der Service-Einheit-Index mit angegeben, so dass diese Methode verwendet werden kann, um die mit einer Service-Einheit assoziierten Objekte (Anfrager, Produkt) abzufragen.

Syntax

hlObj.GetItemsEx(flags, suidx, assocdef)

Parameter

flags: numerischer Wert (vgl. GetItem). Dieser Wert sollte immer 0 betragen.

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die die Objekte abgefragt werden sollen.

Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu.

Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.

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 helpLine Objekte als Variant (Collection, IHlObject)

GetReserver

Diese Methode ermittelt die ID des Agenten, von dem der Vorgang reserviert ist.

Syntax	hlObj.GetReserver()
Rückgabewert	ID des Agenten als numerischer Wert

GetSvcUnitCount

Diese Methode ermittelt die Anzahl der Service-Einheiten des Vorgangs.

Syntax	hlObj.GetSvcUnitCount()
Rückgabewert	Anzahl des Service-Einheiten als numerischer Wert

GetSvcUnitIndices

Diese Methode ermittelt die Indices der Service-Einheiten des Vorgangs und gibt sie als Array zurück.

Syntax	hlObj.GetSvcUnitIndices()
Rückgabewert	Indices der Service-Einheiten als Variant (Collection, numerischer Wert)
Beispiel	SUIndices = hlobj.GetSvcUnitIndices()

Anmerkung: Der höchste und niedrigste Wert des Arrays kann dann mit „Ubound“ bzw. „Lbound“ ermittelt werden.

Beispiel: LastSU = Ubound(SUIndices), FirstSU = LBound(SUIndices)

GetTreeValueLevel

Diese Methode ermittelt die Ebene des angegeben Schlagworts.

Syntax	*hlObj.GetTreeValueLevel("attributePath", valueID)*
Parameter	*attributePath: vollständiger Attributpfad inkl. ODE des Schlagworts, z. B. „Keywords.Keyword“ valueID*: ID des Schlagworts
Rückgabewert	Zahl: Index der Schlagwortebene Die Indizes der Ebenen sind dabei nullbasiert, d. h. die erste Ebene hat den Index 0, die zweite den Index 1, etc.
Beispiel	Für jedes ausgewählte Schlagwort soll die Ebene im Schlagwortbaum ermittelt werden: Dim valKeywordID : valKeywordID = 0 Dim valKeywordIDs : valKeywordIDs = "" Dim Level : Level = "" valKeywordIDs = hlObj.GetValueIDs("Keywords.Keyoword",0,0) For Each valKeywordID IN valKeywordIDs Level = hlObj.GetTreeValueLevel("Keywords.Keyword",valKeywordID) Next

GetTreeValuePath

Diese Methode ermittelt den kompletten Attributpfad des Schlagworts.

Syntax

hlObj.GetTreeValuePath("Keyword", langID, KeywordID)

Parameter

keyword: Schlagwort

langID: Sprach-ID, z. B. „7“ (=Deutsch) oder „9“ (=Englisch)

keywordID: numerischer Wert

Beispiel

Für jedes ausgewählte Schlagwort soll der Attributpfad ermittelt werden:

Dim valKeywordID : valKeywordID = 0

Dim valKeywordIDs : valKeywordIDs = ""

Dim strTest : strTest = ""

valKeywordIDs = hlObj.GetValueIDs("Keywords.Keyoword",0,0)

For Each valKeywordID IN valKeywordIDs

strTest = hlObj.GetTreeValuePath("Keywords.Keyword ",7,valKeywordID)

Next

GetType

Diese Methode ermittelt den Objekttyp des helpLine Objekts.

Syntax	hlObj.GetType()
Rückgabewert	Definitionsname des ermittelten Objekttyps als Variant (String)

GetValue

Diese Methode ermittelt den Wert für das angegebene Attribut.

Syntax	*hlObj.GetValue("attributeKey", lcid, contentid, suidx, datatype)*
Parameter	*attributeKey: Schlüssel des Attributs als Variant (String) Anmerkung: Beim Aufrufen der Funktion wird geprüft, ob das Attribut zu dem angegebenen Schlüssel existiert. Gibt es das Attribut nicht, wird eine Fehlermeldung ausgegeben. lcid: numerischer Wert. Sprach-ID (z. B. „1031“ für Deutsch (Deutschland) oder „1033“ für Englisch (USA)). contentid: numerischer Wert. Wird nur bei multiplen Attributen verwendet und gibt die Content-ID an, für die der Wert ermittelt werden soll. Für alle anderen Attribute kann „0“ angegeben werden. Anmerkung: Die Content-IDs multipler Attribute können über die Methode „GetContentIDs“ ermittelt werden. suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die der Wert ermittelt werden soll. Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu. Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen. datatype*: numerischer Wert, der festlegt, welchen Datentyp der zurückgegebene Wert belegt. Wert 0: Der Attributwert wird im Textformat zurückgegeben. Wert 1: Der Attributwert wird in seinem ursprünglichen Format zurückgegeben, also Datum bei einem Datumsattribut, Text bei einem Zeichenkettenattribut usw. Wert 2: Der komplette Schlagwortpfad wird zurückgegeben, z. B. „KeywordSoftware.KeywordOffice“.
Rückgabewert	Variant Der Typ des Variants hängt vom angegebenen Datentyp (Parameter „datatype“) ab.
Beispiel	Der Name des Objekts soll zurückgegeben werden: *hlobj.GetValue("PersonGeneral.PersonName",0,0,0,0)* Das Schlagwort des Objekts soll zurückgegeben werden: *hlobj.GetValue("Keywords.Keyword",0,0,0,2)*

GetValueIDs

Diese Methode ermittelt die Werte-IDs eines multiplen Attributs.

Syntax

hlObj.GetValueIDs("attributeKey", contentid, suidx)

Parameter

attributeKey: Schlüssel des Attributs als Variant (String), z. B. „PersonBilling.CostCenter_CA”

Anmerkung: Beim Aufrufen der Funktion wird geprüft, ob das Attribut zu dem angegebenen Schlüssel existiert. Gibt es das Attribut nicht, wird eine Fehlermeldung ausgegeben.

contentid: numerischer Wert. Wird nur bei multiplen Attributen verwendet und gibt die Content-ID an, für die der Wert ermittelt werden soll.

Für alle anderen Attribute kann „0“ angegeben werden.

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die die Werte ermittelt werden sollen.

Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu.

Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.

Rückgabewert

Werte-IDs als Variant (Collection, numerisch).

HasContent

Diese Methode prüft für multiple Attribute, ob Werte gesetzt sind.

Syntax

hlObj.HasContent("attributeKey", reserved, suidx)

Parameter

attributeKey: Schlüssel des Attributs als Variant (String), z. B. „PersonBilling.CostCenter_CA”

reserved: numerischer Wert, muss 0 sein.

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die die Werte geprüft werden sollen.

Bei Vorgängen greifen Sie über eine Belegung mit 0 auf die letzte Service-Einheit zu.

Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu.

Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.

Rückgabewert

numerischer Wert

Sofern das Attribut keinen Inhalt aufweist, beträgt der Wert 0, andernfalls ist der Wert ungleich 0.

IsNew

Diese Methode prüft, ob das Objekt neu angelegt und noch nicht gespeichert wurde.

Syntax

hlObj.IsNew()

Rückgabewert

numerischer Wert

Sofern das Objekt noch nicht gespeichert wurde, ist der Wert 1, andernfalls 0.

IsReadOnly

Diese Methode prüft, ob das angegebene Attribut bearbeitet werden darf.

Syntax

hlObj.IsReadOnly("attributeKey", suidx)

Parameter

attributeKey: Schlüssel des Attributs als Variant (String), z. B. „HLOBJECTINFO.CREATIONTIME“.

Wenn Sie einen leeren Schlüssel angeben, wird geprüft, ob das Objekt selbst geändert werden darf.

Anmerkung: Beim Aufrufen der Funktion wird geprüft, ob das Attribut zu dem angegebenen Schlüssel existiert. Gibt es das Attribut nicht, wird eine Fehlermeldung ausgegeben.

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die das Attribut geprüft werden soll.

Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu.

Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.

Rückgabewert

numerischer Wert

Sofern das Attribut nicht geändert werden darf, ist der Wert 1, andernfalls 0.

RemoveAttachment

Diese Methode entfernt das angegebene Anhangsobjekt für die angegebene Service-Einheit aus dem Anhangsattribut.

Syntax	*hlObj.RemoveAttachment("attributeKey", suidx, attachment)*
Parameter	*attributeKey: Schlüssel des Anhangsattributs als Variant (String). Der Standardschlüssel ist HLOBJECTINFO.ATTACHMENT. suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, aus der der Anhang entfernt werden soll. Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu. Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen. attachment*: Anhangsobjekt als Variant (IHlAttachment)
Rückgabewert	Anhangsobjekt als Variant (IHlAttachment)
Beispiel	Alle Anhänge dieser Service-Einheit sollen entfernt werden: Dim hlAttachKeys, hlAttachKey, hlAttach hlAttachKeys=hlObj.GetAttachmentKeys("SUINFO.ATTACHMENT",model.CurrentSUIndex) For Each hlAttachKey In hlAttachKeys Set hlAttach=hlObj.GetAttachment("SUINFO.ATTACHMENT", hlAttachKey,model.CurrentSUIndex) hlObj.RemoveAttachment "SUINFO.ATTACHMENT",model.CurrentSUIndex, hlAttach Next

RemoveContentID

Diese Methode löscht bei einem multiplen Attribut den angegebenen Wert (Datensatz).

Syntax

hlObj.RemoveContentID("attributeKey", contentid, suidx)

Parameter

attributeKey: Schlüssel des Attributs als Variant (String), z. B. „PersonBilling.CostCenter_CA“

contentid: numerischer Wert. Wird nur bei multiplen Attributen verwendet und gibt die Content-ID an, für die der Wert gelöscht werden soll.

Für alle anderen Attribute kann „0“ angegeben werden.

Anmerkung: Die Content-IDs multipler Attribute können über die Methode „GetContentIDs“ ermittelt werden.

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die der Wert gelöscht werden soll.

Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu.

Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.

RemoveItem

Diese Methode 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	hlObj.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	Die Assoziation zwischen dem Personenobjekt „Person“ und dem zugeordneten Inventar „Asset“ soll gelöscht werden: Person.RemoveItem 0, Asset, 100703

RemoveItemEx

Diese Methode löscht die angegebene Assoziation zwischen dem angegebenen Objektund dem Objekt, für das die Methode aufgerufen wird. Im Unterschied zur Methode „RemoveItem“ wird bei der Methode „RemoveItemEx“ auch der Service-Einheiten-Index mit angegeben, so dass diese Methode verwendet werden kann, um Anfrager bzw. Produkt einer Service-Einheit zu entfernen.

Syntax

hlObj.RemoveItemEx(flags, object, suidx, assocdef)

Parameter

flags: numerischer Wert (vgl. RemoveItem). Dieser Wert sollte immer 0 betragen.

object: zu entfernendes Objekt als Variant (IHlObject).

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die die Assoziation entfernt werden soll.

Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu.

Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.

assocdef: Variant. Für diesen Wert kann entweder ein numerischer Wert, die Assoziations-Def-ID oder der Name der Assoziation (Variant (String)) angegeben werden.

Reserve

Diese Methode reserviert den Vorgang für den angemeldeten Agenten.

Syntax

hlObj.Reserve()

ResetContent

Diese Methode löscht alle Werte (Datensätze) eines multiplen Attributs.

Syntax

hlObj.ResetContent "attributeKey", suidx

Parameter

attributeKey: Schlüssel des Attributs als Variant (String), z. B. „PersonBilling.CostCenter_CA“

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die die Werte gelöscht werden sollen.

Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu.

Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.

SetValue

Setzt den Wert für das angegebene Attribut.

Achtung: Wird diese Methode für multiple Attribute verwendet, werden alle Werte des multiplen Attributs durch den hier gesetzten Wert überschrieben. Daher sollte bei multiplen Attributen stattdessen die Methode „AddValue“ verwendet werden.

Syntax

hlObj.SetValue "attributeKey", long lcid, contentid, suidx, "val"

Parameter

attributeKey: Schlüssel des Attributs als Variant (String)

Anmerkung: Beim Aufrufen der Funktion wird geprüft, ob das Attribut zu dem angegebenen Schlüssel existiert. Gibt es das Attribut nicht, wird eine Fehlermeldung ausgegeben.

lcid: numerischer Wert. Sprach-ID (z. B. „1031“ für Deutsch (Deutschland) oder „1033“ für Englisch (USA)).

contentid: numerischer Wert. Wird nur bei multiplen Attributen verwendet und gibt die Content-ID an, für die der Wert ermittelt werden soll.

Für alle anderen Attribute kann „0“ angegeben werden.

Anmerkung: Die Content-IDs multipler Attribute können über die Methode „GetContentIDs“ ermittelt werden.

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die der Wert gesetzt werden soll.

Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu.

Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.

val: Variant (String) oder Wert, der für das angegebene Attribut gesetzt werden soll (interner Name).

Beispiel

Die Priorität des Vorgangs soll auf “Hoch” gesetzt werden:

hlobj.SetValue "CaseClassificationAttribute.Priority",0,0,0,“PriorityHigh“

Anmerkung: „GetValue“ benötigt die Klammer, „SetValue“ nicht!

SetValueIDs

Diese Methode setzt für ein multiples Attribut eine Liste von Werte-IDs.

Syntax

hlObj.SetValueIDs("attributeKey", contentid, suidx, valueids)

Parameter

attributeKey: Schlüssel des Attributs als Variant (String), z. B. „PersonBilling.CostCenter_CA“

Anmerkung: Beim Aufrufen der Funktion wird geprüft, ob das Attribut zu dem angegebenen Schlüssel existiert. Gibt es das Attribut nicht, wird eine Fehlermeldung ausgegeben.

contentid: numerischer Wert. Wird nur bei multiplen Attributen verwendet und gibt die Content-ID an, für die die Werte gesetzt werden sollen.

Für alle anderen Attribute kann „0“ angegeben werden.

suidx: numerischer Wert. Wird nur bei Vorgängen verwendet und gibt den 1-basierten Index der Service-Einheit an, für die der Wert gesetzt werden soll.

Über eine Belegung mit 0 greifen Sie auf die letzte Service-Einheit zu.

Sofern das Objekt nicht vom Typ „Vorgang“ ist, wird dieser Parameter ignoriert. In diesem Fall sollten Sie den Wert mit einer 0 belegen.

valueids: Werte-IDs als Variant (Collection, numerisch).

Unreserve

Durch diese Methode wird ein reservierter Vorgang freigegeben. Die Freigabe kann nur für Vorgänge erfolgen, die selbstreserviert sind, d.h. die sich auf dem eigenen Arbeitstisch des Agenten befinden.

Syntax

hlObj.Unreserve()