Glossary

agent a device’s firmware component that communicates with jetstream alias an alternate name a device may assume to communicate on behalf of the alias a device may report an alias’s objectevent docid 6kkkdbv1sxgpehyq9dh0j for example, if you store inventory in three separate offices, you could create three aliases in jetstream, each representing an office, associate these aliases to a ts084 handheld rfid device, and then use the one device to report the present inventory from any one of these locations application an application created within jetstream, representing a logical boundary containing devices and users security is setup and configured at the application level for users the users within an application can only communicate and interact with the devices within that application this should not be confused with your in house developed application that consumes jetstream messages command a request or query assigned to a terso rfid device a command is executed on a device a command will be one of three types, described below, and will behave differently depending on whether the device is online or offline command type device is online device is offline synchronous, queueable immediate execution queued execution synchronous, not queueable immediate execution failure to execute not synchronous, queueable immediate execution queued execution command id a 36 character guid tying the following pieces of a command request together command response, commandqueuedevent, and commandcompletionevent each of these components will have the same value in their "commandid" property depending on which command type is being handled in a command request, these three parts will be created at different times and may end up buried with many other responses and events using their common "commandid" property enables you to gather all three pieces to determine if execution of a command on a device was successful or not command response a reply received within the response body from a command request being executed depending on the command type that was executed, described below, results are returned in the response body or not command type results returned in the response body? synchronous yes – see the glossary docid\ k wnsotemg6 ggtqd 6gs and glossary docid\ k wnsotemg6 ggtqd 6gs glossary entries for more information not synchronous no – see the glossary docid\ k wnsotemg6 ggtqd 6gs or glossary docid\ k wnsotemg6 ggtqd 6gs of the related commandcompletionevent docid\ sj1tshbqvf4fri6az1ywg configuration a setup, change, or request performed on a jetstream application configuration actions are performed for the maintenance and management of jetstream resources (e g , devices, device definitions, policies, events) credential a login record containing the authentication information needed to access a device and/or an application jetstream should not be considered the system of record for credentials and customers should be managing and maintaining credentials in their own systems while working with jetstream device a terso rfid device our intelligent devices come in the form factors of enclosures, mobile cases, kiosks, and handhelds websockets capable devices are able to process eligible commands right away, providing near real time interaction at the moment, device types that are not websockets capable include handheld docid\ mwq ucnvczj5cgj upuje and mobile case docid\ zfaaxxwarhrs 208ipdcq all other devices are websockets capable device definition a unique collection of settings defining the capabilities of a specific type of terso rfid device the settings are a combination of identifiers (e g , name, firmware version, configuration parameters) for the device and capabilities (e g , restart, update firmware, scan for rfid tags) the device supports the proper device definition for your device can always be provided by terso support https //www tersosolutions com/support/ epc an electronic product code (epc) is an identifier encoded onto an rfid tag, which can then be read by rfid devices event a message capturing information pertaining to the single occurrence of a process an event pertains to a device process and/or a jetstream process the table below summarizes the available event types and the process they relate to event type device process jetstream process aggregateevent x aliasaddedevent x aliasmodifiedevent x aliasremovedevent x objectevent x commandqueuedevent x commandcompletionevent x deviceaddedevent x devicemodifiedevent x deviceremovedevent x devicecredentialsaddedevent x devicecredentialsmodifiedevent x devicecredentialsremovedevent x heartbeatevent x logentryevent x sensorreadingevent x statusevent x events provide a window into all that is occurring in your jetstream application below are some, but not all of the questions events can answer what rfid tags were added/removed from a device during the last door open/close? what rfid tags are currently in a device? what commands have been queued for a device to process? what commands have been completed on/processed by a device? what devices have been added to a jetstream application? what devices have been removed from a jetstream application? what devices have/don’t have internet connectivity? what devices have a low battery? what are the temperature readings of a device? exception list a listing of exceptions while executing a command on a device or any issues in queuing/dequeuing the command immediate results results associated with the execution of a command on a device these results are returned to the calling system immediately in these circumstances, the calling system will receive a command response as well as a commandcompletionevent offline a connection status of a device indicating that it is not connected to jetstream either the device is not websockets enabled/capable or has lost power/internet connectivity online a connection status of a device indicating that it is connected to jetstream the device is websockets enabled and/or has power and internet connectivity output parameter list a listing of key value/parameter value settings resulting from the execution of a command on a device policy a unique collection of settings to manage a device’s configuration values (the configuration parameters are defined by the device’s definition) a policy may be added to a device to apply its configuration settings conversely, a policy may be removed from a device to revoke its configuration settings published results results associated with the execution of a command on a device these results are published to get events for retrieval in these circumstances, the calling system will receive a command response but the results will only be made available in commandcompletionevent which, along with commandqueuedevent, can be retrieved via get events region a geographic region where a device is being placed this is used to create the most reliable and lowest latency connection to the device possible locations include the following us (united states) eu (europe) ap (asia pacific) usgov (united states to meet u s government compliance requirements) unique an indicator that the value of a property is distinct and there cannot be another instance of the property with the same value user a person using the jetstream api during user account sign up, a user is provided a unique access key and is associated to a jetstream application multiple users may be associated to one jetstream application a user must use their access key to make jetstream api requests and these requests pertain to the user’s jetstream application