|
With upgrades to the Remote Access Extension (RAE) v.3.0.0 and Axeda Compatibility Extension (ACE) v.5.0.0, the Axeda.RemoteAccessible Thing Shape is no longer necessary, so it has been migrated into the RAE GASRemoteAccessible Thing Shape. The RemoteAccessible Thing Shape contains the information needed for all remote sessions (GAS and Tunnel) while GASRemoteAccessible contains only the additional information needed for GAS.
|
Service Name | Description | Parameters | ||
---|---|---|---|---|
ConnectToSession | Tells the platform to prepare a remote session for this Thing and passes in the parameters for the session that will be started. The result of this service is the unique identifier of the session that is created. The base type of the result is GUID. | REQUIRED. parameters, of base type INFOTABLE, which implements the RemoteSessionParameters Data Shape. | ||
EndSession | Terminates the session associated with the provided session identifier. | REQUIRED. sessionId, which is he unique identifier (ID) of the session that is to be terminated. The base type of this parameter is GUID. | ||
GetSession | Retrieves the session that matches the specified sessionId for this Thing. The result of this service is the information about the remote session that matches the given session ID, returned as an INFOTABLE. The result implements the RemoteSession Data Shape.. | REQUIRED. sessionID. which is the unique identifier of the session whose information you want to retrieve. | ||
GetSessions | Returns all current remote sessions on this RemoteAccessible Thing. It does not return past remote sessions or sessions that have failed. If a remote session has failed, then it was terminated. Terminated sessions are removed from the storage of the Remote Access Subsystem The result is an INFOTABLE of the remote sessions for this Thing. | None | ||
HandleSessionUpdate | Called when the session for this Thing is updated. The isAllowOverride setting for this service is true. As of v.3.1.0 of the RAE, this service calls ConnectToSession with the session and GAS configuration information.
| REQUIRED. sessionEvent, which contains the information for the session that has been updated, inherited from the RemoteSessionEvent Data Shape. | ||
AssignEndpoints | Assigns remote endpoints to this Thing. Its result is of base type INFOTABLE, which contains values for the properties of the RemoteEndpoint Data Shape. | |||
ProcessRemoteServerUpdate | Updates the property row in the INFOTABLE of the Thing Shape, using each endpointName as the key. This service also sets the configuration for the remote server. No result is returned. | REQUIRED: endpointName (a STRING) and serverConfiguration (base type JSON). | ||
GetRemoteServerConfiguration | Retrieves the remote server configuration for the specified endpoint for this Thing. The result is JSON-formatted configuration information. | REQUIRED: endpointName (a STRING) |
Event | Description |
---|---|
SessionCompleted | This event is fired when a remote session for this Thing is completed. This event is recorded in the Audit Subsystem of ThingWorx Platform. The Audit category for this event is RemoteAccess. To search for SessionCreated events, specify the Audit category, REMOTE_ACCESS. The Audit message key is audit.rae.SessionCompleted. |
SessionCreated | This event is fired when a session for this Thing is created. This event is recorded in the Audit Subsystem of ThingWorx Platform.. The Audit category for this event is RemoteAccess. To search for SessionCreated events, specify the Audit category, REMOTE_ACCESS. The Audit message key is audit.rae.SessionCreated. For more information, see the "Audit Subsystem" section in the ThingWorx Platform Help Center for your ThingWorx version, available from the ThingWorx Help Centers landing page. |
SessionUpdated | This event is fired when a session for this Thing is updated. This event is not recorded in the Audit Subsystem. The Data Shape that defines the event is the RemoteSessionEvent Data Shape. |