API User's Guide

Object identification in Alloy Navigator Express

Via the API, Alloy Navigator Express objects can be referenced by two distinctive types of identifiers:

  • The object identifier (OID) is a string value used to uniquely identify an object. The actual field that holds the object identifier depends on the class of an object. It is either Ticket for tickets or ID (the OID database field) for other object classes.

    Example: Ticket: T000002 (Ticket) or ID: C000057 (Computer).

  • The primary key of the database record containing the information about an object is a field that uniquely defines object records in the database. In the Alloy Navigator Express database, the primary key is the ID field containing the object’s GUID. This is an internal field, hidden from the user interface.

    Example: {EB6D7E24-59CA-4532-B365-451724A7B880}.

In order to retrieve an object, you need to specify its object identifier in the HTTP request as the <oid> parameter value.

For information about object identifiers available for each object class, see the following table.

Object Class Object Identifier Comments

Announcements

OID, ID

 

Computers

OID, ID

 

Consumables

OID, ID

 

Contracts

OID, ID

 

Inventory Items

OID, ID

 

Knowledge Base Articles

OID, ID

 

Library Items

OID, ID

 

Locations

OID, ID

 

Organizations

OID, ID

 

Persons

OID, ID

 

Products

OID, ID

 

Purchase Order Items

ID

You can only refer to objects of this class by their primary keys. To obtain the database ID of a specific object record, use GET(POST) /api/v2/<objectClass> request.

For details, see Retrieving objects (GET).

Purchase Orders

OID, ID

 

Reservations

OID, ID

 

Software Catalog

ID

You can only refer to objects of this class by their primary keys. To obtain information about a particular object of this class, use GET(POST) /api/v2/<objectClass> requests with filtering.

For details, see Retrieving objects (GET).

Note that the other API functions cannot be used for objects of this class.

Software Licenses

OID, ID

 

Threshold Notification Rules

OID, ID

 

Tracked Software

OID, ID

 

Vendor Products

ID

You can only refer to objects of this class by their primary keys. To obtain the database ID of a specific object record, use GET(POST) /api/v2/<objectClass> request.

For details, see Retrieving objects (GET).

Vendors

OID, ID

 

Tickets

Ticket, ID