|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.remedy.cmdb.api.CMDBInstance
The CMDBInstance
class is used to work with CMDB Instances.
New set of API with CMDB 2.0 is a common class to deal with both CI and
Relationship instances.
Field Summary | |
static int |
CMDB_ATTACHMENT_LOCATION_BUFFER
The attachment is store in a data buffer |
static int |
CMDB_ATTACHMENT_LOCATION_FILE
The attachment is stored in a file |
static int |
CMDB_ATTACHMENT_LOCATION_NONE
No attachment is stored |
static int |
CMDB_DATASET_ACCESSIBILITY_READ_ONLY
A dataset that is read only |
static int |
CMDB_DATASET_ACCESSIBILITY_WRITABLE
A dataset that is writable |
static int |
CMDB_DATASET_ACCESSIBLITY_WRITABLE_BY_CLIENT_TYPE
A dataset that is writable certain client types |
static int |
CMDB_DATASET_TYPE_OVERLAY
Overlay dataset type |
static int |
CMDB_DATASET_TYPE_REGULAR
Regular dataset type |
static int |
CMDB_GET_DATASET_MODE_CURRENT
Find in the curerent Dataset only |
static int |
CMDB_GET_MASK_NONE
Take no action |
static int |
CMDB_NO_MAX_LIST_RETRIEVE
No maximum limit for the number of entries retrieved in the list. |
static int |
CMDB_START_WITH_FIRST_INSTANCE
Retrieves from result set starting with the first instance. |
Constructor Summary | |
CMDBInstance(CMDBClassNameKey aClassKey)
Creates an CMDBInstance object with minimum information. |
|
CMDBInstance(CMDBClassNameKey aClassKey,
java.util.Map anAttrValuesMap)
Constructor that creates an CMDBInstance object with the information provided. |
Method Summary | |
void |
create(ARServerUser context)
Creates the current CMDBClass instance in AR System. |
void |
create(ARServerUser context,
java.lang.String aDatasetId)
Creates the current CMDBClass instance in AR System. |
static void |
delete(ARServerUser context,
CMDBClassNameKey aClassKey,
java.lang.String instanceId,
int deleteOption)
Deletes the current CMDBClass instance from AR System. |
static void |
delete(ARServerUser context,
CMDBClassNameKey aClassKey,
java.lang.String aDatasetId,
java.lang.String instanceId,
int deleteOption)
Deletes the current CMDBClass instance from AR System. |
static java.lang.String[] |
find(ARServerUser context,
CMDBClassNameKey aClassKey,
QualifierInfo query,
CMDBSort[] sortArray,
int firstRetrieve,
int maxRetrieve,
java.lang.Integer numMatches)
Finds all qualified CMDBClass instances in AR System |
static java.lang.String[] |
find(ARServerUser context,
CMDBClassNameKey aClassKey,
java.lang.String query,
CMDBSort[] sortArray,
int firstRetrieve,
int maxRetrieve,
java.lang.Integer numMatches)
Finds the IDs of all CMDBClass instances in AR System |
static java.lang.String[] |
find(ARServerUser context,
CMDBClassNameKey aClassKey,
java.lang.String aDatasetId,
int aGetMask,
QualifierInfo query,
CMDBSort[] sortArray,
int firstRetrieve,
int maxRetrieve,
java.lang.Integer numMatches)
Finds all qualified CMDBClass instances in AR System |
static java.lang.String[] |
find(ARServerUser context,
CMDBClassNameKey aClassKey,
java.lang.String aDatasetId,
int aGetMask,
java.lang.String query,
CMDBSort[] sortArray,
int firstRetrieve,
int maxRetrieve,
java.lang.Integer numMatches)
Finds the IDs of all CMDBClass instances in AR System |
static void |
findBlobByKey(ARServerUser context,
CMDBClassNameKey aClassKey,
java.lang.String aDatasetId,
int aGetMask,
java.lang.String instanceId,
java.lang.String attributeName,
AttachmentInfo attachment)
Finds the specified attachment attribute from AR System. |
static void |
findBlobByKey(ARServerUser context,
CMDBClassNameKey aClassKey,
java.lang.String instanceId,
java.lang.String attributeName,
AttachmentInfo attachment)
Finds the specified attachment attribute from AR System. |
static CMDBInstance |
findByKey(ARServerUser context,
CMDBClassNameKey aClassKey,
int aGetMask,
java.lang.String aDatasetId,
java.lang.String instanceId,
java.lang.String[] attributeNames)
Finds the specified CMDBClass instance in AR System |
static CMDBInstance |
findByKey(ARServerUser context,
java.lang.String instanceId,
CMDBClassNameKey aClassKey,
java.lang.String[] attributeNames)
Finds the specified CMDBClass instance in AR System |
static CMDBInstance[] |
findObjects(ARServerUser context,
CMDBClassNameKey aClassKey,
QualifierInfo query,
java.lang.String[] attributeGetList,
CMDBSort[] sortArray,
int firstRetrieve,
int maxRetrieve,
java.lang.Integer numMatches)
Finds all qualified CMDBClass instances in AR System |
static CMDBInstance[] |
findObjects(ARServerUser context,
CMDBClassNameKey aClassKey,
java.lang.String[] instanceIds,
java.lang.String[] attributeGetList)
Finds all specified CMDBClass instances in AR System |
static CMDBInstance[] |
findObjects(ARServerUser context,
CMDBClassNameKey aClassKey,
java.lang.String aDatasetId,
int aGetMask,
QualifierInfo query,
java.lang.String[] attributeGetList,
CMDBSort[] sortArray,
int firstRetrieve,
int maxRetrieve,
java.lang.Integer numMatches)
Finds all qualified CMDBClass instances in AR System |
static CMDBInstance[] |
findObjects(ARServerUser context,
CMDBClassNameKey aClassKey,
java.lang.String aDatasetId,
int aGetMask,
java.lang.String[] instanceIds,
java.lang.String[] attributeGetList)
Finds all specified CMDBClass instances in AR System |
static CMDBInstance[] |
findObjects(ARServerUser context,
CMDBClassNameKey aClassKey,
java.lang.String aDatasetId,
int aGetMask,
java.lang.String query,
java.lang.String[] attributeGetList,
CMDBSort[] sortArray,
int firstRetrieve,
int maxRetrieve,
java.lang.Integer numMatches)
Finds all qualified CMDBClass instances in AR System |
static CMDBInstance[] |
findObjects(ARServerUser context,
CMDBClassNameKey aClassKey,
java.lang.String query,
java.lang.String[] attributeGetList,
CMDBSort[] sortArray,
int firstRetrieve,
int maxRetrieve,
java.lang.Integer numMatches)
Finds all qualified CMDBClass instances in AR System |
CMDBAttributeValue |
getAttributeValueByName(java.lang.String name)
Use the attribute name as a map key to find the attribute value. |
java.util.Map |
getAttributeValues()
Gets the attribute values. |
CMDBClassNameKey |
getClassKey()
Gets the key of the class that the instance belongs to. |
int |
getGetMask()
Gets the instance datasetSetMode |
java.lang.String |
getId()
Gets the instance ID |
void |
setAttributeValues(java.util.Map newAttrValueMap)
Replaces the attribute values of the instance. |
void |
update(ARServerUser context)
Saves the change made to the current CMDBClass instance in AR System. |
void |
update(ARServerUser context,
java.lang.String aDatasetId)
Saves the change made to the current CMDBClass instance in AR System. |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final int CMDB_START_WITH_FIRST_INSTANCE
public static final int CMDB_NO_MAX_LIST_RETRIEVE
public static final int CMDB_ATTACHMENT_LOCATION_NONE
public static final int CMDB_ATTACHMENT_LOCATION_FILE
public static final int CMDB_ATTACHMENT_LOCATION_BUFFER
public static final int CMDB_GET_MASK_NONE
public static final int CMDB_GET_DATASET_MODE_CURRENT
public static final int CMDB_DATASET_ACCESSIBILITY_WRITABLE
public static final int CMDB_DATASET_ACCESSIBILITY_READ_ONLY
public static final int CMDB_DATASET_ACCESSIBLITY_WRITABLE_BY_CLIENT_TYPE
public static final int CMDB_DATASET_TYPE_REGULAR
public static final int CMDB_DATASET_TYPE_OVERLAY
Constructor Detail |
public CMDBInstance(CMDBClassNameKey aClassKey)
aClassKey
- the class key of the CMDBClass that the instance
belongs topublic CMDBInstance(CMDBClassNameKey aClassKey, java.util.Map anAttrValuesMap)
aClassKey
- the name key of the class that the instance is
associated withanAttrValuesMap
- the attribute values are organized into a
map that uses the attribute name as its map key, and CMDBAttributeValue
as its mapped value
java.lang.IllegalArgumentException
- if map value is not CMDBAttributeValueMethod Detail |
public CMDBClassNameKey getClassKey()
public java.lang.String getId()
public int getGetMask()
public java.util.Map getAttributeValues()
public CMDBAttributeValue getAttributeValueByName(java.lang.String name)
name
- the name of the attribute
public void setAttributeValues(java.util.Map newAttrValueMap)
newAttrValueMap
- the new attribute values to be set
java.lang.IllegalArgumentException
- if map value is not CMDBAttributeValuepublic void create(ARServerUser context) throws ARException
context
- ARSystemUser structure that contains user
and host information
ARException
- if the instance cannot be created in AR Systempublic void create(ARServerUser context, java.lang.String aDatasetId) throws ARException
context
- ARSystemUser structure that contains user
and host informationaDatasetId
- the DatasetId of the instance
ARException
- if the instance cannot be created in AR Systempublic static void delete(ARServerUser context, CMDBClassNameKey aClassKey, java.lang.String instanceId, int deleteOption) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the name key of the class that the instance belongs toinstanceId
- the id of the instance to be deleteddeleteOption
- Delete option. Possible values are:
ARException
- if the instance cannot be deletedpublic static void delete(ARServerUser context, CMDBClassNameKey aClassKey, java.lang.String aDatasetId, java.lang.String instanceId, int deleteOption) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the name key of the class that the instance belongs toinstanceId
- the id of the instance to be deleteddeleteOption
- Delete option. Possible values are:
ARException
- if the instance cannot be deletedpublic static void findBlobByKey(ARServerUser context, CMDBClassNameKey aClassKey, java.lang.String instanceId, java.lang.String attributeName, AttachmentInfo attachment) throws ARException
ARServerUser
parameter. User permissions are
verified for the specified attribute. If the user cannot access the
attribute, the system returns an error message.
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toinstanceId
- the ID of the instance to look forattributeName
- name of the attribute that has the attachmentattachment
- the location of the returned attachment.
The attachment can be stored in a file
CMDB_ATTACHMENT_LOCATION_FILE
or in a buffer
CMDB_ATTACHMENT_LOCATION_BUFFER
.
If it is stored in a file, then file name should be specified in this argument.
The returned attachment object is also saved in this object.
ARException
- if the specified attachment can't be located.public static void findBlobByKey(ARServerUser context, CMDBClassNameKey aClassKey, java.lang.String aDatasetId, int aGetMask, java.lang.String instanceId, java.lang.String attributeName, AttachmentInfo attachment) throws ARException
ARServerUser
parameter. User permissions are
verified for the specified attribute. If the user cannot access the
attribute, the system returns an error message.
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toaDatasetId
- datasetidaGetMask
- the get mask (current, overlay, etc)instanceId
- the ID of the instance to look forattributeName
- name of the attribute that has the attachmentattachment
- the location of the returned attachment.
The attachment can be stored in a file
CMDB_ATTACHMENT_LOCATION_FILE
or in a buffer
CMDB_ATTACHMENT_LOCATION_BUFFER
.
If it is stored in a file, then file name should be specified in this argument.
The returned attachment object is also saved in this object.
ARException
- if the specified attachment can't be located.public static java.lang.String[] find(ARServerUser context, CMDBClassNameKey aClassKey, java.lang.String query, CMDBSort[] sortArray, int firstRetrieve, int maxRetrieve, java.lang.Integer numMatches) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toquery
- a string where you specify a qualification for retrieving instances
For example, to locate instances of class BMC:AssetBase, where Cost Center
is "BMC" and Order ID is 5, the qualification will be:
'Cost Center' = "BMC" AND 'Order ID' = 5
So, the name of the attribute you are querying for is always
surrounded in single quotes. For each attribute, if the datatype
is string, then enclose the string you are looking for in double
quotes (as in the above example, "BMC"). For integers, you
do not need to put any quotes around it.firstRetrieve
- First instance retrieved for the query chunk.
CMDB_START_WITH_FIRST_INSTANCE
means retrieve the first instance from AR System.maxRetrieve
- Maximum instances to retrieve for the query.
CMDB_NO_MAX_LIST_RETRIEVE
means unlimited instances are retrieved.numMatches
- Will return the total number of (accessible) instances that match the qualification criteria.
Specify null for this parameter if you do not want to retrieve this count.
ARException
- if failed to return all matched instancespublic static java.lang.String[] find(ARServerUser context, CMDBClassNameKey aClassKey, java.lang.String aDatasetId, int aGetMask, java.lang.String query, CMDBSort[] sortArray, int firstRetrieve, int maxRetrieve, java.lang.Integer numMatches) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toaDatasetId
- DatasetId of which you want to retrieve instancesaGetMask
- the get mask (current, overlay, etc)query
- a string where you specify a qualification for retrieving instances
For example, to locate instances of class BMC:AssetBase, where Cost Center
is "BMC" and Order ID is 5, the qualification will be:
'Cost Center' = "BMC" AND 'Order ID' = 5
So, the name of the attribute you are querying for is always
surrounded in single quotes. For each attribute, if the datatype
is string, then enclose the string you are looking for in double
quotes (as in the above example, "BMC"). For integers, you
do not need to put any quotes around it.firstRetrieve
- First instance retrieved for the query chunk.
CMDB_START_WITH_FIRST_INSTANCE
means retrieve the first instance from AR System.maxRetrieve
- Maximum instances to retrieve for the query.
CMDB_NO_MAX_LIST_RETRIEVE
means unlimited instances are retrieved.numMatches
- Will return the total number of (accessible) instances that match the qualification criteria.
Specify null for this parameter if you do not want to retrieve this count.
ARException
- if failed to return all matched instancespublic static java.lang.String[] find(ARServerUser context, CMDBClassNameKey aClassKey, QualifierInfo query, CMDBSort[] sortArray, int firstRetrieve, int maxRetrieve, java.lang.Integer numMatches) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toquery
- an query object where you specify a qualification for retrieving instancesfirstRetrieve
- First instance retrieved for the query chunk.
CMDB_START_WITH_FIRST_INSTANCE
means retrieve the first instance from AR System.maxRetrieve
- Maximum instances to retrieve for the query.
CMDB_NO_MAX_LIST_RETRIEVE
means unlimited instances are retrieved.numMatches
- Will return the total number of (accessible) instances that match the qualification criteria.
Specify null for this parameter if you do not want to retrieve this count.
ARException
- if failed to return all matched instancespublic static java.lang.String[] find(ARServerUser context, CMDBClassNameKey aClassKey, java.lang.String aDatasetId, int aGetMask, QualifierInfo query, CMDBSort[] sortArray, int firstRetrieve, int maxRetrieve, java.lang.Integer numMatches) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toaDatasetId
- DatasetId of which you want to retrieve instancesaGetMask
- the get mask (current, overlay, etc)query
- an query object where you specify a qualification for retrieving instancesfirstRetrieve
- First instance retrieved for the query chunk.
CMDB_START_WITH_FIRST_INSTANCE
means retrieve the first instance from AR System.maxRetrieve
- Maximum instances to retrieve for the query.
CMDB_NO_MAX_LIST_RETRIEVE
means unlimited instances are retrieved.numMatches
- Will return the total number of (accessible) instances that match the qualification criteria.
Specify null for this parameter if you do not want to retrieve this count.
ARException
- if failed to return all matched instancespublic static CMDBInstance[] findObjects(ARServerUser context, CMDBClassNameKey aClassKey, java.lang.String query, java.lang.String[] attributeGetList, CMDBSort[] sortArray, int firstRetrieve, int maxRetrieve, java.lang.Integer numMatches) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toquery
- a string where you specify a qualification for retrieving instances
For example, to locate instances of class BMC:AssetBase, where Cost Center
is "BMC" and Order ID is 5, the qualification will be:
'Cost Center' = "BMC" AND = 'Order ID' = 5
So, the name of the attribute you are querying for is always
surrounded in single quotes. For each attribute, if the datatype
is string, then enclose the string you are looking for in double
quotes (as in the above example, "BMC"). For integers, you
do not need to put any quotes around it.attributeGetList
- the attribute to be retrieved. If attributeGetList
is NULL, then all attribute values of the instance will be
returned.firstRetrieve
- First instance retrieved for the query chunk.
CMDB_START_WITH_FIRST_INSTANCE
means retrieve the first instance from AR System.maxRetrieve
- Maximum instances to retrieve for the query.
CMDB_NO_MAX_LIST_RETRIEVE
means unlimited instances are retrieved.numMatches
- Will return the total number of (accessible) instances that match the qualification criteria.
Specify null for this parameter if you do not want to retrieve this count.
ARException
- if failed to return all matched instancespublic static CMDBInstance[] findObjects(ARServerUser context, CMDBClassNameKey aClassKey, java.lang.String aDatasetId, int aGetMask, java.lang.String query, java.lang.String[] attributeGetList, CMDBSort[] sortArray, int firstRetrieve, int maxRetrieve, java.lang.Integer numMatches) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toaDatasetId
- DatasetId of which you want to retrieve instancesaGetMask
- the get mask (current, overlay, etc)query
- a string where you specify a qualification for retrieving instances
For example, to locate instances of class BMC:AssetBase, where Cost Center
is "BMC" and Order ID is 5, the qualification will be:
'Cost Center' = "BMC" AND = 'Order ID' = 5
So, the name of the attribute you are querying for is always
surrounded in single quotes. For each attribute, if the datatype
is string, then enclose the string you are looking for in double
quotes (as in the above example, "BMC"). For integers, you
do not need to put any quotes around it.attributeGetList
- the attribute to be retrieved. If attributeGetList
is NULL, then all attribute values of the instance will be
returned.firstRetrieve
- First instance retrieved for the query chunk.
CMDB_START_WITH_FIRST_INSTANCE
means retrieve the first instance from AR System.maxRetrieve
- Maximum instances to retrieve for the query.
CMDB_NO_MAX_LIST_RETRIEVE
means unlimited instances are retrieved.numMatches
- Will return the total number of (accessible) instances that match the qualification criteria.
Specify null for this parameter if you do not want to retrieve this count.
ARException
- if failed to return all matched instancespublic static CMDBInstance[] findObjects(ARServerUser context, CMDBClassNameKey aClassKey, QualifierInfo query, java.lang.String[] attributeGetList, CMDBSort[] sortArray, int firstRetrieve, int maxRetrieve, java.lang.Integer numMatches) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toquery
- an query object where you specify a qualification for retrieving instancesattributeGetList
- the attribute to be retrieved. If attributeGetList
is NULL, then all attribute values of the instance will be
returned.firstRetrieve
- First instance retrieved for the query chunk.
CMDB_START_WITH_FIRST_INSTANCE
means retrieve the first instance from AR System.maxRetrieve
- Maximum instances to retrieve for the query.
CMDB_NO_MAX_LIST_RETRIEVE
means unlimited instances are retrieved.numMatches
- Will return the total number of (accessible) instances that match the qualification criteria.
Specify null for this parameter if you do not want to retrieve this count.
ARException
- if failed to return all matched instancespublic static CMDBInstance[] findObjects(ARServerUser context, CMDBClassNameKey aClassKey, java.lang.String aDatasetId, int aGetMask, QualifierInfo query, java.lang.String[] attributeGetList, CMDBSort[] sortArray, int firstRetrieve, int maxRetrieve, java.lang.Integer numMatches) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toaDatasetId
- DatasetId of which you want to retrieve instancesaGetMask
- the get mask (current, overlay, etc)query
- an query object where you specify a qualification for retrieving instancesattributeGetList
- the attribute to be retrieved. If attributeGetList
is NULL, then all attribute values of the instance will be
returned.firstRetrieve
- First instance retrieved for the query chunk.
CMDB_START_WITH_FIRST_INSTANCE
means retrieve the first instance from AR System.maxRetrieve
- Maximum instances to retrieve for the query.
CMDB_NO_MAX_LIST_RETRIEVE
means unlimited instances are retrieved.numMatches
- Will return the total number of (accessible) instances that match the qualification criteria.
Specify null for this parameter if you do not want to retrieve this count.
ARException
- if failed to return all matched instancespublic static CMDBInstance[] findObjects(ARServerUser context, CMDBClassNameKey aClassKey, java.lang.String[] instanceIds, java.lang.String[] attributeGetList) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toinstanceIds
- an array of instance idsattributeGetList
- the attribute to be retrieved. If attributeGetList
is NULL, then all attribute values of the instance will be
returned.
ARException
- if failed to return all matched instancespublic static CMDBInstance[] findObjects(ARServerUser context, CMDBClassNameKey aClassKey, java.lang.String aDatasetId, int aGetMask, java.lang.String[] instanceIds, java.lang.String[] attributeGetList) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toaDatasetId
- DatasetId of which you want to retrieve instancesaGetMask
- the get mask (current, overlay, etc)instanceIds
- an array of instance idsattributeGetList
- the attribute to be retrieved. If attributeGetList
is NULL, then all attribute values of the instance will be
returned.
ARException
- if failed to return all matched instancespublic static CMDBInstance findByKey(ARServerUser context, java.lang.String instanceId, CMDBClassNameKey aClassKey, java.lang.String[] attributeNames) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toinstanceId
- the ID of the instance to look forattributeNames
- the list of attributes to retrieve.
ARException
- if the specified instance can't be locatedpublic static CMDBInstance findByKey(ARServerUser context, CMDBClassNameKey aClassKey, int aGetMask, java.lang.String aDatasetId, java.lang.String instanceId, java.lang.String[] attributeNames) throws ARException
context
- ARSystemUser structure that contains user
and host informationaClassKey
- the key of the class that the instance belongs toinstanceId
- the ID of the instance to look foraDatasetId
- the DatasetId of the instanceaGetMask
- the get mask (current or overlay)attributeNames
- the list of attributes to retrieve.
ARException
- if the specified instance can't be locatedpublic void update(ARServerUser context) throws ARException
context
- ARSystemUser structure that contains user
and host information
ARException
- if the instance cannot be updated in AR Systempublic void update(ARServerUser context, java.lang.String aDatasetId) throws ARException
context
- ARSystemUser structure that contains user
and host informationaDatasetId
- the DatasetId of the instance
ARException
- if the instance cannot be updated in AR System
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |