Package com.thingworx.things

Class Thing

java.lang.Object
com.thingworx.types.NamedObject
com.thingworx.persistence.common.PersistableNamedObject
com.thingworx.entities.RootEntity
com.thingworx.things.Thing
All Implemented Interfaces:
ISupportsAccessModifier, IConfigurableObject, INotScriptFriendly, ISupportsDeprecation, IDiffableObject, IAlertProvider, IAvatar, IEntityLifeCycleEvent, IEventMetadataProvider, IEventProvider, IPersistable, IPropertyProvider, IServiceMetadataProvider, IServiceProvider, IShapeProvider, ITaggableObject, IDependencyScannableObject, IImportDependencyHandler, IHierarchicalEntity, IEntityDefinition, IPersistableObject<String>, IDesignTimeSecurable, IDesignTimeSecurableEntity, IRunTimeSecurable, IRunTimeSecurableEntity, ISecurable, IVisibilitySecurable, IVisibilitySecurableEntity, IEventProcessor, IAspectContainer, INamedObject, Serializable
Direct Known Subclasses:
DataThing, FileRepositoryThing, LogRetrievalStrategy, NotificationHandler, RemoteThing, ReportingStrategy, SecurityMonitorThing
@ThingworxExtensionApiClass(since={6,6}, canExtendOrImplement=true) public class Thing extends RootEntity implements IServiceProvider, IPropertyProvider, IEventProvider, IEventMetadataProvider, IServiceMetadataProvider, IShapeProvider, IAlertProvider, IEventProcessor, IHierarchicalEntity, ISupportsAccessModifier, IImportDependencyHandler

An entity containing services, properties, events, and subscriptions representing an instance of a thing based on a specified template.

Thing entities are one of the fundamental entity types in Thingworx. They are used to represent an instance of an object that is actionable (services), declarative (properties), reactive (events), and observable (subscriptions). Things must define a single ThingTemplate to inherit shared functionality, as well as any number of ThingShapes that add additional functionality that is independent of the ThingTemplate hierarchy. The consolidation of all inherited functionality must not have any name collisions within the same behavioral type (i.e., a property and service can share the same name, but two services cannot).

All Things have the following lifecycle:

 
ThingState OFF → ON → OFF → N/A
Events Inactive → Preinitializing (Entity) → Validating → Initializing (Entity) → Initializing (Thing) → Starting → Notifying → Active → Stopping → Cleaning Up → Deactivated → Disposing

These lifecycle events correspond to the following methods:

 
State Method Description
Preinitialize (Entity) 1 RootEntity#preInitializeEntity() Occurs only during the entity import process.
Validate1 Thing#validateConfiguration(ImportedEntityCollection) Occurs only during the entity import process. Validates all requirements of the entity.
Initialize (Entity) Thing#initializeEntity(ContextType) Initializes the entity. Should be used to initialize anything needed by thing initialization.
Initialize (Thing) with patch operation Thing#initializeThing(ContextType) Initializes the thing. Should be used to construct the initial state of the thing.
Start Thing#startThing(ContextType) Brings the thing into an active state. Initialization should finish at this step.
Notify Thing#processStartNotification(ContextType) Thing has entered active state and is about to run. Any final processing must occur here.
Stop Thing#stopThing(ContextType) Thing has received a stop request. Any back-end processing should be torn down.
Cleanup Thing#cleanupThing(ContextType) Thing has stopped and needs to clean up its resources. Any managed resources should be cleaned up.
Dispose Thing#dispose() Removes any remaining references of this entity (e.g., networks).
Note 1: The preinitialization and validation states only execute when a Thing is imported. They are skipped when the entity is created from the persistence store.

When developing extensions, you must extend from the Thing class for any classes that are assigned to a com.thingworx.thingpackages.ThingPackage entity. If the package is assigned to a thing in the extension, then the code will execute in the context of that entity. If the package is assigned to a thing template, then the code will execute in the context of the things that have been created with the thing template in its hierarchy.

Thing is not thread-safe nor is it designed to be mutated by multiple threads simultaneously.

