Object Transactions

Objects can be attached to various items in ASM.

Limited Support/End of Life Capabilities

The Classic API has been replaced by the Alemba RestFul API. While we will continue to support the Classic API for clients that are still using it, no further development will be done.

If you need to request a hotfix or support for these features, please contact Alemba Support

ObjectAttach Transaction

The ObjectAttach transaction can be used to link an object to an item.

The object size limit specified for entities in the main application does not apply to any objects uploaded via the API. Alemba® recommends setting any size limit required in your own code.

To find out the size limits that apply to objects being uploaded via the API, you should run the following queries:

• To find out the size limit when attaching objects to calls and CMDB items, run the query:

SELECT NUMBER_STATUS FROM SU_SYS_PARAMETERS WHERE REF = 20

• To find out the size limit when attaching objects to requests, tasks and workflow templates, run the query:

SELECT NUMBER_STATUS FROM CR_SYS_PARAMETERS WHERE REF = 5

These queries will return the object file size in kb.

The ObjectAttach transaction is only available through the COM/DCOM interface and not the Web Service.

Object uploads cannot be done via Web Services without using an API. Therefore, object uploads cannot be done via the Web Service Tester.

As a file object is actually a binary array that cannot be entered in a text field, and the Web Service API tester does not allow for binary fields, the only way to test object uploads is via an API.

Input Parameters: ObjectAttachRequest

Argument	Type	Mandatory	Default	Description
sID	String	No. See Transaction Login.	“”	Analyst’s current Session ID
sLoginUserID	String	No. See Transaction Login.	“”	Analyst’s Login ID
sLoginPassword	String	No. See Transaction Login.	“”	Analyst’s Password
sDatabase	String	No. See Transaction Login.	“”	Name of the ASM System for logging in.
lEntityRef	Lookup Field	Yes	-	Entity reference in which to attach an object.
eEntityType	Enumerated	Yes	-	Entity type in which to attach an object. Values: User Organization Location Contract Agreement Knowledge entry Bulletin board entry Call Request Task CMDB item Subscriber group
sFileName	String	Yes	-	Path of the file to attach to the entity.
xContent	Byte()	No	-	Object to attach. This field cannot be used via the WS tester application.
nContentSize	Integer	No	0	Size of the object to attach. This field is ignored if the object size can be calculated from the actual content.
sObjectAbstract	String	No	“”	Object abstract
sObjectTitle	String	No	“”	Object title
yLite	Yes/No	No	N	Indicate whether this object is visible on the Self Service Portal. Values: Y = object will be visible on the Self Service Portal N = object will not be visible on the Self Service Portal
nVersion	Integer	No	1	Object Version
nVersionOrder	Integer	No	1	Object Version order
lSecurityProfile	Lookup Field	No	0	Security profile to apply to the Object
aCustomParameters	Array	No	“”	See Defining Custom Parameters.

Return Values: ObjectAttachResponse