Concerns: Vision/Vision Management Site/Vision Database
User: User Management Site
In the chapter Importing data in Futurama Vision three methods of importing data into Futurama Vision are mentioned. One of these methods is to import data using a webservice. In this chapter the different webservices are treated. For this, Futurama Vision offers the webservice ImportUsers.svc. This webservice has four different methods:
Depending on the data that has to be imported the right method can be used. The paragraphs below describe for each method how to use it.
Importing Pre-encrypted XML
Importing pre-encrypted policy XML is possible, but the xml must be encrypted using the right key. To know this key, you’ll have to know to which App you will assign the imported dataset to. See Futurama Vision – Data for more information on Vision encryption.
When to use
In the chapter Importing data in Futurama Vision the required parameters in the importing process are treated. Two of these parameters are the PersonKey and the PolicyKey. In the situation that in the member data the PersonKey is equal to the PolicyKey (each person only has one policy, and the name of the PolicyKey is equal to the name of the PersonKey) the ImportUser method can be used. In case the PersonKey differs from the PolicyKey the ImportUser method cannot be use. Instead the method ImportPolicy (described below) has to be used.
Parameters and request
Below an example of the request of the ImportUser method.
<soapenv:envelope xmlns:ns="http://www.actuIT.nl/WebServices/201009" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
Example import by using the Futurama Editor
It is possible to use the Futurama Editor to import data into Futurama Vision by using one of the four webservices mentioned above.
Download the Futurama Document Example importusers webservice.
After downloading the example follow the next steps:
- Open the Futurama Editor
- Open the example in the Futurama Editor. Note that the example is created in Futurama version 4.3. This means that Futurama version 4.3 or higher has to be used to open the file
In the file a number of Futurama Objects are created:
- the Action 'ImportData': within this Action a reference is created to the WebReference 'Import webservice' (see below). By executing this Action (either manually in the Editor or automatically by batchfile) there willbe a request to the webservice ImportUser.
- the WebReference 'Import webservice': this WebReference does have some properties that need to be filled in. These are the URL to the importusers.svc webservice, the XML input (i.e. the request) and the MethodName. The URL is the same for the 4 methods described above, the MethodName is different for all the methods.
- the XMLBuilder 'ImportUser': select with the left mousebutton this XMLBuilder, and check the Results Window. By using the XMLBuilder it is possible to 'build' the request according to the specifications in the paragraphs 'Parameters and request'.
In this example there is only one request to the webservice. If you have to do more request (for your entire member population), then use the same construction and extend this with a loop at the Action. In that situation a loop has to be created for all the members. Result is a dataset containing all the member data.
If you have any questions about this subject or if you want to provide us feedback please send us an e-mail.