Skip navigation links
Thingworx Platform API
8.5.0
com.thingworx.things.connected

Class RemoteThing

    • Field Detail

      • STORE_AND_FORWARD_IS_NOT_ENABLED

        public static final java.lang.String STORE_AND_FORWARD_IS_NOT_ENABLED
        See Also:
        Constant Field Values

    • Constructor Detail

      • RemoteThing

        public RemoteThing()

    • Method Detail

      • initializeThing

        @ThingworxExtensionApiMethod(since={7,4},
                             canOverride=true,
                             requiresSuper=true)
public void initializeThing()
                                                                                                                                                               throws java.lang.Exception
        Description copied from class: Thing


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

        Overrides:
        initializeThing in class Thing
        Throws:
        java.lang.Exception - If an error occurs

      • startThing

        @ThingworxExtensionApiMethod(since={7,4},
                             canOverride=true,
                             requiresSuper=true)
protected final void startThing()
                                                                                                                                                                   throws java.lang.Exception
        Description copied from class: Thing


        A startup hook for subclasses of Thing.

        Overrides:
        startThing in class Thing
        Throws:
        java.lang.Exception - If an error occurs

        Starts the RemoteThing by binding to the endpoint registered to it.

      • stopThing

        @ThingworxExtensionApiMethod(since={7,4},
                             canOverride=true,
                             requiresSuper=true)
protected final void stopThing()
                                                                                                                                                                  throws java.lang.Exception
        Description copied from class: Thing


        A shutdown hook for subclasses of Thing.

        Overrides:
        stopThing in class Thing
        Throws:
        java.lang.Exception - If an error occurs

        Stops the RemoteThing by disconnecting from its configured endpoint.

      • executeRemoteService

        @ThingworxExtensionApiMethod(since={7,4})
public InfoTable executeRemoteService(ServiceDefinition def,
                                                                                ValueCollection params,
                                                                                boolean isPrivate)
                                                                         throws java.lang.Exception


        Execute the RemoteService.
        Parameters:
        def - The ServiceDefinition of the RemoteService to be called.
        params - The parameters for the RemoteService to be called.
        isPrivate - (ignored)
        Returns:
        The execution result of the RemoteService call.
        Throws:
        CouldNotConnectException - If the Thing is not connected, but the service invocation can be queued.
        EdgeControlledEgressQuotaException - If the EdgeControlled Thing lacks egress quota to send the service invocation. Queueable service invocations will be queued if possible.
        MessageStoreFullException - If the MessageStore for this Thing is full and cannot accept the service.
        java.lang.Exception - is thrown if the service invocation was unable to be called for another reason.

      • GetRemoteMetadata

        @ThingworxExtensionApiMethod(since={7,4})
public org.json.JSONObject GetRemoteMetadata()
                                                                                throws java.lang.Exception
        Service Category:
        Metadata
        Service Description:
        Return the metadata for the connected thing.
        Returns:
        result Connected Thing metadata - JSON
        Throws:
        java.lang.Exception - If an error occurs

      • UpdateSubscribedPropertyValues

        @ThingworxExtensionApiMethod(since={7,4})
public void UpdateSubscribedPropertyValues(InfoTable values)
                                                                              throws java.lang.Exception
        Service Category:
        Updates
        Service Description:
        Write subscribed property values for a connected thing.
        Parameters:
        values - Collection of properties to be updated - INFOTABLE
        Throws:
        java.lang.Exception - If an error occurs

      • ProcessRemoteEvents

        @ThingworxExtensionApiMethod(since={7,4})
public void ProcessRemoteEvents(InfoTable values)
                                                                   throws java.lang.Exception
        Service Category:
        Updates
        Service Description:
        Process remote events.
        Parameters:
        values - Collection of events to be dispatched - INFOTABLE
        Throws:
        java.lang.Exception - If an error occurs

      • GetPropertySubscriptions

        @ThingworxExtensionApiMethod(since={8,0})
public InfoTable GetPropertySubscriptions(org.json.JSONObject options)
                                                                             throws java.lang.Exception
        Service Category:
        Metadata
        Service Description:
        Get the properties plus data change type and data change threshold for the edge Thing.
        Parameters:
        options - Binding options supported by the calling SDK - JSON
        Returns:
        result The subscribed properties for the Remote Thing - INFOTABLE - Aspects {dataShape:EdgeThingPropertyNotification}
        Throws:
        java.lang.Exception - If an error occurs

      • GetEventSubscriptions

        @ThingworxExtensionApiMethod(since={7,4})
public InfoTable GetEventSubscriptions()
                                                                          throws java.lang.Exception
        Service Category:
        Metadata
        Service Description:
        Get the events that are bound to the remote Thing.
        Returns:
        result The subscribed events for the Remote Thing - INFOTABLE - Aspects {dataShape:EdgeThingEventNotification}
        Throws:
        java.lang.Exception - If an error occurs

      • SendQueuedTasks

        @ThingworxExtensionApiMethod(since={7,4})
public void SendQueuedTasks()
                                                               throws java.lang.Exception
        Service Category:
        Queueing
        Service Description:
        Sends any queued tasks to the connected thing.
        Throws:
        java.lang.Exception - If an error occurs

      • SendMaxQueuedTasks

        @ThingworxExtensionApiMethod(since={7,4})
public java.lang.Integer SendMaxQueuedTasks(java.lang.Integer maxCount)
                                                                               throws java.lang.Exception
        Service Category:
        Queueing
        Service Description:
        Sends up to a specific maximum number of queued tasks to the connected thing.
        Parameters:
        maxCount - The maximum number of messages desired by the edge device. - INTEGER
        Returns:
        result The number of queued tasks sent, up to maxCount. - INTEGER
        Throws:
        java.lang.Exception - If an error occurs

      • GetQueuedTasks

        @ThingworxExtensionApiMethod(since={7,4})
public InfoTable GetQueuedTasks()
                                                                   throws java.lang.Exception
        Service Category:
        Queueing
        Service Description:
        Retrieve any tasks for this connected thing.
        Returns:
        result Edge things - INFOTABLE - Aspects {dataShape:MessageStoreList}
        Throws:
        java.lang.Exception - If an error occurs

      • AddDynamicRemoteSubscription

        @ThingworxExtensionApiMethod(since={7,4})
public void AddDynamicRemoteSubscription(java.lang.String thingName,
                                                                                   java.lang.String eventName,
                                                                                   java.lang.String propertyName,
                                                                                   java.lang.String serviceName)
                                                                            throws java.lang.Exception
        Parameters:
        thingName - Thing name - THINGNAME
        eventName - Event name - STRING
        propertyName - Property name - STRING
        serviceName - Remote service name - STRING
        Throws:
        java.lang.Exception - If an error occurs

      • RemoveDynamicRemoteSubscription

        @ThingworxExtensionApiMethod(since={7,4})
public void RemoveDynamicRemoteSubscription(java.lang.String thingName,
                                                                                      java.lang.String eventName,
                                                                                      java.lang.String propertyName)
                                                                               throws java.lang.Exception
        Parameters:
        thingName - Thing name - THINGNAME
        eventName - Event name - STRING
        propertyName - Property name - STRING
        Throws:
        java.lang.Exception - If an error occurs
Skip navigation links
Thingworx Platform API
8.5.0