Skip navigation links
Thingworx Platform API
8.5.0
com.thingworx.thingshape

Class ThingShape

    • Constructor Detail

      • ThingShape

        public ThingShape()
    • Method Detail

      • QueryImplementingThings

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable QueryImplementingThings(java.lang.Double maxItems,
                                                                                           TagCollection tags,
                                                                                           java.lang.String nameMask,
                                                                                           org.json.JSONObject query)
                                                                                    throws java.lang.Exception
        Service Category:
        Queries
        Service Description:
        Return a list of all the things that implement this shape.
        Specified by:
        QueryImplementingThings in interface IImplementableEntity
        Parameters:
        maxItems - Maximum number of items to return - NUMBER
        tags - Tags to search on - TAGS
        nameMask - Name pattern - STRING
        query - Query definition - QUERY
        Returns:
        result Implementing Things - INFOTABLE - Aspects {dataShape:RootEntityList}
        Throws:
        java.lang.Exception - If an error occurs
      • QueryImplementingThingsWithData

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable QueryImplementingThingsWithData(java.lang.Double maxItems,
                                                                                                   TagCollection tags,
                                                                                                   java.lang.String nameMask,
                                                                                                   org.json.JSONObject query)
                                                                                            throws java.lang.Exception
        Service Category:
        Queries
        Service Description:
        Return a list of all the things that implement this shape along with the thing properties and values.
        Specified by:
        QueryImplementingThingsWithData in interface IImplementableEntity
        Parameters:
        maxItems - Maximum number of items to return - NUMBER
        tags - Tags to search on - TAGS
        nameMask - Name pattern - STRING
        query - Query definition - QUERY
        Returns:
        result Implementing Things With Data - INFOTABLE - Aspects {dataShape:RootEntityList}
        Throws:
        java.lang.Exception - If an error occurs
      • QueryImplementingThingsWithNamedData

        @ThingworxExtensionApiMethod(since={8,1})
        public InfoTable QueryImplementingThingsWithNamedData(java.lang.Double maxItems,
                                                                                                        TagCollection tags,
                                                                                                        java.lang.String nameMask,
                                                                                                        org.json.JSONObject query,
                                                                                                        InfoTable basicPropertyNames,
                                                                                                        InfoTable propertyNames)
                                                                                                 throws java.lang.Exception
        Service Category:
        Queries
        Service Description:
        Return a list of all the things that implement this shape along with the thing properties and values.
        Specified by:
        QueryImplementingThingsWithNamedData in interface IImplementableEntity
        Parameters:
        maxItems - Maximum number of items to return - NUMBER
        tags - Tags to search on - TAGS
        nameMask - Name pattern - STRING
        query - Query definition - QUERY
        basicPropertyNames - Basic Property names - INFOTABLE
        propertyNames - Property names - INFOTABLE
        Returns:
        result Implementing Things With Data - INFOTABLE - Aspects {dataShape:RootEntityList}
        Throws:
        java.lang.Exception - If an error occurs
      • GetImplementingThings

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetImplementingThings()
                                                                                  throws java.lang.Exception
        Service Category:
        Queries
        Service Description:
        Return a list of all the things that implement this shape.
        Specified by:
        GetImplementingThings in interface IImplementableEntity
        Returns:
        result Implementing Things - INFOTABLE - Aspects {dataShape:RootEntityList}
        Throws:
        java.lang.Exception - If an error occurs
      • GetImplementingThingsWithData

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetImplementingThingsWithData()
                                                                                          throws java.lang.Exception
        Service Category:
        Queries
        Service Description:
        Return a list of all the things that implement this shape along with the thing properties and values.
        Specified by:
        GetImplementingThingsWithData in interface IImplementableEntity
        Returns:
        result Implementing Things - INFOTABLE - Aspects {dataShape:RootEntityList}
        Throws:
        java.lang.Exception - If an error occurs
      • GetInstancePropertyDefinitions

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetInstancePropertyDefinitions(java.lang.String type)
                                                                                           throws java.lang.Exception
        Service Category:
        Metadata
        Service Description:
        Get the current property definitions for this thing.
        Parameters:
        type - Type to filter on - STRING
        Returns:
        result Property values - INFOTABLE - Aspects {dataShape:PropertyDefinition}
        Throws:
        java.lang.Exception - If an error occurs
      • GetInstanceEventDefinitions

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetInstanceEventDefinitions()
                                                                                        throws java.lang.Exception
        Service Category:
        Metadata
        Service Description:
        Get the current event definitions for this thing.
        Returns:
        result Event definitions - INFOTABLE - Aspects {dataShape:EventDefinition}
        Throws:
        java.lang.Exception - If an error occurs
      • GetInstanceServiceDefinitions

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetInstanceServiceDefinitions()
                                                                                          throws java.lang.Exception
        Service Category:
        Metadata
        Service Description:
        Get the current service definitions for this thing.
        Returns:
        result Service definitions - INFOTABLE - Aspects {dataShape:ServiceDefinition}
        Throws:
        java.lang.Exception - If an error occurs
      • GetPropertyLogging

        @ThingworxExtensionApiMethod(since={6,6})
        public java.lang.Boolean GetPropertyLogging(java.lang.String propertyName)
                                                                                       throws java.lang.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:
        java.lang.Exception - If an error occurs
      • SetPropertyLogging

        @ThingworxExtensionApiMethod(since={6,6})
        public void SetPropertyLogging(java.lang.String propertyName,
                                                                                 java.lang.Boolean enabled)
                                                                          throws java.lang.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:
        java.lang.Exception - If an error occurs
      • SetUnitsForNumericPropertyDefinition

        @ThingworxExtensionApiMethod(since={8,5})
        public void SetUnitsForNumericPropertyDefinition(java.lang.String propertyName,
                                                                                                   java.lang.String units)
                                                                                            throws java.lang.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:
        java.lang.Exception - If an error occurs
      • AddPropertyTransformDefinition

        @ThingworxExtensionApiMethod(since={8,4})
        public void AddPropertyTransformDefinition(java.lang.String name,
                                                                                             java.lang.String description,
                                                                                             java.lang.String category,
                                                                                             java.lang.Boolean persistent,
                                                                                             java.lang.Boolean logged,
                                                                                             java.lang.Integer timeout,
                                                                                             InfoTable propertyTransformConfig)
                                                                                      throws java.lang.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:
        java.lang.Exception - If an error occurs

        Creates a derived property on this ThingShape. 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.

      • AddPropertyDefinition

        @ThingworxExtensionApiMethod(since={6,6})
         @Deprecated
        public void AddPropertyDefinition(java.lang.String name,
                                                                                                 java.lang.String description,
                                                                                                 java.lang.String type,
                                                                                                 java.lang.String category,
                                                                                                 java.lang.String dataShape,
                                                                                                 java.lang.Boolean readOnly,
                                                                                                 java.lang.Boolean persistent,
                                                                                                 java.lang.Boolean logged,
                                                                                                 java.lang.String dataChangeType,
                                                                                                 java.lang.Double dataChangeThreshold,
                                                                                                 java.lang.Boolean remote,
                                                                                                 java.lang.String remotePropertyName,
                                                                                                 java.lang.Integer timeout,
                                                                                                 java.lang.String pushType,
                                                                                                 java.lang.Double pushThreshold,
                                                                                                 java.lang.String defaultValue)
                                                                                          throws java.lang.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:
        java.lang.Exception - If an error occurs

      • AddPropertyDefinition

        @ThingworxExtensionApiMethod(since={8,0})
        public void AddPropertyDefinition(java.lang.String name,
                                                                                    java.lang.String description,
                                                                                    java.lang.String type,
                                                                                    java.lang.String category,
                                                                                    java.lang.String dataShape,
                                                                                    java.lang.Boolean readOnly,
                                                                                    java.lang.Boolean persistent,
                                                                                    java.lang.Boolean logged,
                                                                                    java.lang.String dataChangeType,
                                                                                    java.lang.Double dataChangeThreshold,
                                                                                    java.lang.Boolean remote,
                                                                                    java.lang.String remotePropertyName,
                                                                                    java.lang.Integer timeout,
                                                                                    java.lang.String pushType,
                                                                                    java.lang.Double pushThreshold,
                                                                                    java.lang.String defaultValue,
                                                                                    org.json.JSONObject remoteBindingAspects)
                                                                             throws java.lang.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
        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
        Throws:
        java.lang.Exception - If an error occurs
      • AddServiceDefinition

        @ThingworxExtensionApiMethod(since={6,6})
        public void AddServiceDefinition(java.lang.String name,
                                                                                   java.lang.String description,
                                                                                   java.lang.String category,
                                                                                   InfoTable parameters,
                                                                                   InfoTable resultType,
                                                                                   java.lang.Boolean remote,
                                                                                   java.lang.String remoteServiceName,
                                                                                   java.lang.Integer timeout)
                                                                            throws java.lang.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
        Throws:
        java.lang.Exception - If an error occurs
      • AddEventDefinition

        @ThingworxExtensionApiMethod(since={6,6})
        public void AddEventDefinition(java.lang.String name,
                                                                                 java.lang.String description,
                                                                                 java.lang.String category,
                                                                                 java.lang.String dataShape,
                                                                                 java.lang.Boolean remote,
                                                                                 java.lang.String remoteEventName)
                                                                          throws java.lang.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:
        java.lang.Exception - If an error occurs
      • DisableSubscription

        @ThingworxExtensionApiMethod(since={6,6})
        public void DisableSubscription(java.lang.String thingName,
                                                                                  java.lang.String eventName,
                                                                                  java.lang.String propertyName)
                                                                           throws java.lang.Exception
        Service Category:
        Subscriptions
        Service Description:
        Disable Subscription.
        Parameters:
        thingName - Thing name - THINGNAME
        eventName - Event name - STRING
        propertyName - Property name - STRING
        Throws:
        java.lang.Exception - If an error occurs
      • EnableSubscription

        @ThingworxExtensionApiMethod(since={6,6})
        public void EnableSubscription(java.lang.String thingName,
                                                                                 java.lang.String eventName,
                                                                                 java.lang.String propertyName)
                                                                          throws java.lang.Exception
        Service Category:
        Subscriptions
        Service Description:
        Enable Subscription.
        Parameters:
        thingName - Thing name - THINGNAME
        eventName - Event name - STRING
        propertyName - Property name - STRING
        Throws:
        java.lang.Exception - If an error occurs
      • RemovePropertyDefinition

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

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

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

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetLoggedProperties(java.lang.String type)
                                                                                throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetNumericLoggedProperties

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetNumericLoggedProperties()
                                                                                       throws java.lang.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:
        java.lang.Exception - If an error occurs
      • AddOrUpdateAlert

        @ThingworxExtensionApiMethod(since={6,6})
        public void AddOrUpdateAlert(java.lang.String property,
                                                                               java.lang.String alertType,
                                                                               java.lang.String alertName,
                                                                               java.lang.String description,
                                                                               java.lang.Boolean enabled,
                                                                               java.lang.Integer priority,
                                                                               InfoTable attributes,
                                                                               java.lang.Boolean persistent)
                                                                        throws java.lang.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:
        java.lang.Exception - If an error occurs
      • RemoveAlert

        @ThingworxExtensionApiMethod(since={6,6})
        public void RemoveAlert(java.lang.String property,
                                                                          java.lang.String alertName,
                                                                          java.lang.Boolean persistent)
                                                                   throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetLocalAlertDefinitions

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetLocalAlertDefinitions(java.lang.String property)
                                                                                     throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetAlertDefinitions

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetAlertDefinitions(java.lang.String property)
                                                                                throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetAlertDefinition

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetAlertDefinition(java.lang.String property,
                                                                                      java.lang.String alertName)
                                                                               throws java.lang.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:
        java.lang.Exception - If an error occurs
      • HasAlert

        @ThingworxExtensionApiMethod(since={6,6})
        public java.lang.Boolean HasAlert(java.lang.String property,
                                                                                    java.lang.String alertName)
                                                                             throws java.lang.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:
        java.lang.Exception - If an error occurs
      • SetNumberAlertParameter

        @ThingworxExtensionApiMethod(since={6,6})
        public void SetNumberAlertParameter(java.lang.String property,
                                                                                      java.lang.String alertName,
                                                                                      java.lang.String parameterName,
                                                                                      java.lang.Double value,
                                                                                      java.lang.Boolean persistent)
                                                                               throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetNumberAlertParameter

        @ThingworxExtensionApiMethod(since={6,6})
        public java.lang.Double GetNumberAlertParameter(java.lang.String property,
                                                                                                  java.lang.String alertName,
                                                                                                  java.lang.String parameterName)
                                                                                           throws java.lang.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:
        java.lang.Exception - If an error occurs
      • SetIntegerAlertParameter

        @ThingworxExtensionApiMethod(since={6,6})
        public void SetIntegerAlertParameter(java.lang.String property,
                                                                                       java.lang.String alertName,
                                                                                       java.lang.String parameterName,
                                                                                       java.lang.Integer value,
                                                                                       java.lang.Boolean persistent)
                                                                                throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetIntegerAlertParameter

        @ThingworxExtensionApiMethod(since={6,6})
        public java.lang.Integer GetIntegerAlertParameter(java.lang.String property,
                                                                                                    java.lang.String alertName,
                                                                                                    java.lang.String parameterName)
                                                                                             throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetLongAlertParameter

        @ThingworxExtensionApiMethod(since={6,6})
        public java.lang.Long GetLongAlertParameter(java.lang.String property,
                                                                                              java.lang.String alertName,
                                                                                              java.lang.String parameterName)
                                                                                       throws java.lang.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 - LONG
        Throws:
        java.lang.Exception - If an error occurs
      • SetBooleanAlertParameter

        @ThingworxExtensionApiMethod(since={6,6})
        public void SetBooleanAlertParameter(java.lang.String property,
                                                                                       java.lang.String alertName,
                                                                                       java.lang.String parameterName,
                                                                                       java.lang.Boolean value,
                                                                                       java.lang.Boolean persistent)
                                                                                throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetBooleanAlertParameter

        @ThingworxExtensionApiMethod(since={6,6})
        public java.lang.Boolean GetBooleanAlertParameter(java.lang.String property,
                                                                                                    java.lang.String alertName,
                                                                                                    java.lang.String parameterName)
                                                                                             throws java.lang.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:
        java.lang.Exception - If an error occurs
      • SetDateTimeAlertParameter

        @ThingworxExtensionApiMethod(since={6,6})
        public void SetDateTimeAlertParameter(java.lang.String property,
                                                                                        java.lang.String alertName,
                                                                                        java.lang.String parameterName,
                                                                                        org.joda.time.DateTime value,
                                                                                        java.lang.Boolean persistent)
                                                                                 throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetDateTimeAlertParameter

        @ThingworxExtensionApiMethod(since={6,6})
        public org.joda.time.DateTime GetDateTimeAlertParameter(java.lang.String property,
                                                                                                          java.lang.String alertName,
                                                                                                          java.lang.String parameterName)
                                                                                                   throws java.lang.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:
        java.lang.Exception - If an error occurs
      • SetLocationAlertParameter

        @ThingworxExtensionApiMethod(since={6,6})
        public void SetLocationAlertParameter(java.lang.String property,
                                                                                        java.lang.String alertName,
                                                                                        java.lang.String parameterName,
                                                                                        Location value,
                                                                                        java.lang.Boolean persistent)
                                                                                 throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetLocationAlertParameter

        @ThingworxExtensionApiMethod(since={6,6})
        public Location GetLocationAlertParameter(java.lang.String property,
                                                                                            java.lang.String alertName,
                                                                                            java.lang.String parameterName)
                                                                                     throws java.lang.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:
        java.lang.Exception - If an error occurs
      • SetStringAlertParameter

        @ThingworxExtensionApiMethod(since={6,6})
        public void SetStringAlertParameter(java.lang.String property,
                                                                                      java.lang.String alertName,
                                                                                      java.lang.String parameterName,
                                                                                      java.lang.String value,
                                                                                      java.lang.Boolean persistent)
                                                                               throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetLocalPropertyBinding

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetLocalPropertyBinding(java.lang.String propertyName)
                                                                                    throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetEffectiveLocalPropertyBinding

        @ThingworxExtensionApiMethod(since={7,3})
        public InfoTable GetEffectiveLocalPropertyBinding(java.lang.String propertyName)
                                                                                             throws java.lang.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:
        java.lang.Exception
      • GetEffectiveLocalPropertyBindings

        @ThingworxExtensionApiMethod(since={7,3})
        public InfoTable GetEffectiveLocalPropertyBindings()
                                                                                              throws java.lang.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:
        java.lang.Exception
      • RemoveLocalPropertyBinding

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

        @ThingworxExtensionApiMethod(since={8,1,0})
        public void SetLocalPropertyBinding(java.lang.String propertyName,
                                                                                        java.lang.String sourceThingName,
                                                                                        java.lang.String sourcePropertyName,
                                                                                        org.json.JSONObject aspects)
                                                                                 throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetRemotePropertyBinding

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetRemotePropertyBinding(java.lang.String propertyName)
                                                                                     throws java.lang.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:
        java.lang.Exception - If an error occurs
      • RemoveRemotePropertyBinding

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

        @ThingworxExtensionApiMethod(since={8,0})
        public void SetRemotePropertyBinding(java.lang.String propertyName,
                                                                                       java.lang.String sourcePropertyName,
                                                                                       java.lang.Integer timeout,
                                                                                       java.lang.String pushType,
                                                                                       java.lang.Double pushThreshold,
                                                                                       org.json.JSONObject aspects,
                                                                                       java.lang.Integer cacheTime,
                                                                                       java.lang.String foldType)
                                                                                throws java.lang.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 - INTEGER
        foldType - How a remote property's value should be handled by the server when a connection is lost - STRING
        Throws:
        java.lang.Exception - If an error occurs
      • GetRemoteServiceBinding

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetRemoteServiceBinding(java.lang.String serviceName)
                                                                                    throws java.lang.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:
        java.lang.Exception - If an error occurs
      • RemoveRemoteServiceBinding

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

        @ThingworxExtensionApiMethod(since={6,6})
        public void SetRemoteServiceBinding(java.lang.String serviceName,
                                                                                      java.lang.String sourceServiceName,
                                                                                      java.lang.Integer timeout)
                                                                               throws java.lang.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:
        java.lang.Exception - If an error occurs
      • GetRemoteEventBinding

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetRemoteEventBinding(java.lang.String eventName)
                                                                                  throws java.lang.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:
        java.lang.Exception - If an error occurs
      • RemoveRemoteEventBinding

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

        @ThingworxExtensionApiMethod(since={6,6})
        public void SetRemoteEventBinding(java.lang.String eventName,
                                                                                    java.lang.String sourceEventName)
                                                                             throws java.lang.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:
        java.lang.Exception - If an error occurs
      • AddInstanceRunTimePermission

        @ThingworxExtensionApiMethod(since={6,6})
        public void AddInstanceRunTimePermission(java.lang.String type,
                                                                                           java.lang.String resource,
                                                                                           java.lang.String principal,
                                                                                           java.lang.String principalType,
                                                                                           java.lang.Boolean allow)
                                                                                    throws java.lang.Exception
        Service Category:
        Permissions
        Service Description:
        Add an instance run time permission.
        Parameters:
        type - Permission type (PropertyRead PropertyWrite ServiceInvoke EventInvoke EventSubscribe) - STRING
        resource - Resource name (* = all or enter a specific resource to override) - STRING
        principal - Principal name (name of user or group) - STRING
        principalType - Principal type (User or Group) - STRING
        allow - Permission (true = allow, false = deny) - BOOLEAN
        Throws:
        java.lang.Exception - If an error occurs
      • DeleteInstanceRunTimePermission

        @ThingworxExtensionApiMethod(since={6,6})
        public void DeleteInstanceRunTimePermission(java.lang.String type,
                                                                                              java.lang.String resource,
                                                                                              java.lang.String principal,
                                                                                              java.lang.String principalType)
                                                                                       throws java.lang.Exception
        Service Category:
        Permissions
        Service Description:
        Delete an instance run time permission.
        Parameters:
        type - Permission type - STRING
        resource - Resource name - STRING
        principal - Principal name (name of user or group) - STRING
        principalType - Principal type (User or Group) - STRING
        Throws:
        java.lang.Exception - If an error occurs
      • GetInstanceRunTimePermissions

        @ThingworxExtensionApiMethod(since={6,6})
        public InfoTable GetInstanceRunTimePermissions()
                                                                                          throws java.lang.Exception
        Service Category:
        Permissions
        Service Description:
        Get a list of assigned instance runtime permissions.
        Returns:
        result Permission list - INFOTABLE - Aspects {dataShape:Permissions}
        Throws:
        java.lang.Exception - If an error occurs
      • GetInstanceRunTimePermissionsAsJSON

        @ThingworxExtensionApiMethod(since={6,6})
        public org.json.JSONObject GetInstanceRunTimePermissionsAsJSON()
                                                                                                          throws java.lang.Exception
        Service Category:
        Permissions
        Service Description:
        Get a list of assigned runtime permissions.
        Returns:
        result Permission list - JSON
        Throws:
        java.lang.Exception - If an error occurs
      • SetInstanceRunTimePermissionsAsJSON

        @ThingworxExtensionApiMethod(since={6,6})
        public void SetInstanceRunTimePermissionsAsJSON(org.json.JSONObject permissions)
                                                                                           throws java.lang.Exception
        Service Category:
        Permissions
        Service Description:
        Set a list of assigned runtime permissions.
        Parameters:
        permissions - Permissions in JSON format - JSON
        Throws:
        java.lang.Exception - If an error occurs