Concerns: Vision/Vision Management Site/Vision Database
User: User Management Site
Description
When performing an action for an App Futurama can log a AppEvents. In this way you can see information in the logging about the status of some processes. Some of this information is also useful for other systems. That’s why Futurama Vision has a webservice to retrieve these AppEvents.
The list of events for an app that are logged is as follows. As you can see, there is currently only one event, more will follow.
| Event |
Code |
EventData |
| Import a dataset into Futurama Register |
20000 |
The name of the dataset that is imported |
Retrieving the AppEvents with a webservice call
Futurama Vision offers a webservice to retrieve the data.
When to use
You can use this webservice to retrieve AppEvents that occured in a Vision installation.
Parameters and request
The URL for the Request is VisionURL/Services/AppEvents.svc where VisionURL is the url of the Vision installation
Below an example of the request of the GetAppEvents method.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.futurama.eu/WebServices/201902">
<soapenv:Header/>
<soapenv:Body>
<ns:GetAppEvents>
<!--Optional:-->
<ns:appID>1</ns:appID>
<!--Optional:-->
<ns:eventCode>20000</ns:eventCode>
<!--Optional:-->
<ns:onlyLastEvent>true</ns:onlyLastEvent>
</ns:GetAppEvents>
</soapenv:Body>
</soapenv:Envelope>
Important to note is to give each member the following information:
appID
The appID is the ID of the App for which you want to retrieve AppEvents. It is optional. If you do not specify an appID, the AppEvents for all Apps will be returned.
eventCode
The eventCode is the ID of the Event for which you want the retrieve AppEvents. It is optional. If you do not specify an eventCode, the AppEvents for all eventCodes will be returned.
onlyLastEvent
true to return only the last event for each appID and eventCode. false to return all events that match the specified appID and eventCode.
The method name for this webservice is http://www.futurama.eu/WebServices/201902/AppEvents. Note: this MethodName is case-sensitive.
Feedback
If you have any questions about this subject or if you want to provide us feedback please send us an e-mail.