See Also:

  • Field Details Link icon

  • Constructor Details Link icon

  • Method Details Link icon

    • getEntityType Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public RelationshipTypes.ThingworxRelationshipTypes getEntityType()
      Description copied from class: RootEntity


      Returns the type of this entity.

      Specified by:
      getEntityType in interface IShapeProvider
      Specified by:
      getEntityType in class RootEntity
      Returns:
      the entity type

    • initializeEntity Link icon

      @ThingworxExtensionApiMethod(since={9,0}, canOverride=true, requiresSuper=true) public void initializeEntity(ContextType contextType) throws Exception
      Description copied from class: RootEntity


      Initializes the internal state of the entity. This method may be called more than once on the same entity during initialization.

      All metadata, including aspects and configuration tables, are available at this point in the lifecycle.

      Overrides:
      initializeEntity in class RootEntity
      Parameters:
      contextType - the patch operation
      Throws:
      Exception - If an error occurs

    • getDependencies Link icon

      @ThingworxExtensionApiMethod(since={6,6}, canOverride=true, requiresSuper=true) public EntityReferenceTypeMap getDependencies()


      Returns a map containing references to all entities that the Thing is dependent on.

      Returns:
      a map of up-stream dependencies

    • isRunning Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean isRunning()


      Returns true when the thing has completed starting up and has not yet been cleaned up.

      Returns:
      true if the thing is active and has not yet been stopped

    • getState Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public ThingState getState()


      Returns the current state of the thing.

      Returns:
      the thing's current state

    • dispose Link icon

      @ThingworxExtensionApiMethod(since={6,6}, canOverride=true, requiresSuper=true) public void dispose() throws Exception
      Description copied from class: RootEntity


      Removes any remaining references of this entity and disposes any resources that were not cleaned up earlier in the lifecycle. This method is only invoked when the entity is in the process of deletion.

      Overrides:
      dispose in class RootEntity
      Throws:
      Exception - If an error occurs

      This method handles cleanup for deletion, only cleanup that should be done during actual deletion should be done here.

    • startThing Link icon

      @ThingworxExtensionApiMethod(since={9,0}, canOverride=true) protected void startThing(ContextType contextType) throws Exception


      A startup hook for subclasses of Thing.

      Throws:
      Exception - if an error occurs during thing startup

    • stopThing Link icon

      @ThingworxExtensionApiMethod(since={9,0}, canOverride=true) protected void stopThing(ContextType contextType) throws Exception


      A shutdown hook for subclasses of Thing.

      Parameters:
      contextType -
      Throws:
      Exception

    • initializeThing Link icon

      @ThingworxExtensionApiMethod(since={9,0}, canOverride=true) protected void initializeThing(ContextType contextType) throws Exception


      An initialization hook for subclasses of Thing. Some resources of Thing may not be available at this point in the lifecycle.

      Throws:
      Exception - if an error occurs during thing initialization

    • cleanupThing Link icon

      @ThingworxExtensionApiMethod(since={9,0}, canOverride=true) protected void cleanupThing(ContextType contextType) throws Exception


      A teardown hook with model synchronization patch operation for subclasses of Thing. This method will be called whenever the thing is deactivated.

      This method is not invoked if the thing has been disabled.

      Parameters:
      contextType - model synchronization patch operation
      Throws:
      Exception - if an error occurs during thing teardown

    • preprocessSetPropertyVTQ Link icon

      @ThingworxExtensionApiMethod(since={6,6}, canOverride=true) protected void preprocessSetPropertyVTQ(ThingProperty property, VTQ newValue, boolean withUpdate) throws Exception


      A property validation hook for subclasses of Thing. This method will execute whenever the value of a property is modified.

      Parameters:
      property - the property being modified
      newValue - the new value being assigned to the property
      withUpdate - has no current function
      Throws:
      Exception - if property validation fails against the new value

    • processStartNotification Link icon

      @ThingworxExtensionApiMethod(since={9,0}, canOverride=true) protected void processStartNotification(ContextType contextType)


      A post-startup hook for subclasses of Thing. This method executes when the thing has fully activated and all resources made available.

      Parameters:
      contextType - the patch operation

    • getInstanceShape Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public ThingShapeInstance getInstanceShape()


      Returns the thing shape describing the current thing. The thing shape instance contains only the resources that belong exclusively to this thing (i.e., not inherited from a thing template or shape).

      The thing shape instance is not fully initialized until the "start" step of the lifecycle.

      Specified by:
      getInstanceShape in interface IShapeProvider
      Returns:
      the thing shape describing the thing itself

    • getThingTemplateName Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public String getThingTemplateName()

    • setThingTemplateName Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void setThingTemplateName(String value)

    • isPublished Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean isPublished()

    • getAllImplementedThingShapes Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public EntityReferenceCollection getAllImplementedThingShapes()


      Returns all thing shapes implemented by this thing. This includes thing shapes applied via inheritance.

      This method may be used at the "initialize thing" step of the lifecycle or later.

      Returns:
      a collection containing references to all implemented thing shapes

    • implementsShape Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean implementsShape(String thingShape)


      Returns true if the specified thing shape is implemented by this thing. This includes thing shapes applied via inheritance.

      This method may be used at the "initialize thing" step of the lifecycle or later.

      Parameters:
      thingShape - the name of the thing shape to test for
      Returns:
      true if the thing implements the specified shape

    • getAllImplementedThingTemplates Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public EntityReferenceCollection getAllImplementedThingTemplates()


      Returns all thing templates inherited by this thing.

      This method may be used at the "initialize thing" step of the lifecycle or later.

      Returns:
      a collection containing references to all inherited thing templates

    • implementsTemplate Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean implementsTemplate(String thingTemplate)


      Returns true if the specified thing template is a member of of the thing's inheritance chain.

      This method may be used at the "initialize thing" step of the lifecycle or later.

      Parameters:
      thingTemplate - the name of the thing template to test for
      Returns:
      true if the thing inherits the specified template

    • getImplementedThingTemplates Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public HashSet<String> getImplementedThingTemplates()


      Returns a set containing the names of all thing templates the thing inherits from.

      Returns:
      a set containing the names of all thing templates this thing inherits from

    • isSubscribed Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean isSubscribed(String eventName)


      Returns true if the specified event has been subscribed to.

      This method may be used at the "notification" step of the lifecycle or later.

      Parameters:
      eventName - the name of the event
      Returns:
      true if any subscriptions exist

    • isLocallySubscribed Link icon

      @Deprecated @ThingworxExtensionApiMethod(since={6,6}, deprecatedSince={7,4}) public boolean isLocallySubscribed(String eventName)
      Deprecated.
      Use isSubscribed(String) instead.


      Returns true if the specified event has been subscribed to within the thing.

      This method may be used at the "notification" step of the lifecycle or later.

      Parameters:
      eventName - the name of the event
      Returns:
      true if any subscriptions exist within this thing

    • isExternallySubscribed Link icon

      @Deprecated @ThingworxExtensionApiMethod(since={6,6}, deprecatedSince={7,4}) public boolean isExternallySubscribed(String eventName)
      Deprecated.
      Use isSubscribed(String) instead.


      Returns true if the specified event has been subscribed to by an external entity.

      This method may be used at the "notification" step of the lifecycle or later.

      Parameters:
      eventName - the name of the event
      Returns:
      true if any subscriptions exist on an external entity

    • getEffectiveIdentifier Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public String getEffectiveIdentifier()

    • getIdentifier Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public String getIdentifier()

    • getValueStreamName Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public String getValueStreamName()


      Returns the name of the value stream assigned to this thing, if any.

      It is recommended to use the method getEffectiveValueStreamName() instead, as it will account for value streams attached to inherited thing templates.

      Returns:
      the name of the assigned value stream, or an empty string if none has been assigned

    • isBuiltInProperty Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public static boolean isBuiltInProperty(String name)

    • isBuiltInEvent Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public static boolean isBuiltInEvent(String name)

    • isPropertyEvent Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean isPropertyEvent(String eventName)


      Returns true if the named event exists and binds to a property.

      Parameters:
      eventName - The name of the event
      Returns:
      true if the event binds to a property

    • hasPropertyDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean hasPropertyDefinition(String name)

    • hasServiceDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean hasServiceDefinition(String name)

    • hasEventDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean hasEventDefinition(String name)

    • hasLocalPropertyDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean hasLocalPropertyDefinition(String name)

    • hasLocalServiceDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean hasLocalServiceDefinition(String name)

    • hasLocalEventDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean hasLocalEventDefinition(String name)

    • getEffectivePropertyDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public PropertyDefinition getEffectivePropertyDefinition(String name)


      Returns the named property definition belonging to the current thing.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Specified by:
      getEffectivePropertyDefinition in interface IAlertProvider
      Parameters:
      name - The name of the property definition.
      Returns:
      the property definition if it exists, otherwise null

    • getInstancePropertyDefinitionIfVisible Link icon

      @ThingworxExtensionApiMethod(since={9,0}) public PropertyDefinition getInstancePropertyDefinitionIfVisible(String name) throws Exception
      Description copied from interface: IPropertyProvider


      Returns the specified property definition for this instance if visible.
      Specified by:
      getInstancePropertyDefinitionIfVisible in interface IPropertyProvider
      Parameters:
      name - The name of the property definition.
      Returns:
      the property definition if it exists, otherwise null
      Throws:
      Exception - If an error occurs

      Returns the named property definition. The property definition may belong to the thing itself or from an inherited template or implemented shape.

      This method may be used at the "thing initialization" step of the lifecycle or later.

    • getInstancePropertyDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public PropertyDefinition getInstancePropertyDefinition(String name)


      Returns the named property definition. The property definition may belong to the thing itself or from an inherited template or implemented shape.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Specified by:
      getInstancePropertyDefinition in interface IPropertyProvider
      Parameters:
      name - The name of the property definition.
      Returns:
      the property definition if it exists, otherwise null

    • getInstancePropertyDefinitions Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public PropertyDefinitionCollection getInstancePropertyDefinitions()


      Returns a collection containing property definitions for all properties that are applicable to this thing.

      Specified by:
      getInstancePropertyDefinitions in interface IPropertyProvider
      Returns:
      a collection of property definitions
      See Also:

    • getInstanceServiceDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public ServiceDefinition getInstanceServiceDefinition(String name)


      Returns the named service definition. The service definition may belong to the thing itself or from an inherited template or implemented shape.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Specified by:
      getInstanceServiceDefinition in interface IServiceProvider
      Parameters:
      name - The name of the service definition.
      Returns:
      the service definition if it exists, otherwise null

    • getEffectiveServiceDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public ServiceDefinition getEffectiveServiceDefinition(String serviceName)


      Returns the named service definition belonging to the current thing.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Specified by:
      getEffectiveServiceDefinition in interface IServiceMetadataProvider
      Parameters:
      serviceName - The name of the service definition.
      Returns:
      the service definition if it exists, otherwise null

    • getEffectiveEventDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public EventDefinition getEffectiveEventDefinition(String name)


      Returns the named event definition belonging to the current thing.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Specified by:
      getEffectiveEventDefinition in interface IEventMetadataProvider
      Parameters:
      name - The name of the event definition.
      Returns:
      the event definition if it exists, otherwise null

    • getInstanceEventDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public EventDefinition getInstanceEventDefinition(String name)


      Returns the named event definition. The event definition may belong to the thing itself or from an inherited template or implemented shape.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Specified by:
      getInstanceEventDefinition in interface IEventProvider
      Parameters:
      name - The name of the property definition.
      Returns:
      the event definition if it exists, otherwise null

    • getInstanceServiceDefinitions Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public ServiceDefinitionCollection getInstanceServiceDefinitions()


      Returns a collection containing service definitions for all services that are applicable to this thing.

      Specified by:
      getInstanceServiceDefinitions in interface IServiceProvider
      Returns:
      a collection of service definitions
      See Also:

    • getInstancePublicServiceDefinitions Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public ServiceDefinitionCollection getInstancePublicServiceDefinitions()


      Returns a collection containing service definitions for all services that are applicable to this thing and are publicly exposed.

      Specified by:
      getInstancePublicServiceDefinitions in interface IServiceProvider
      Returns:
      a collection of public service definitions
      See Also:

    • getInstanceEventDefinitions Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public EventDefinitionCollection getInstanceEventDefinitions()


      Returns a collection containing event definitions for all events that are applicable to this thing.

      Specified by:
      getInstanceEventDefinitions in interface IEventProvider
      Returns:
      a collection of event definitions
      See Also:

    • getInstanceSubscriptions Link icon

      @Deprecated @ThingworxExtensionApiMethod(since={6,6}, deprecatedSince={9,5}) public SubscriptionCollection getInstanceSubscriptions()
      Deprecated.
      Use getInstanceMultiEventSubscriptions() instead.

      Returns a collection containing all subscriptions that are applicable to this thing including it's inherited subscriptions. Supports only single events subscriptions, otherwise RuntimeException will be thrown.

      This method may be used at the "start" step of the lifecycle or later.



      Returns:
      a collection of subscriptions
      See Also:

    • getInstanceMultiEventSubscriptions Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public MultiEventSubscriptionCollection getInstanceMultiEventSubscriptions()


      Returns a collection containing all subscriptions that are applicable to this thing including it's inherited subscriptions.

      Returns:
      a collection of multi events subscriptions
      See Also:

    • isPropertyRemote Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean isPropertyRemote(PropertyDefinition propertyDefinition)


      Returns true if the property definition provided defines a remote property, or if the property is registered as remote according to the current thing.

      This method may be used at the "start" step of the lifecycle or later.

      Parameters:
      propertyDefinition - the definition of the property to test against
      Returns:
      true if the definition provided defines a remote property or if the property is remote according to the current thing

    • isServiceRemote Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean isServiceRemote(ServiceDefinition serviceDefinition)


      Returns true if the service definition provided defines a remote service, or if the service is registered as remote according to the current thing.

      This method may be used at the "start" step of the lifecycle or later.

      Parameters:
      serviceDefinition - the definition of the service to test against
      Returns:
      true if the definition provided defines a remote service or if the service is remote according to the current thing

    • isEventRemote Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean isEventRemote(EventDefinition eventDefinition)


      Returns true if the event definition provided defines a remote event, or if the event is registered as remote according to the current thing.

      This method may be used at the "start" step of the lifecycle or later.

      Parameters:
      eventDefinition - the definition of the event to test against
      Returns:
      true if the definition provided defines a remote event or if the event is remote according to the current thing

    • getEffectiveLocalPropertyBindings Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public LocalPropertyBindingCollection getEffectiveLocalPropertyBindings()

    • getEffectiveRemotePropertyBindings Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public RemotePropertyBindingCollection getEffectiveRemotePropertyBindings()

    • getEffectiveRemoteEventBindings Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public RemoteEventBindingCollection getEffectiveRemoteEventBindings()

    • getEffectiveRemoteServiceBindings Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public RemoteServiceBindingCollection getEffectiveRemoteServiceBindings()

    • getEffectiveValueStreamName Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public String getEffectiveValueStreamName()


      Returns the name of the value stream effectively assigned to this thing, taking into account the thing template hierarchy.

      Returns:
      the name of the value stream associated with this thing

    • validateConfiguration Link icon

      @ThingworxExtensionApiMethod(since={6,6}, canOverride=true, requiresSuper=true) public void validateConfiguration(ImportedEntityCollection importedEntities) throws Exception


      Validates the configuration of the thing during the import process. This method is called whenever a thing is created or modified via the REST APIs. During the validation step, there may be other associated entities (including thing shapes and templates) that are being imported. These can be accessed via the importedEntities collection if needed.

      Note that some resources belonging to the thing or other associated entities may not be available during this step in the lifecycle.

      It is required for all subclasses of Thing to call super.validateConfiguration(importedEntities) if they override this method.

      Overrides:
      validateConfiguration in class RootEntity
      Parameters:
      importedEntities - - a typed collection of entities currently being imported
      Throws:
      Exception - if the thing is invalid

    • getThingTemplate Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public ThingTemplate getThingTemplate()


      Returns the base thing template assigned to this thing.

      Returns:
      the base thing template

    • isEnabled Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean isEnabled()


      Returns true if the current thing is enabled. An enabled thing can be started and federated.

      Returns:
      true if the current thing is enabled

    • getProperties Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public ThingPropertyCollection getProperties()


      Performs runtime access by modifier check on each property definition.

      Returns a collection containing the property instances belonging to this thing and accessible to caller .

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Returns:
      a collection of property instances
      See Also:

    • addProperty Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public ThingProperty addProperty(PropertyDefinition propertyDefinition) throws Exception


      Adds the provided property definition to this thing. An instance of the property will automatically be generated and assigned the default value.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Parameters:
      propertyDefinition - the property definition to apply to this thing
      Returns:
      the generated property instance
      Throws:
      Exception - if an error occurs

    • isLocalProperty Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean isLocalProperty(String property)


      Returns true if the specified property is defined by this thing.

      Parameters:
      property - the name of the property
      Returns:
      true if the named property is a local member of this thing

    • getProperty Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public ThingProperty getProperty(String propertyName) throws Exception


      Returns the named property instance. This method performs two runtime checks:

      • A run-time authorization check against the current security context.
      • Access by modifier check on the property against the caller context.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Parameters:
      propertyName - the name of the property to retrieve
      Returns:
      the associated property instance
      Throws:
      Exception - if an error occurs or authorization/runtime access is denied

    • getPropertyValue Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public IPrimitiveType getPropertyValue(String propertyName) throws Exception


      Returns the current value assigned to the named property. This method performs a run-time authorization check against the current security context.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Specified by:
      getPropertyValue in interface IPropertyProvider
      Parameters:
      propertyName - the name of the property
      Returns:
      the value of the property
      Throws:
      Exception - if an error occurs or authorization is denied

    • getPropertyValue Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public IPrimitiveType getPropertyValue(ThingProperty property) throws Exception


      Returns the current value assigned to the provided property instance. This method performs a run-time authorization check against the current security context.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Parameters:
      property - the property
      Returns:
      the value of the property
      Throws:
      Exception - if an error occurs or authorization is denied

    • getPropertyTime Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public org.joda.time.DateTime getPropertyTime(String propertyName)


      Returns the modified time assigned to the named property. This method performs a run-time authorization check against the current security context.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Parameters:
      propertyName - the name of the property
      Returns:
      the time the property was last modified, or the epoch if an error occurred

    • getPropertyQuality Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public QualityStatus getPropertyQuality(String propertyName)


      Returns the current quality status assigned to the provided property instance. This method performs a run-time authorization check against the current security context.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Parameters:
      propertyName - the name of the property
      Returns:
      the current quality status of the property, or QualityStatus#UNKNOWN if an error occurred

    • hasProperty Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean hasProperty(String propertyName)
      Description copied from interface: IPropertyProvider


      Returns true if there exists a property with the specified name. Property names are case-sensitive.
      Specified by:
      hasProperty in interface IPropertyProvider
      Parameters:
      propertyName - the property name to check
      Returns:
      true if the specified property exists

    • hasPropertyAndIsVisible Link icon

      @ThingworxExtensionApiMethod(since={9,0}) public boolean hasPropertyAndIsVisible(String propertyName) throws Exception
      Description copied from interface: IPropertyProvider


      Returns true if there exists a property with the specified name and is visible to the user. Property names are case-sensitive.
      Specified by:
      hasPropertyAndIsVisible in interface IPropertyProvider
      Parameters:
      propertyName - the property name to check
      Returns:
      true if the specified property exists and is visible
      Throws:
      Exception - If an error occurs

    • getPropertyType Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public BaseTypes getPropertyType(String propertyName)
      Description copied from interface: IPropertyProvider


      Returns the base type defined in the specified property's definition.
      Specified by:
      getPropertyType in interface IPropertyProvider
      Parameters:
      propertyName - the name of the property
      Returns:
      the BaseTypes entry corresponding to the property type

    • checkDemandRead Link icon

      @ThingworxExtensionApiMethod(since={6,6}, canOverride=true) public void checkDemandRead(ThingProperty property) throws Exception


      A property read hook for subclasses of Thing. This method may be used to update the property on read if it uses a backing cache or otherwise transform the property prior to read.

      Parameters:
      property - the property that is being read
      Throws:
      Exception - if the property cannot be read, or if an issue occurs

    • initializeProperty Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void initializeProperty(String propertyName, IPrimitiveType value) throws Exception


      Initializes the named property to the specified value. This method is intended for use by subclasses of Thing during the "thing initialization" step of the lifecycle to assign an initial value to a property managed by the subclass.

      Parameters:
      propertyName - the name of the property
      value - the value to assign to the property
      Throws:
      Exception - If an error occurs

    • setPropertyValue Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void setPropertyValue(String propertyName, IPrimitiveType newValue) throws Exception
      Specified by:
      setPropertyValue in interface IPropertyProvider
      Parameters:
      propertyName - the name of the property that is being modified
      newValue - the value to assign to the property
      Throws:
      Exception - If an error occurs

      Assigns the provided value to the specified property.

      This method may be used at the "start" step of the lifecycle or later.

      Exception - if either of the parameters are null, the user is unauthorized, or an error occurs when attempting to modify the property

    • setPropertyVTQ Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public QueuedEvent setPropertyVTQ(String propertyName, VTQ newValue, boolean withUpdate) throws Exception
      Throws:
      Exception - If an error occurs

    • setPropertyVTQ Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public QueuedEvent setPropertyVTQ(String propertyName, VTQ newValue, boolean deferNotifications, boolean bypassReadOnly, boolean bypassHooksAndBindings) throws Exception
      Throws:
      Exception - If an error occurs

    • getPropertyValues Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public ValueCollection getPropertyValues() throws Exception


      Returns a collection of mappings of property names and the current values of the properties. This method performs two checks:

      • A runtime authorization check on each property to be read to ensure the current security context is authorized.
      • A runtime access modifier check on each propoerty to make sure that the caller context has access to the property.
      Any properties that the current security context does not have access to will not be a member of the returned collection. Similarly, properties that the caller context does not have access to will not be member of the retunred collection.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Returns:
      a map of property names and their current values
      Throws:
      Exception - if an error occurred while reading a property, excepting an authorization failure

    • getPropertyValuesAsInfoTable Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable getPropertyValuesAsInfoTable() throws Exception
      Description copied from interface: IPropertyProvider


      Returns an InfoTable containing a list of the properties belonging to this instance and their values.
      Specified by:
      getPropertyValuesAsInfoTable in interface IPropertyProvider
      Returns:
      an InfoTable of property names and their associated values
      Throws:
      Exception - If an error occurs

    • getAlertConfigurations Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public AlertConfigurationCollection getAlertConfigurations()


      Returns a collection of alert configurations belonging to the local properties of this thing.

      Specified by:
      getAlertConfigurations in interface IAlertProvider
      Returns:
      a collection of alert configurations

    • getEffectiveAlertConfiguration Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public AlertConfigurationCollection getEffectiveAlertConfiguration()


      Returns a collection of alert configurations associated to any of the properties applicable to this thing.

      This method may be used at the "thing initialization" step of the lifecycle or later.

      Specified by:
      getEffectiveAlertConfiguration in interface IAlertProvider
      Returns:
      a collection of alert configurations

    • acknowledgeAlertByPropertyAndName Link icon

      @ThingworxExtensionApiMethod(since={7,3}) public void acknowledgeAlertByPropertyAndName(String propertyName, String alertName, String message) throws Exception
      Throws:
      Exception - If an error occurs

    • acknowledgeAlertByProperty Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void acknowledgeAlertByProperty(String propertyName, String message) throws Exception
      Throws:
      Exception - If an error occurs

    • acknowledgeAllAlerts Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void acknowledgeAllAlerts(String message)

    • getAlertsForProperty Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public AlertList getAlertsForProperty(String propertyName)


      Returns Effective Alerts including local and inherited from ancestors.
      Parameters:
      propertyName - name of the property on which the alert's defined
      Returns:
      a list of alerts defined on the given property

    • getAlerts Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public AlertCollection getAlerts()


      Returns a list of effective alerts on the properties associated with this thing.

      This method may be used at the "start" step of the lifecycle or later.

      Returns:
      a collection of alerts

    • getPropertyAlertStatus Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean getPropertyAlertStatus(String property)

    • getPropertyAckStatus Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean getPropertyAckStatus(String property)

    • GetValueStream Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public String GetValueStream()
      Service Category:
      DataLogging
      Service Description:
      Get the identifier for a thing.
      Returns:
      name Value Stream Name - THINGNAME

    • SetValueStream Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetValueStream(String name) throws Exception
      Service Category:
      DataLogging
      Service Description:
      Set the value stream for a thing.
      Parameters:
      name - Value stream name - THINGNAME
      Throws:
      Exception - If an error occurs

    • DisableThing Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void DisableThing() throws Exception
      Service Category:
      Lifecycle
      Service Description:
      Disable this thing.
      Throws:
      Exception - If an error occurs

    • EnableThing Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void EnableThing() throws Exception
      Service Category:
      Lifecycle
      Service Description:
      Enable this thing.
      Throws:
      Exception - If an error occurs

    • IsEnabled Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public boolean IsEnabled() throws Exception
      Service Category:
      Lifecycle
      Service Description:
      Get Enabled Status.
      Returns:
      enabled Enabled status - BOOLEAN
      Throws:
      Exception - If an error occurs

    • RestartThing Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void RestartThing() throws Exception
      Service Category:
      Lifecycle
      Service Description:
      Restart this thing.
      Throws:
      Exception - If an error occurs

    • GetIdentifier Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public String GetIdentifier()
      Service Category:
      Identifier
      Service Description:
      Get the identifier for a thing.
      Returns:
      identifier Identifier - STRING

    • SetIdentifier Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetIdentifier(String identifier) throws Exception
      Service Category:
      Identifier
      Service Description:
      Set the identifier for a thing.
      Parameters:
      identifier - Thing identifier for remote things - STRING
      Throws:
      Exception - If an error occurs

    • GetLocalPropertyBinding Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetLocalPropertyBinding(String propertyName) throws Exception
      Service Category:
      Bindings
      Service Description:
      Get the property binding for a property.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property binding - INFOTABLE - Aspects {dataShape:LocalPropertyBinding}
      Throws:
      Exception - If an error occurs

    • GetEffectiveLocalPropertyBinding Link icon

      @ThingworxExtensionApiMethod(since={7,3}) public InfoTable GetEffectiveLocalPropertyBinding(String propertyName) throws Exception
      Service Category:
      Bindings
      Service Description:
      Get the effective local property binding for a property.


      Get the effective (inherited and local) property binding for a property
      Parameters:
      propertyName - : name of property to get the local binding
      Returns:
      InfoTable of local property bindings consists of property name, name of thing(sourceThingName) and name of property(sourceName) the property is locally bound to.
      Throws:
      Exception

    • GetEffectiveLocalPropertyBindings Link icon

      @ThingworxExtensionApiMethod(since={7,3}) public InfoTable GetEffectiveLocalPropertyBindings() throws Exception
      Service Category:
      Bindings
      Service Description:
      Get the effective local property bindings.


      Get all effective (inherited and local) property bindings for this thing
      Returns:
      InfoTable of local property bindings consists of property name, name of thing(sourceThingName) and name of property(sourceName) the property is locally bound to.
      Throws:
      Exception

    • GetIncomingLocalPropertyBindings Link icon

      @ThingworxExtensionApiMethod(since={8,0}) public InfoTable GetIncomingLocalPropertyBindings() throws Exception
      Service Category:
      Bindings
      Service Description:
      Get all things and their properties that have local bindings on this thing.


      Get all things and their properties that have local bindings on this thing
      Returns:
      Infotable of propertyName, bound thing's property name, bound thing's name
      Throws:
      Exception

    • GetIncomingLocalPropertyBinding Link icon

      @ThingworxExtensionApiMethod(since={8,0}) public InfoTable GetIncomingLocalPropertyBinding(String propertyName) throws Exception
      Service Category:
      Bindings
      Service Description:
      Get incoming local bindings to this thing for the given property.


      Get incoming local bindings to this thing for the given property
      Parameters:
      propertyName - : name of property for which incoming bindings are to be fetched
      Returns:
      Infotable of propertyName, bound thing's property name, bound thing's name
      Throws:
      Exception

    • RemoveLocalPropertyBinding Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void RemoveLocalPropertyBinding(String propertyName) throws Exception
      Service Category:
      Bindings
      Service Description:
      Remove the local property binding for a property.
      Parameters:
      propertyName - Property name - STRING
      Throws:
      Exception - If an error occurs

    • SetLocalPropertyBinding Link icon

      @ThingworxExtensionApiMethod(since={6,6}, deprecatedSince={8,1,0}) @Deprecated public void SetLocalPropertyBinding(String propertyName, String sourceThingName, String sourcePropertyName) throws Exception
      Deprecated.
      As of release 8.1.0, replaced by SetLocalPropertyBinding(String, String, String, JSONObject)
      Throws:
      Exception - If an error occurs

    • SetLocalPropertyBinding Link icon

      @ThingworxExtensionApiMethod(since={8,1,0}) public void SetLocalPropertyBinding(String propertyName, String sourceThingName, String sourcePropertyName, org.json.JSONObject aspects) throws Exception
      Service Category:
      Bindings
      Service Description:
      Set the property binding for a property.
      Parameters:
      propertyName - Property name - STRING
      sourceThingName - Thing name to bind to - STRING
      sourcePropertyName - Source property name - STRING
      aspects - Aspects for the local binding - JSON
      Throws:
      Exception - If an error occurs

    • GetRemotePropertyBinding Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetRemotePropertyBinding(String propertyName) throws Exception
      Service Category:
      Bindings
      Service Description:
      Get the remote property binding for a property.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property binding - INFOTABLE - Aspects {dataShape:RemotePropertyBinding}
      Throws:
      Exception - If an error occurs

    • RemoveRemotePropertyBinding Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void RemoveRemotePropertyBinding(String propertyName) throws Exception
      Service Category:
      Bindings
      Service Description:
      Remove the remote property binding for a property.
      Parameters:
      propertyName - Property name - STRING
      Throws:
      Exception - If an error occurs

    • SetRemotePropertyBinding Link icon

      @ThingworxExtensionApiMethod(since={6,6}, deprecatedSince={8,0,0}) @Deprecated public void SetRemotePropertyBinding(String propertyName, String sourcePropertyName, Integer timeout, String pushType, Double pushThreshold) throws Exception
      Deprecated.
      As of release 8.0.0, replaced by SetRemotePropertyBinding(String, String, Integer, String, Double, JSONObject, Integer, String)
      Throws:
      Exception - If an error occurs

    • SetRemotePropertyBinding Link icon

      @ThingworxExtensionApiMethod(since={8,0}) public void SetRemotePropertyBinding(String propertyName, String sourcePropertyName, Integer timeout, String pushType, Double pushThreshold, org.json.JSONObject aspects, Integer cacheTime, String foldType) throws Exception
      Service Category:
      Bindings
      Service Description:
      Set the remote property binding for a property.
      Parameters:
      propertyName - Property name - STRING
      sourcePropertyName - Source property name - STRING
      timeout - Request timeout - INTEGER
      pushType - Push type - STRING
      pushThreshold - Push threshold - NUMBER
      aspects - Aspects for the remote binding - JSON
      cacheTime - Property's cache time value at the server in milliseconds - INTEGER
      foldType - How a remote property's value should be handled by the server when a connection is lost - STRING
      Throws:
      Exception - If an error occurs

    • GetRemoteServiceBinding Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetRemoteServiceBinding(String serviceName) throws Exception
      Service Category:
      Bindings
      Service Description:
      Get the remote service binding for a service.
      Parameters:
      serviceName - Service name - STRING
      Returns:
      result Service binding - INFOTABLE - Aspects {dataShape:RemoteServiceBinding}
      Throws:
      Exception - If an error occurs

    • RemoveRemoteServiceBinding Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void RemoveRemoteServiceBinding(String serviceName) throws Exception
      Service Category:
      Bindings
      Service Description:
      Remove the remote service binding for a service.
      Parameters:
      serviceName - Service name - STRING
      Throws:
      Exception - If an error occurs

    • SetRemoteServiceBinding Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetRemoteServiceBinding(String serviceName, String sourceServiceName, Integer timeout) throws Exception
      Service Category:
      Bindings
      Service Description:
      Set the remote service binding for a service.
      Parameters:
      serviceName - Service name - STRING
      sourceServiceName - Source service name - STRING
      timeout - Request timeout - INTEGER
      Throws:
      Exception - If an error occurs

    • GetRemoteEventBinding Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetRemoteEventBinding(String eventName) throws Exception
      Service Category:
      Bindings
      Service Description:
      Get the remote event binding for a event.
      Parameters:
      eventName - Event name - STRING
      Returns:
      result Event binding - INFOTABLE - Aspects {dataShape:RemoteEventBinding}
      Throws:
      Exception - If an error occurs

    • RemoveRemoteEventBinding Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void RemoveRemoteEventBinding(String eventName) throws Exception
      Service Category:
      Bindings
      Service Description:
      Remove the remote event binding for a event.
      Parameters:
      eventName - Event name - STRING
      Throws:
      Exception - If an error occurs

    • SetRemoteEventBinding Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetRemoteEventBinding(String eventName, String sourceEventName) throws Exception
      Service Category:
      Bindings
      Service Description:
      Set the remote event binding for a event.
      Parameters:
      eventName - Event name - STRING
      sourceEventName - Source event name - STRING
      Throws:
      Exception - If an error occurs

    • UpdatePropertyValuesBatched Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void UpdatePropertyValuesBatched(InfoTable batches) throws Exception
      Service Category:
      Properties
      Service Description:
      Write property values for a thing, processing change events in batches by timestamp.
      Parameters:
      batches - Collection of batches containing properties to be updated - INFOTABLE
      Throws:
      Exception - If an error occurs

    • UpdatePropertyValues Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void UpdatePropertyValues(InfoTable values) throws Exception
      Service Category:
      Properties
      Service Description:
      Write property values for a thing.
      Parameters:
      values - Collection of properties to be updated - INFOTABLE
      Throws:
      Exception - If an error occurs

    • GetPropertyQuality Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public String GetPropertyQuality(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the quality for a specific property.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      Quality Quality value - STRING
      Throws:
      Exception - If an error occurs

    • GetPropertyTime Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public org.joda.time.DateTime GetPropertyTime(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the timestamp for a specific property.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      Time Time value - DATETIME
      Throws:
      Exception - If an error occurs

    • GetLoggedProperties Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetLoggedProperties(String type) throws Exception
      Service Category:
      Metadata
      Service Description:
      Get a list of logged properties for this thing.
      Parameters:
      type - Type to filter on - BASETYPENAME
      Returns:
      result Property names - INFOTABLE - Aspects {dataShape:PropertyDefinition}
      Throws:
      Exception - If an error occurs

    • GetNumericLoggedProperties Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetNumericLoggedProperties() throws Exception
      Service Category:
      Metadata
      Service Description:
      Get a list of logged properties for this thing that are of a numeric data type.
      Returns:
      result Property names - INFOTABLE - Aspects {dataShape:PropertyDefinition}
      Throws:
      Exception - If an error occurs

    • GetNumberPropertyValue Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Double GetNumberPropertyValue(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property value.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property value - NUMBER
      Throws:
      Exception - If an error occurs

    • GetIntegerPropertyValue Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Integer GetIntegerPropertyValue(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property value.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property value - INTEGER
      Throws:
      Exception - If an error occurs

    • GetLongPropertyValue Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Long GetLongPropertyValue(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property value.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property value - LONG
      Throws:
      Exception - If an error occurs

    • GetBooleanPropertyValue Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Boolean GetBooleanPropertyValue(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property value.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property value - BOOLEAN
      Throws:
      Exception - If an error occurs

    • GetLocationPropertyValue Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Location GetLocationPropertyValue(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property value.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property value - LOCATION
      Throws:
      Exception - If an error occurs

    • GetDateTimePropertyValue Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public org.joda.time.DateTime GetDateTimePropertyValue(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property value.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property value - DATETIME
      Throws:
      Exception - If an error occurs

    • GetStringPropertyValue Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public String GetStringPropertyValue(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property value.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property value - STRING
      Throws:
      Exception - If an error occurs

    • GetVec2PropertyValue Link icon

      @ThingworxExtensionApiMethod(since={7,1}) public Vec2 GetVec2PropertyValue(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property value.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property value - VEC2
      Throws:
      Exception - If an error occurs

    • GetVec3PropertyValue Link icon

      @ThingworxExtensionApiMethod(since={7,1}) public Vec3 GetVec3PropertyValue(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property value.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property value - VEC3
      Throws:
      Exception - If an error occurs

    • GetVec4PropertyValue Link icon

      @ThingworxExtensionApiMethod(since={7,1}) public Vec4 GetVec4PropertyValue(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property value.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property value - VEC4
      Throws:
      Exception - If an error occurs

    • GetThingCodePropertyValue Link icon

      @ThingworxExtensionApiMethod(since={7,1}) public ThingCode GetThingCodePropertyValue(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property value.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property value - THINGCODE
      Throws:
      Exception - If an error occurs

    • GetImagePropertyValue Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public byte[] GetImagePropertyValue(String propertyName) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property value.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      result Property value - IMAGE
      Throws:
      Exception - If an error occurs

    • GetPropertyValues Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetPropertyValues() throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property values for this thing.
      Returns:
      result Property values - INFOTABLE
      Throws:
      Exception - If an error occurs

    • GetPropertyValuesAsMultiRowTable Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetPropertyValuesAsMultiRowTable() throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property values for this thing.
      Returns:
      result Property values - INFOTABLE
      Throws:
      Exception - If an error occurs

    • SetPropertyValues Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetPropertyValues(InfoTable values) throws Exception
      Service Category:
      Properties
      Service Description:
      Get a subset of the current property values for this thing.
      Parameters:
      values - Property values - INFOTABLE
      Throws:
      Exception - If an error occurs

    • GetNamedPropertyValues Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetNamedPropertyValues(InfoTable propertyNames) throws Exception
      Service Category:
      Properties
      Service Description:
      Gets the current values of the specified properties.


      Gets the current values of the specified properties.

      To create the required InfoTable for the propertyNames parameter, the InfoTableFunctions.CreateInfoTableFromDataShape(String, String) method can be used, specifying any arbitrary value for the InfoTable's name, and "EntityList" for the DataShape's name. This DataShape defines a "name" field for the InfoTable (all other fields defined on this DataShape can be ignored for this particular Service call). Once the InfoTable is created, populate the "name field with the names of the properties whose current values are to be returned, where each property name is added as a new row.

      The returned InfoTable, defined by a dynamically built DataShape based upon the property names specified in propertyNames, contains only one row, where the name of each field is a property name and the value of each field is that property's current value.

      NOTE: If propertyNames is empty, then an empty InfoTable will be returned (i.e. 0 rows).

      Parameters:
      propertyNames - an InfoTable, described by the "EntityList" DataShape, identifying the properties whose current values are to be returned
      Returns:
      a non-null InfoTable containing one row, where each field name corresponds to a property name specified in propertyNames, and each field value is the current value of that corresponding property
      Throws:
      Exception - if propertyNames does not contain a "name" field, or if it contains a property name that does not identify a property defined on this Thing

    • GetNamedProperties Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetNamedProperties(org.json.JSONObject propertyNames) throws Exception
      Service Category:
      Properties
      Service Description:
      Gets the current values of the specified properties.


      Gets the current values of the specified properties.

      The format of the propertyNames parameter must be: 

          {
      "items" : [
          "<property-name-1>",
          "<property-name-2>",
          "..."
      ]
    }

      The returned InfoTable, defined by a dynamically built DataShape based upon the property names specified in propertyNames, contains only one row, where the name of each field is a property name and the value of each field is that property's current value.

      NOTE: If propertyNames is empty, then an empty InfoTable will be returned (i.e. 0 rows).

      Parameters:
      propertyNames - an InfoTable, described by the "EntityList" DataShape, identifying the properties whose current values are to be returned
      Returns:
      a non-null InfoTable containing one row, where each field name corresponds to a property name specified in propertyNames, and each field value is the current value of that corresponding property
      Throws:
      Exception - if propertyNames does not adhere to the required format, or if the JSON array contains a property name that does not identify a property defined on this Thing

    • GetPropertyValuesVTQ Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetPropertyValuesVTQ() throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property values for this thing as VTQ.
      Returns:
      result Property values - INFOTABLE
      Throws:
      Exception - If an error occurs

    • GetNamedPropertyValuesVTQ Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetNamedPropertyValuesVTQ(InfoTable propertyNames) throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property values for this thing as VTQ.
      Parameters:
      propertyNames - Property names - INFOTABLE
      Returns:
      result Property values - INFOTABLE - Aspects {isMultiRow: false}
      Throws:
      Exception - If an error occurs

    • GetPropertyValuesVTQA Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetPropertyValuesVTQA() throws Exception
      Service Category:
      Properties
      Service Description:
      Get the current property values (VTQ) and the highest alert for this thing.
      Returns:
      result Property values VTQA - INFOTABLE - Aspects {isMultiRow: false}
      Throws:
      Exception - If an error occurs

    • GetNamedPropertyValuesVTQA Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetNamedPropertyValuesVTQA(InfoTable propertyNames) throws Exception
      Service Category:
      Properties
      Service Description:
      Get a subset of the current property values (VTQ) and the highest alert for this thing.
      Parameters:
      propertyNames - Property names - INFOTABLE
      Returns:
      result Property values VTQA - INFOTABLE - Aspects {isMultiRow: false}
      Throws:
      Exception - If an error occurs

    • QueryAlertSummary Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryAlertSummary(org.json.JSONObject query, Boolean onlyAcknowledged, Boolean onlyUnacknowledged, Double maxItems) throws Exception
      Service Category:
      Alerts
      Service Description:
      Query the alert summary.
      Parameters:
      query - Query definition - QUERY
      onlyAcknowledged - Show only acknowledged alerts - BOOLEAN
      onlyUnacknowledged - Show only unacknowledged alerts - BOOLEAN
      maxItems - Maximum number of items to return - NUMBER
      Returns:
      result Alert Summary - INFOTABLE - Aspects {dataShape:AlertSummary}
      Throws:
      Exception - If an error occurs

    • QueryAlertHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryAlertHistory(org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query, Double maxItems) throws Exception
      Service Category:
      Alerts
      Service Description:
      Query the alert history.
      Parameters:
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      maxItems - Maximum number of items to return - NUMBER
      Returns:
      result Alert History - INFOTABLE - Aspects {dataShape:AlertHistory, isStreamEntry:true}
      Throws:
      Exception - If an error occurs

    • AcknowledgeAllAlerts Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AcknowledgeAllAlerts(String message) throws Exception
      Service Category:
      Alerts
      Service Description:
      Acknowledge all active alerts.
      Parameters:
      message - Message (optional) - STRING
      Throws:
      Exception - If an error occurs

    • AcknowledgeAlert Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AcknowledgeAlert(String property, String message) throws Exception
      Service Category:
      Alerts
      Service Description:
      Acknowledge an active alert.
      Parameters:
      property - Property name - STRING
      message - Message (optional) - STRING
      Throws:
      Exception - If an error occurs

      Additional Information

      This service takes the name of the property and the message and throws an alert acknowledge event.

      Acknowledges each alert on the property whether or not it's in an alert state.

    • GetAlertSummary Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetAlertSummary(Boolean onlyAcknowledged, Boolean onlyUnacknowledged, Double maxItems) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get alert summary status.
      Parameters:
      onlyAcknowledged - Show only acknowledged alerts - BOOLEAN
      onlyUnacknowledged - Show only unacknowledged alerts - BOOLEAN
      maxItems - Maximum number of items to return - NUMBER
      Returns:
      Status Alert status - INFOTABLE - Aspects {dataShape:AlertSummary}
      Throws:
      Exception - If an error occurs

    • GetAlertSummaryForProperty Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetAlertSummaryForProperty(String property, Boolean onlyAcknowledged, Boolean onlyUnacknowledged, Double maxItems) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get alert summary for a property.
      Parameters:
      property - Property name - STRING
      onlyAcknowledged - Show only acknowledged alerts - BOOLEAN
      onlyUnacknowledged - Show only unacknowledged alerts - BOOLEAN
      maxItems - Maximum number of items to return - NUMBER
      Returns:
      AlertSummary Alert summary - INFOTABLE - Aspects {dataShape:PropertyAlertSummary}
      Throws:
      Exception - If an error occurs

    • DisableAllAlerts Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void DisableAllAlerts(Boolean persistent) throws Exception
      Service Category:
      Alerts
      Service Description:
      Disable all alerts for a thing.
      Parameters:
      persistent - Persist this change - BOOLEAN
      Throws:
      Exception - If an error occurs

    • EnableAllAlerts Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void EnableAllAlerts(Boolean persistent) throws Exception
      Service Category:
      Alerts
      Service Description:
      Enable all alerts for a thing.
      Parameters:
      persistent - Persist this change - BOOLEAN
      Throws:
      Exception - If an error occurs

    • DisableAlertsForProperty Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void DisableAlertsForProperty(String property, String alertName, Boolean persistent) throws Exception
      Service Category:
      Alerts
      Service Description:
      Disable alert(s) for a property. Specify alertName for a specific property alert; otherwise, all alerts are disabled.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      persistent - Persist this change - BOOLEAN
      Throws:
      Exception - If an error occurs

    • EnableAlertsForProperty Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void EnableAlertsForProperty(String property, String alertName, Boolean persistent) throws Exception
      Service Category:
      Alerts
      Service Description:
      Enable alert(s) for a property. Specify alertName for a specific property alert; otherwise, all alerts are enabled.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      persistent - Persist this change - BOOLEAN
      Throws:
      Exception - If an error occurs

    • getEffectiveAlertDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public AlertDefinition getEffectiveAlertDefinition(String property, String alertName)

    • GetPropertyLogging Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Boolean GetPropertyLogging(String propertyName) throws Exception
      Service Category:
      DataLogging
      Service Description:
      Get property logging status for a specific property.
      Parameters:
      propertyName - Property name - STRING
      Returns:
      status Property logging status - BOOLEAN
      Throws:
      Exception - If an error occurs

    • SetPropertyLogging Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetPropertyLogging(String propertyName, Boolean enabled) throws Exception
      Service Category:
      DataLogging
      Service Description:
      Set property logging status for a specific property.
      Parameters:
      propertyName - Property name - STRING
      enabled - Enable/disable logging - BOOLEAN
      Throws:
      Exception - If an error occurs

    • SetUnitsForNumericPropertyDefinition Link icon

      @ThingworxExtensionApiMethod(since={8,5}) public void SetUnitsForNumericPropertyDefinition(String propertyName, String units) throws Exception
      Service Category:
      Metadata
      Service Description:
      Set the additional information for units for a specific Long, Integer, or Number property.
      Parameters:
      propertyName - Property name - STRING
      units - Units (eg. lbs, F, inches, etc.) associated with input. For information only. - STRING
      Throws:
      Exception - If an error occurs

    • GetEffectivePropertyLogging Link icon

      @ThingworxExtensionApiMethod(since={7,2,2}) public Boolean GetEffectivePropertyLogging(String propertyName) throws InvalidRequestException
      Service Category:
      DataLogging
      Service Description:
      Get the logging status of a specific property from the effective Thing shape.
      Parameters:
      propertyName - Property name to look up on the effective shape for its logging status - STRING
      Returns:
      status Effective property logging status - BOOLEAN
      Throws:
      InvalidRequestException - If an error occurs

    • AddPropertyDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}, deprecatedSince={8,0}) @Deprecated public void AddPropertyDefinition(String name, String description, String type, String category, String dataShape, Boolean readOnly, Boolean persistent, Boolean logged, String dataChangeType, Double dataChangeThreshold, Boolean remote, String remotePropertyName, Integer timeout, String pushType, Double pushThreshold, String defaultValue) throws Exception
      Deprecated.
      As of release 8.0, replaced by AddPropertyDefinition(String, String, String, String, String, Boolean, Boolean, Boolean, String, Double, Boolean, String, Integer, String, Double, String, JSONObject)
      Throws:
      Exception - If an error occurs

    • AddPropertyDefinition Link icon

      @ThingworxExtensionApiMethod(since={8,0}, deprecatedSince={9,3}) @Deprecated public void AddPropertyDefinition(String name, String description, String type, String category, String dataShape, Boolean readOnly, Boolean persistent, Boolean logged, String dataChangeType, Double dataChangeThreshold, Boolean remote, String remotePropertyName, Integer timeout, String pushType, Double pushThreshold, String defaultValue, org.json.JSONObject remoteBindingAspects) throws Exception
      Deprecated.
      Throws:
      Exception - If an error occurs

    • AddPropertyDefinition Link icon

      @ThingworxExtensionApiMethod(since={8,0}, deprecatedSince={9,4}) @Deprecated public void AddPropertyDefinition(String name, String description, String type, String category, String dataShape, Boolean readOnly, Boolean persistent, Boolean logged, Boolean indexed, String dataChangeType, Double dataChangeThreshold, Boolean remote, String remotePropertyName, Integer timeout, String pushType, Double pushThreshold, String defaultValue, org.json.JSONObject remoteBindingAspects) throws Exception
      Deprecated.
      Throws:
      Exception - If an error occurs

    • AddPropertyDefinition Link icon

      @ThingworxExtensionApiMethod(since={9,3}) public void AddPropertyDefinition(String name, String description, String type, String category, String dataShape, Boolean readOnly, Boolean persistent, Boolean logged, Boolean indexed, String dataChangeType, Double dataChangeThreshold, Boolean remote, String remotePropertyName, Integer timeout, String pushType, Double pushThreshold, String defaultValue, org.json.JSONObject remoteBindingAspects, org.json.JSONObject accessModifier) throws Exception
      Service Category:
      Metadata
      Service Description:
      Add a property definition.
      Parameters:
      name - Property name - STRING
      description - Property description - STRING
      type - Data type - BASETYPENAME
      category - Category - STRING
      dataShape - Data shape - DATASHAPENAME
      readOnly - Read only - BOOLEAN
      persistent - Persist property value - BOOLEAN
      logged - Log property value - BOOLEAN
      indexed - Index property value - BOOLEAN
      dataChangeType - Data change type - STRING
      dataChangeThreshold - Data change threshold - NUMBER
      remote - Is a remote property - BOOLEAN
      remotePropertyName - Remote property name - STRING
      timeout - Request timeout - INTEGER
      pushType - Push type - STRING
      pushThreshold - Push threshold - NUMBER
      defaultValue - Default value for property - STRING
      remoteBindingAspects - Aspects for the remote binding - JSON
      accessModifier - AccessModifier for propertyDefinition - JSON
      Throws:
      Exception - If an error occurs

    • AddPropertyTransformDefinition Link icon

      @ThingworxExtensionApiMethod(since={8,4}) public void AddPropertyTransformDefinition(String name, String description, String category, Boolean persistent, Boolean logged, Integer timeout, InfoTable propertyTransformConfig) throws Exception
      Service Category:
      Metadata
      Service Description:
      Add a property transform definition.
      Parameters:
      name - - The name of your new derived property.
      description - - The description of the new property.
      category - - Category for the new property.
      persistent - - Should the value of this derived property be persisted between tomcat restarts?
      logged - - Should the value of this derived property be logged over time?
      timeout - - Timeout for creating the property.
      propertyTransformConfig - - A configuration infotable consisting of key/value pairs. Refer to the help center for possible keys.
      Throws:
      Exception - If an error occurs

      Creates a derived property on this Thing. A derived property receives data from a specified source property, and performs some requested calculation on the stream of data as the source property changes. The type of calculation will determine which configuration keys/values need to be set on the derivedPropertyConfig.

      Note: In order to use the derived property functionality, you must have a RabbitMQ instance, Flink cluster, and "derived property configuration service" running on your machine, as well as the necessary configuration set inside your platform-settings.json file.

      For more information on running derived properties, please refer to the help center docs on derived properties.

    • AddPropertyDefinitions Link icon

      @ThingworxExtensionApiMethod(since={7,3}) public InfoTable AddPropertyDefinitions(InfoTable values, Boolean ignoreInvalidDefinitions) throws Exception
      Service Category:
      Metadata
      Service Description:
      Add multiple property definitions at once.
      Parameters:
      values - Infotable where each row defines a property, using the PropertyDefinitionWithDetailsV2 data shape - INFOTABLE
      ignoreInvalidDefinitions - True will skip over any invalid definitions provided, false indicates to fail the whole transaction when at least one invalid definition is found - BOOLEAN
      Returns:
      status Table of information about which properties caused errors while attempting to add - INFOTABLE - Aspects {dataShape:BulkProcessingReport}
      Throws:
      Exception - If an error occurs

    • AddServiceDefinition Link icon

      @ThingworxExtensionApiMethod(since={8,0}, deprecatedSince={9,4}) @Deprecated public void AddServiceDefinition(String name, String description, String category, InfoTable parameters, InfoTable resultType, Boolean remote, String remoteServiceName, Integer timeout) throws Exception
      Deprecated.
      Throws:
      Exception - If an error occurs

    • AddServiceDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddServiceDefinition(String name, String description, String category, InfoTable parameters, InfoTable resultType, Boolean remote, String remoteServiceName, Integer timeout, org.json.JSONObject accessModifier) throws Exception
      Service Category:
      Metadata
      Service Description:
      Add or update a service definition.
      Parameters:
      name - Property name - STRING
      description - Property description - STRING
      category - Category - STRING
      parameters - Service parameters - INFOTABLE
      resultType - Service result type - INFOTABLE
      remote - Is a remote service - BOOLEAN
      remoteServiceName - Remote service name - STRING
      timeout - Request timeout - INTEGER
      accessModifier - AccessModifier for serviceDefinition - JSON
      Throws:
      Exception - If an error occurs

    • AddEventDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddEventDefinition(String name, String description, String category, String dataShape, Boolean remote, String remoteEventName) throws Exception
      Service Category:
      Metadata
      Service Description:
      Add or update an event definition.
      Parameters:
      name - Property name - STRING
      description - Property description - STRING
      category - Category - STRING
      dataShape - Data shape - DATASHAPENAME
      remote - Is a remote service - BOOLEAN
      remoteEventName - Remote event name - STRING
      Throws:
      Exception - If an error occurs

    • DisableSubscription Link icon

      @Deprecated @ThingworxExtensionApiMethod(since={6,6}, deprecatedSince={9,0}) public void DisableSubscription(String thingName, String eventName, String propertyName) throws Exception
      Deprecated.
      Throws:
      Exception - If an error occurs

    • DisableSubscription Link icon

      @ThingworxExtensionApiMethod(since={9,0}) public void DisableSubscription(String subscriptionName) throws Exception
      Service Category:
      Subscriptions
      Service Description:
      Disable Subscription.
      Parameters:
      subscriptionName - Subscription name - STRING
      Throws:
      Exception - If an error occurs

    • EnableSubscription Link icon

      @Deprecated @ThingworxExtensionApiMethod(since={6,6}, deprecatedSince={9,0}) public void EnableSubscription(String thingName, String eventName, String propertyName) throws Exception
      Deprecated.
      Throws:
      Exception - If an error occurs

    • EnableSubscription Link icon

      @ThingworxExtensionApiMethod(since={9,0}) public void EnableSubscription(String subscriptionName) throws Exception
      Service Category:
      Subscriptions
      Service Description:
      Enable Subscription.
      Parameters:
      subscriptionName - Subscription name - STRING
      Throws:
      Exception - If an error occurs

    • RemovePropertyDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void RemovePropertyDefinition(String name) throws Exception
      Service Category:
      Metadata
      Service Description:
      Remove a property definition.
      Parameters:
      name - Property name - STRING
      Throws:
      Exception - If an error occurs

    • RemoveServiceDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void RemoveServiceDefinition(String name) throws Exception
      Service Category:
      Metadata
      Service Description:
      Remove a service definition.
      Parameters:
      name - Service name - STRING
      Throws:
      Exception - If an error occurs

    • RemoveEventDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void RemoveEventDefinition(String name) throws Exception
      Service Category:
      Metadata
      Service Description:
      Remove a event definition.
      Parameters:
      name - Event name - STRING
      Throws:
      Exception - If an error occurs

    • AddOrUpdateAlert Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddOrUpdateAlert(String property, String alertType, String alertName, String description, Boolean enabled, Integer priority, InfoTable attributes, Boolean persistent) throws Exception
      Service Category:
      Alerts
      Service Description:
      Add or update an alert for a property.
      Parameters:
      property - Property name - STRING
      alertType - Alert type - STRING
      alertName - Alert name - STRING
      description - Alert description - STRING
      enabled - Alert enabled - BOOLEAN
      priority - Alert priority - INTEGER
      attributes - Alert attributes - INFOTABLE
      persistent - Persist this change - BOOLEAN
      Throws:
      Exception - If an error occurs

    • RemoveAlert Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void RemoveAlert(String property, String alertName, Boolean persistent) throws Exception
      Service Category:
      Alerts
      Service Description:
      Remove an alert for a property.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      persistent - Persist this change - BOOLEAN
      Throws:
      Exception - If an error occurs

    • GetLocalAlertDefinitions Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetLocalAlertDefinitions(String property) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get local alert definitions for a property.
      Parameters:
      property - Property name - STRING
      Returns:
      AlertDefinitions Alert definition - INFOTABLE - Aspects {dataShape:AlertDefinition}
      Throws:
      Exception - If an error occurs

    • GetAlertDefinitions Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetAlertDefinitions(String property) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get effective alert definitions for a property.
      Parameters:
      property - Property name - STRING
      Returns:
      AlertDefinitions Alert definition - INFOTABLE - Aspects {dataShape:AlertDefinition}
      Throws:
      Exception - If an error occurs

    • GetAlertDefinition Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetAlertDefinition(String property, String alertName) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get alert definition for a property.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      Returns:
      AlertDefinitions Alert definition - INFOTABLE - Aspects {dataShape:AlertDefinition}
      Throws:
      Exception - If an error occurs

    • HasAlert Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Boolean HasAlert(String property, String alertName) throws Exception
      Service Category:
      Alerts
      Service Description:
      Check to see if an alert is defined for a property.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      Returns:
      result Has alert definition - BOOLEAN
      Throws:
      Exception - If an error occurs

    • SetNumberAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetNumberAlertParameter(String property, String alertName, String parameterName, Double value, Boolean persistent) throws Exception
      Service Category:
      Alerts
      Service Description:
      Set a numeric alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      value - Parameter value - NUMBER
      persistent - Make it persistent - BOOLEAN
      Throws:
      Exception - If an error occurs

    • GetNumberAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Double GetNumberAlertParameter(String property, String alertName, String parameterName) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get a numeric alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      Returns:
      value Alert parameter value - NUMBER
      Throws:
      Exception - If an error occurs

    • SetIntegerAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetIntegerAlertParameter(String property, String alertName, String parameterName, Integer value, Boolean persistent) throws Exception
      Service Category:
      Alerts
      Service Description:
      Set a numeric alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      value - Parameter value - INTEGER
      persistent - Make it persistent - BOOLEAN
      Throws:
      Exception - If an error occurs

    • GetIntegerAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Integer GetIntegerAlertParameter(String property, String alertName, String parameterName) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get a numeric alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      Returns:
      value Alert parameter value - INTEGER
      Throws:
      Exception - If an error occurs

    • GetLongAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Long GetLongAlertParameter(String property, String alertName, String parameterName) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get a long alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      Returns:
      value Alert parameter value - LONG
      Throws:
      Exception - If an error occurs

    • SetBooleanAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetBooleanAlertParameter(String property, String alertName, String parameterName, Boolean value, Boolean persistent) throws Exception
      Service Category:
      Alerts
      Service Description:
      Set a boolean alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      value - Parameter value - BOOLEAN
      persistent - Make it persistent - BOOLEAN
      Throws:
      Exception - If an error occurs

    • GetBooleanAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Boolean GetBooleanAlertParameter(String property, String alertName, String parameterName) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get a boolean alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      Returns:
      value Alert parameter value - BOOLEAN
      Throws:
      Exception - If an error occurs

    • SetDateTimeAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetDateTimeAlertParameter(String property, String alertName, String parameterName, org.joda.time.DateTime value, Boolean persistent) throws Exception
      Service Category:
      Alerts
      Service Description:
      Set a date alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      value - Parameter value - DATETIME
      persistent - Make it persistent - BOOLEAN
      Throws:
      Exception - If an error occurs

    • GetDateTimeAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public org.joda.time.DateTime GetDateTimeAlertParameter(String property, String alertName, String parameterName) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get a date alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      Returns:
      value Alert parameter value - DATETIME
      Throws:
      Exception - If an error occurs

    • SetLocationAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetLocationAlertParameter(String property, String alertName, String parameterName, Location value, Boolean persistent) throws Exception
      Service Category:
      Alerts
      Service Description:
      Set a location alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      value - Parameter value - LOCATION
      persistent - Make it persistent - BOOLEAN
      Throws:
      Exception - If an error occurs

    • GetLocationAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Location GetLocationAlertParameter(String property, String alertName, String parameterName) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get a location alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      Returns:
      value Alert parameter value - LOCATION
      Throws:
      Exception - If an error occurs

    • SetStringAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetStringAlertParameter(String property, String alertName, String parameterName, String value, Boolean persistent) throws Exception
      Service Category:
      Alerts
      Service Description:
      Set a string alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      value - Parameter value - STRING
      persistent - Make it persistent - BOOLEAN
      Throws:
      Exception - If an error occurs

    • GetStringAlertParameter Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public String GetStringAlertParameter(String property, String alertName, String parameterName) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get a string alert parameter.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      parameterName - Parameter name - STRING
      Returns:
      value Alert parameter value - STRING
      Throws:
      Exception - If an error occurs

    • GetAlertStatus Link icon

      @ThingworxExtensionApiMethod(since={7,4}) public String GetAlertStatus(String property, String alertName) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get the Status of the given Alert.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      Returns:
      result Status of Alert - STRING
      Throws:
      Exception - If an error occurs

    • GetAlertStatuses Link icon

      @ThingworxExtensionApiMethod(since={7,4}) public InfoTable GetAlertStatuses() throws Exception
      Service Category:
      Alerts
      Service Description:
      Get the Statuses of the given Alerts.
      Returns:
      result Status of all Alerts on this Thing - INFOTABLE - Aspects {dataShape:AlertStatus}
      Throws:
      Exception - If an error occurs

    • GetAlertStatusesForProperty Link icon

      @ThingworxExtensionApiMethod(since={7,4}) public InfoTable GetAlertStatusesForProperty(String property) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get the Statuses of the given Alerts.
      Parameters:
      property - Property name - STRING
      Returns:
      result Status of all Alerts on the Property - INFOTABLE
      Throws:
      Exception - If an error occurs

    • GetAnomalyAlertTrainingStatisticsForAlert Link icon

      @ThingworxExtensionApiMethod(since={8,0}) public InfoTable GetAnomalyAlertTrainingStatisticsForAlert(String property, String alertName) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get Training Statistics for given Alert.
      Parameters:
      property - Property name - STRING
      alertName - Alert name - STRING
      Returns:
      result Anomaly Alert Training Statistics for given Alert - INFOTABLE - Aspects {dataShape:AnomalyAlertTrainingStatistics}
      Throws:
      Exception - If an error occurs

    • GetAllAnomalyAlertTrainingStatistics Link icon

      @ThingworxExtensionApiMethod(since={8,0}) public InfoTable GetAllAnomalyAlertTrainingStatistics() throws Exception
      Service Category:
      Alerts
      Service Description:
      Get All AnomalyAlert Training Statistics on this Thing.
      Returns:
      result AnomalyAlert Training Statistics on this Thing - INFOTABLE - Aspects {dataShape:AnomalyAlertTrainingStatistics}
      Throws:
      Exception - If an error occurs

    • GetAnomalyAlertTrainingStatisticsForProperty Link icon

      @ThingworxExtensionApiMethod(since={8,0}) public InfoTable GetAnomalyAlertTrainingStatisticsForProperty(String property) throws Exception
      Service Category:
      Alerts
      Service Description:
      Get AnomalyAlert Training Statistics for given Property.
      Parameters:
      property - Property name - STRING
      Returns:
      result Training Statistics of all AnomalyAlerts on the Property - INFOTABLE - Aspects {dataShape:AnomalyAlertTrainingStatistics}
      Throws:
      Exception - If an error occurs

    • AddDynamicSubscription Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddDynamicSubscription(String thingName, String eventName, String propertyName, String serviceName) throws Exception
      Service Category:
      Subscriptions
      Service Description:
      Add a dynamic subscription.
      Parameters:
      thingName - Thing name - THINGNAME
      eventName - Event name - STRING
      propertyName - Property name - STRING
      serviceName - Local service name - STRING
      Throws:
      Exception - If an error occurs

    • IsDynamicSubscriptionCreated Link icon

      @ThingworxExtensionApiMethod(since={8,5}) public boolean IsDynamicSubscriptionCreated(String thingName, String eventName, String propertyName, String serviceName) throws Exception
      Service Category:
      Subscriptions
      Service Description:
      Returns true if given dynamic subscription is present.
      Parameters:
      thingName - Thing name - THINGNAME
      eventName - Event name - STRING
      propertyName - Property name - STRING
      serviceName - Local service name - STRING
      Returns:
      result True/false based on if given dynamic subscription exist or not - BOOLEAN
      Throws:
      Exception - If an error occurs

    • RemoveDynamicSubscription Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void RemoveDynamicSubscription(String thingName, String eventName, String propertyName, String serviceName) throws Exception
      Service Category:
      Subscriptions
      Service Description:
      Remove a dynamic subscription.
      Parameters:
      thingName - Thing name - THINGNAME
      eventName - Event name - STRING
      propertyName - Property name - STRING
      serviceName - Local service name - STRING
      Throws:
      Exception - If an error occurs

    • dispatchEvent Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void dispatchEvent(ThingworxEvent event)

    • dispatchBackgroundEvent Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void dispatchBackgroundEvent(ThingworxEvent event)

    • processServiceRequest Link icon

      @ThingworxExtensionApiMethod(since={6,6}, canOverride=true, requiresSuper=true) public InfoTable processServiceRequest(String serviceName, ValueCollection params) throws Exception
      Description copied from interface: IServiceProvider


      Processes an internal or reflected service request. Entities may call this method if they wish to invoke a service call directly on an entity. This method performs a service invoke authorization check against the current security context.

      Specified by:
      processServiceRequest in interface IServiceProvider
      Parameters:
      serviceName - - The name of the service to invoke
      params - - A collection of parameter mappings
      Returns:
      The results of the service invocation
      Throws:
      Exception - If an error occurs

      If the security check fails, the service does not exist, or an error occurred during the execution of the service

      Subclasses of Thing may override this method if they want to add additional logic or validation around service calls.

    • processAPIServiceRequest Link icon

      @ThingworxExtensionApiMethod(since={6,6}, canOverride=true, requiresSuper=true) public InfoTable processAPIServiceRequest(String serviceName, ValueCollection params) throws Exception
      Description copied from interface: IServiceProvider


      Processes a service request invoked via the REST API. This method performs a service invoke authorization check against the current security context.

      Specified by:
      processAPIServiceRequest in interface IServiceProvider
      Parameters:
      serviceName - - The name of the service to invoke
      params - - A collection of parameter mappings
      Returns:
      The results of the service invocation
      Throws:
      Exception - If an error occurs

      If the security check fails, the service does not exist, or an error occurred during the execution of the service

      Subclasses of Thing may override this method if they want to add additional logic or validation around service calls.

    • isAlwaysAvailableService Link icon

      @ThingworxExtensionApiMethod(since={6,6}, canOverride=true, requiresSuper=true) public static boolean isAlwaysAvailableService(String name)


      Returns true if the provided service name can always be invoked against the thing, regardless of its current state.

      Subclasses overriding this method must ensure that they preserve and return the result of this method if it returns true.

      Parameters:
      name - the name of the service to check
      Returns:
      true if the service can always be invoked

    • fireEvent Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void fireEvent(EventDefinition eventDefinition, org.joda.time.DateTime timestamp, ValueCollection eventData) throws Exception
      Specified by:
      fireEvent in interface IEventProvider
      Throws:
      Exception - If an error occurs

    • GetImplementedShapes Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetImplementedShapes() throws Exception
      Service Category:
      Metadata
      Service Description:
      Get the implemented thing shapes for this thing.
      Returns:
      result Implemented Shapes - INFOTABLE - Aspects {dataShape:EntityList}
      Throws:
      Exception - If an error occurs

    • GetLocallyImplementedShapes Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetLocallyImplementedShapes() throws Exception
      Service Category:
      Metadata
      Service Description:
      Get the locally implemented thing shapes for this thing.
      Returns:
      result Implemented Shapes - INFOTABLE - Aspects {dataShape:EntityList}
      Throws:
      Exception - If an error occurs

    • GetMashups Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetMashups() throws Exception
      Service Category:
      Mashups
      Service Description:
      Get the mashups related to this thing.
      Returns:
      result Mashups - INFOTABLE - Aspects {dataShape:MashupList}
      Throws:
      Exception - If an error occurs

    • GetThingTemplate Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetThingTemplate() throws Exception
      Service Category:
      Metadata
      Service Description:
      Get the thing template for this thing.
      Returns:
      result Thing Template - INFOTABLE - Aspects {dataShape:EntityList}
      Throws:
      Exception - If an error occurs

    • ImplementsShape Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Boolean ImplementsShape(String thingShapeName) throws Exception
      Service Category:
      Metadata
      Service Description:
      Check to see if a thing implements a particular thing shape.
      Parameters:
      thingShapeName - Thing shape name - THINGSHAPENAME
      Returns:
      result Implements Shape - BOOLEAN
      Throws:
      Exception - If an error occurs

    • IsDerivedFromTemplate Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Boolean IsDerivedFromTemplate(String thingTemplateName) throws Exception
      Service Category:
      Metadata
      Service Description:
      Check to see if a thing is derived from a particular thing template.
      Parameters:
      thingTemplateName - Thing template name - THINGTEMPLATENAME
      Returns:
      result Is Derived From Template - BOOLEAN
      Throws:
      Exception - If an error occurs

    • SetPublished Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetPublished(Boolean publish) throws Exception
      Service Category:
      Federation
      Service Description:
      Set this as a published thing for federation.
      Parameters:
      publish - Publish status (true/false) - BOOLEAN
      Throws:
      Exception - If an error occurs

    • GetPublished Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Boolean GetPublished() throws Exception
      Service Category:
      Federation
      Service Description:
      Get published thing for federation.
      Returns:
      result Publishing status for this thing - BOOLEAN
      Throws:
      Exception - If an error occurs

    • SetDescription Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetDescription(String description) throws Exception
      Service Category:
      Metadata
      Service Description:
      Overwrite/set the description for an entity.
      Overrides:
      SetDescription in class RootEntity
      Parameters:
      description - Description for an entity - STRING
      Throws:
      Exception - If an error occurs

    • SetTags Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void SetTags(TagCollection tags) throws Exception
      Service Category:
      Metadata
      Service Description:
      Overwrite/set the tags for an entity.
      Overrides:
      SetTags in class RootEntity
      Parameters:
      tags - Tags for an entity - TAGS
      Throws:
      Exception - If an error occurs

    • AddTags Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddTags(TagCollection tags) throws Exception
      Service Category:
      Metadata
      Service Description:
      Append additional tags to an entity.
      Overrides:
      AddTags in class RootEntity
      Parameters:
      tags - Tags for an entity - TAGS
      Throws:
      Exception - If an error occurs

    • GetThingRelationships Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetThingRelationships(Integer maxDepth) throws Exception
      Service Category:
      Relationships
      Service Description:
      Return a list of all the things referenced by this thing.
      Parameters:
      maxDepth - Maximum depth to search - INTEGER
      Returns:
      result Thing connections - INFOTABLE - Aspects {dataShape:ThingRelationship}
      Throws:
      Exception - If an error occurs

    • GetNetworks Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetNetworks() throws Exception
      Service Category:
      Networks
      Service Description:
      Get the networks associated with a thing.
      Returns:
      networks Networks - INFOTABLE - Aspects {dataShape:EntityList}
      Throws:
      Exception - If an error occurs

    • IsInNetwork Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Boolean IsInNetwork(String network) throws Exception
      Service Category:
      Networks
      Service Description:
      Check to see if a thing is in a specific network.
      Parameters:
      network - Network name - STRING
      Returns:
      result Result - BOOLEAN
      Throws:
      Exception - If an error occurs

    • HavePropertiesChangedSince Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public Boolean HavePropertiesChangedSince(org.joda.time.DateTime timestamp) throws Exception
      Service Category:
      Properties
      Service Description:
      Has any property changed since a given time.
      Parameters:
      timestamp - Timestamp to compare - DATETIME
      Returns:
      result Result - BOOLEAN
      Throws:
      Exception - If an error occurs

    • PurgePropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void PurgePropertyHistory(String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean immediate) throws Exception
      Service Category:
      Maintenance
      Service Description:
      Purge stream entries for a specified date range.
      Parameters:
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      immediate - Delete immediately - BOOLEAN
      Throws:
      Exception - If an error occurs

    • PurgeAllPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={7,2}) public void PurgeAllPropertyHistory(org.joda.time.DateTime startDate, org.joda.time.DateTime endDate) throws Exception
      Service Category:
      Maintenance
      Service Description:
      Purge all value stream entries for a specified date range.
      Parameters:
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      Throws:
      Exception - If an error occurs

    • PurgeSelectedPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={7,2}) public void PurgeSelectedPropertyHistory(org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, InfoTable propertiesToPurge) throws Exception
      Service Category:
      Maintenance
      Service Description:
      Purge all value stream entries for a specified date range for a given list of properties.
      Parameters:
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      propertiesToPurge - Properties to purge - INFOTABLE
      Throws:
      Exception - If an error occurs

    • QueryPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryPropertyHistory(Double maxItems, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

      Additional Information

      Queries the value stream for each property (must be a logged property) value of the given source thing in a given time range. Calls ValueStream.queryValueStreamEntries for each property, then munges the values together in a result set.

      QueryPropertyHistory returns a data set created by querying each logged property on a thing and then combining the individual datasets into one big data set. A "row" is created for each time stamp in the individual data sets. If there is a logged value with that time stamp, it is entered in the row of the data set. If there is no logged value, the last logged value for that property is used. If there is no logged property; the entry is left blank. This combiner process removes duplicates for a given property based on timestamp.

      To obtain the actual logged values for a given property, you must use the QuerydatatypePropertyHistory services (for example, QueryIntegerPropertyHistory). You can confirm that data is actually purged with these services.

    • QueryPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,3,4}) public InfoTable QueryPropertyHistory(Double maxItems, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, String fillOption, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryPropertyHistory(Double maxItems, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, String fillOption, String returnedMetadata, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Queries the value stream entries for logged property value along with filter and sort criteria and normalizes the data set to display result for a given time range.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      fillOption - Defines the value to report for time intervals with no data - STRING
      returnedMetadata - Defines what extra columns will be returned in addition to the Property name, timestamp, and value. - STRING
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE
      Throws:
      Exception - If an error occurs

    • QueryNamedPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryNamedPropertyHistory(InfoTable propertyNames, Double maxItems, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryNamedPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,3,4}) public InfoTable QueryNamedPropertyHistory(InfoTable propertyNames, Double maxItems, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, String fillOption, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryNamedPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryNamedPropertyHistory(InfoTable propertyNames, Double maxItems, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, String fillOption, String returnedMetadata, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Queries the value stream entries for specified logged property value along with filter and sort criteria and normalizes the data set to display result for a given time range.
      Parameters:
      propertyNames - Property names - INFOTABLE
      maxItems - Maximum number of items to return - NUMBER
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      fillOption - Defines the value to report for time intervals with no data - STRING
      returnedMetadata - Defines what extra columns will be returned in addition to the Property name, timestamp, and value. - STRING
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE
      Throws:
      Exception - If an error occurs

    • QueryIntegerPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryIntegerPropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryIntegerPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryIntegerPropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:IntegerValueStream}
      Throws:
      Exception - If an error occurs

    • QueryLongPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryLongPropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryLongPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryLongPropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:LongValueStream}
      Throws:
      Exception - If an error occurs

    • QueryNumberPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryNumberPropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryNumberPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryNumberPropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:NumberValueStream}
      Throws:
      Exception - If an error occurs

    • QueryBooleanPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryBooleanPropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryBooleanPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryBooleanPropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:BooleanValueStream}
      Throws:
      Exception - If an error occurs

    • QueryDateTimePropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryDateTimePropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryDateTimePropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryDateTimePropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:DateTimeValueStream}
      Throws:
      Exception - If an error occurs

    • QueryInfoTablePropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryInfoTablePropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query, Boolean flatten) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryInfoTablePropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryInfoTablePropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query, Boolean flatten) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      flatten - Flatten the result - BOOLEAN
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:InfoTableValueStream}
      Throws:
      Exception - If an error occurs

    • QueryLocationPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryLocationPropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryLocationPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryLocationPropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:LocationValueStream}
      Throws:
      Exception - If an error occurs

    • QueryStringPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryStringPropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryStringPropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryStringPropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:StringValueStream}
      Throws:
      Exception - If an error occurs

    • QueryVec2PropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={7,1}) public InfoTable QueryVec2PropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryVec2PropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryVec2PropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:Vec2DataShape}
      Throws:
      Exception - If an error occurs

    • QueryVec3PropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={7,1}) public InfoTable QueryVec3PropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryVec3PropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryVec3PropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:Vec3DataShape}
      Throws:
      Exception - If an error occurs

    • QueryVec4PropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={7,1}) public InfoTable QueryVec4PropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryVec4PropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryVec4PropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:Vec4DataShape}
      Throws:
      Exception - If an error occurs

    • QueryThingCodePropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={7,1}) public InfoTable QueryThingCodePropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryThingCodePropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryThingCodePropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:ThingCodeDataShape}
      Throws:
      Exception - If an error occurs

    • QueryImagePropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable QueryImagePropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Throws:
      Exception - If an error occurs

    • QueryImagePropertyHistory Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public InfoTable QueryImagePropertyHistory(Double maxItems, String propertyName, org.joda.time.DateTime startDate, org.joda.time.DateTime endDate, String quality, Boolean oldestFirst, org.json.JSONObject query) throws Exception
      Service Category:
      Queries
      Service Description:
      Query stream entries, along with filter and sort criteria.
      Parameters:
      maxItems - Maximum number of items to return - NUMBER
      propertyName - Property name - STRING
      startDate - Start time - DATETIME
      endDate - End time - DATETIME
      quality - Filter Quality value - STRING
      oldestFirst - Search/sort from oldest to newest - BOOLEAN
      query - Query definition - QUERY
      Returns:
      result Table entries - INFOTABLE - Aspects {dataShape:ImageValueStream}
      Throws:
      Exception - If an error occurs

    • WritePropertiesToStream Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void WritePropertiesToStream(String name, TagCollection tags) throws Exception
      Service Category:
      Data
      Service Description:
      Store properties of this thing to a stream.
      Parameters:
      name - Stream name - THINGNAME
      tags - Tags - TAGS
      Throws:
      Exception - If an error occurs

    • GetThingSummaryInformation Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public InfoTable GetThingSummaryInformation() throws Exception
      Service Category:
      Metadata
      Service Description:
      Get thing summary information.
      Returns:
      Summary Thing summary information - INFOTABLE - Aspects {dataShape:Thing}
      Throws:
      Exception - If an error occurs

    • GetAvatar Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public ImagePrimitive GetAvatar() throws Exception
      Service Category:
      Metadata
      Service Description:
      Get avatar image.
      Specified by:
      GetAvatar in interface IAvatar
      Overrides:
      GetAvatar in class RootEntity
      Returns:
      Avatar Entity avatar - IMAGE
      Throws:
      Exception - If an error occurs

    • GetHomeMashup Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public String GetHomeMashup()
      Service Category:
      Mashups
      Service Description:
      Get home mashup.
      Overrides:
      GetHomeMashup in class RootEntity
      Returns:
      HomeMashup Home mashup - MASHUPNAME

    • AddIntegerValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddIntegerValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Integer value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddIntegerValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddIntegerValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Integer value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - INTEGER
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • AddLongValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddLongValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Long value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddLongValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddLongValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Long value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - LONG
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • AddNumberValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddNumberValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Double value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddNumberValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddNumberValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Double value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - NUMBER
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • AddBooleanValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddBooleanValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Boolean value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddBooleanValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddBooleanValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Boolean value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - BOOLEAN
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • AddLocationValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddLocationValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Location value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddLocationValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddLocationValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Location value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - LOCATION
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • AddVec2ValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={7,1}) public void AddVec2ValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Vec2 value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddVec2ValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddVec2ValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Vec2 value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - VEC2
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • AddVec3ValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={7,1}) public void AddVec3ValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Vec3 value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddVec3ValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddVec3ValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Vec3 value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - VEC3
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • AddVec4ValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={7,1}) public void AddVec4ValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Vec4 value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddVec4ValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddVec4ValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, Vec4 value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - VEC4
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • AddThingCodeValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={7,1}) public void AddThingCodeValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, ThingCode value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddThingCodeValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddThingCodeValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, ThingCode value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - THINGCODE
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • AddStringValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddStringValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, String value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddStringValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddStringValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, String value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - STRING
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • AddInfoTableValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddInfoTableValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, InfoTable value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddInfoTableValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddInfoTableValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, InfoTable value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - INFOTABLE
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • AddImageValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddImageValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, byte[] value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddImageValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddImageValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, byte[] value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - IMAGE
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • AddDateTimeValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={6,6}) public void AddDateTimeValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, org.joda.time.DateTime value) throws Exception
      Throws:
      Exception - If an error occurs

    • AddDateTimeValueStreamEntry Link icon

      @ThingworxExtensionApiMethod(since={9,5}) public void AddDateTimeValueStreamEntry(org.joda.time.DateTime timestamp, String propertyName, org.joda.time.DateTime value, String quality) throws Exception
      Service Category:
      StreamEntries
      Service Description:
      Add a new stream entry.
      Parameters:
      timestamp - Event time (optional) - DATETIME
      propertyName - Property name - STRING
      value - Data value - DATETIME
      quality - Quality value - STRING
      Throws:
      Exception - If an error occurs

    • checkValueStream Link icon

      @ThingworxExtensionApiMethod(since={6,6}) protected void checkValueStream() throws Exception
      Throws:
      Exception - If an error occurs

    • checkPropertyName Link icon

      @ThingworxExtensionApiMethod(since={6,6}) protected void checkPropertyName(String propertyName) throws Exception
      Throws:
      Exception - If an error occurs

    • QueuePostCommitEvent Link icon

      @ThingworxExtensionApiMethod(since={9,0}, canOverride=true, requiresSuper=true) public void QueuePostCommitEvent(String eventName) throws Exception
      Service Category:
      Queueing
      Service Description:
      Queue events to be executed in a post commit action.
      Parameters:
      eventName - Event Name - STRING
      Throws:
      Exception - If an error occurs

    • GetThingGroupDelegatedVisibilityPermissions Link icon

      @ThingworxExtensionApiMethod(since={9,2}) public InfoTable GetThingGroupDelegatedVisibilityPermissions() throws Exception
      Service Category:
      Service Description:
      Get the Visibility permissions from all the ThingGroups where this Thing is directly or indirectly a member.
      Returns:
      result Delegated Permissions - INFOTABLE - Aspects {dataShape:DelegatedVisibilityPermission}
      Throws:
      Exception - If an error occurs