Last modified by Olivier Roussel on 2025/04/25 09:57
Change comment:
There is no comment for this version
Summary
-
Page properties (3 modified, 0 added, 0 removed)
Details
- Page properties
-
- Parent
-
... ... @@ -1,1 +1,1 @@ 1 -Implementati edcoumentatie.DocumentationTerraIndex Export format - dsFieldProject\.xsd.WebHome1 +Implementation documentation.WebHome - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki.Ro elofZwaan1 +XWiki.RobinHuisman - Content
-
... ... @@ -7,6 +7,26 @@ 7 7 {{toc/}} 8 8 9 9 10 +== Changelog == 11 + 12 +=== Update 2022-08-23 === 13 + 14 +As part of on-going efforts to improve performance and scalability, we have introduced a dedicated version of DataWS named DataWSExternals. This new service should be used for external API consumers. 15 + 16 +| |**URL**|**Example** 17 +|**Old**|{{code language="none"}}https://web.terraindex.com/DataWS/{{/code}}|((( 18 +[[https:~~/~~/web.terraindex.com/DataWS/ITWViewServiceASMX_V1_0.asmx?wsdl>>https://web.terraindex.com/DataWS/ITWViewServiceASMX_V1_0.asmx?wsdl]] 19 +))) 20 +|**New**|{{code language="none"}}https://web.terraindex.com/DataWSExternals/{{/code}}|((( 21 +[[https:~~/~~/web.terraindex.com/DataWSExternals/ITWViewService_V1_0.svc?wsdl>>https://web.terraindex.com/DataWSExternals/ITWViewService_V1_0.svc?wsdl]] 22 +))) 23 + 24 +{{info}} 25 +This url also works; [[https:~~/~~/web.terraindex.com/DataWSExternals/ITWViewServiceASMX_V1_0.asmx?wsdl>>https://web.terraindex.com/DataWSExternals/ITWViewServiceASMX_V1_0.asmx?wsdl]] 26 +\\We have updated our webservices from .asmx also to .svc, we recommend you to use the .svc version because it's safer and better. 27 +The requests and responses are the same, but the envelope might be slightly different. So create new proxy classes when switching from .asmx to .svc.Type your information message here. 28 +{{/info}} 29 + 10 10 == 1. Retreive all overviews queries from TerraIndex == 11 11 12 12 To retreive all available queries from the TerraIndex Environment, there is a SOAP webservice call available. This will return all overview queries with it’s names and the required parameters. ... ... @@ -13,8 +13,9 @@ 13 13 With the name and the parameters you can request the actual data with function 2, explained in the next chapter. 14 14 15 15 To start connecting this webservice, you should use this URL: 16 -[[https:~~/~~/web.terraindex.com/DataWS/ITWViewServiceASMX_V1_0.asmx>>url:https://web.terraindex.com/DataWS/ITWViewServiceASMX_V1_0.asmx]] 17 17 37 +[[https:~~/~~/web.terraindex.com/DataWSExternals/ITWViewServiceASMX_V1_0.asmx>>https://web.terraindex.com/DataWSExternals/ITWViewServiceASMX_V1_0.asmx]] 38 + 18 18 (% class="box infomessage" %) 19 19 ((( 20 20 If you prefer a REST service, please let us know. It’s currently a SOAP webservice because there will be a typed definition available to avoid mistakes. ... ... @@ -21,8 +21,9 @@ 21 21 ))) 22 22 23 23 Get the WSDL from: 24 -[[https:~~/~~/web.terraindex.com/DataWS/ITWViewServiceASMX_V1_0.asmx?wsdl>>url:https://web.terraindex.com/DataWS/ITWViewServiceASMX_V1_0.asmx?wsdl]] 25 25 46 +[[https:~~/~~/web.terraindex.com/DataWSExternals/ITWViewServiceASMX_V1_0.asmx?wsdl>>https://web.terraindex.com/DataWSExternals/ITWViewServiceASMX_V1_0.asmx?wsdl]] 47 + 26 26 [[image:1637574900554-168.png]] 27 27 28 28 ... ... @@ -63,10 +63,9 @@ 63 63 * (% class="mark" %)Licensenumber(%%); as your companies license number 64 64 * (% class="mark" %)ApplicationCode(%%); as provided by TerraIndex to you, if not provided, request one at: [[service@terraindex.com>>path:mailto:service@terraindex.com]] 65 65 * (% class="mark" %)UseZipStreamto (%%)'true', to get GZip data stream. This will be much faster over the internet. 66 -Check here for the Class to use it: [[Setting up a Webservice connection for project exports>>Implementati edcoumentatie.Setting up a Webservice connection for project exports.WebHome]], Chapter: Zip Stream class.88 +Check here for the Class to use it: [[Setting up a Webservice connection for project exports>>Implementation documentation.Setting up a Webservice connection for project exports.WebHome]], Chapter: Zip Stream class. 67 67 * (% class="mark" %)DataType(%%); set the correct data type you would like to receive, this is 'JSON' or 'XML'. 68 68 69 - 70 70 You will receive a response like this: 71 71 72 72 {{code layout="LINENUMBERS"}} ... ... @@ -606,7 +606,7 @@ 606 606 607 607 (% class="box infomessage" %) 608 608 ((( 609 -Is UseZipStream = true; the Content needs to be inflated using the ZipSteamHelper Class. The code can be found here: [[Setting up a Webservice connection for project exports>>Implementati edcoumentatie.Setting up a Webservice connection for project exports.WebHome]]630 +Is UseZipStream = true; the Content needs to be inflated using the ZipSteamHelper Class. The code can be found here: [[Setting up a Webservice connection for project exports>>Implementation documentation.Setting up a Webservice connection for project exports.WebHome]] 610 610 ))) 611 611 612 612 ... ... @@ -661,7 +661,6 @@ 661 661 * (% class="mark" %)DataType(%%); set the correct data type you would like to receive, this is 'JSON' or 'XML'. 662 662 * (% class="mark" %)Param (%%)must be the Array as received from the GetOverviewQueries, and filled with data. Always needs to be JSON. 663 663 664 - 665 665 You will receive a response like this: 666 666 667 667 {{code language="xml" layout="LINENUMBERS"}} ... ... @@ -684,7 +684,7 @@ 684 684 685 685 (% class="box infomessage" %) 686 686 ((( 687 -Is UseZipStream = true; the Content needs to be inflated using the ZipSteamHelper Class. The code can be found here: [[Setting up a Webservice connection for project exports>>Implementati edcoumentatie.Setting up a Webservice connection for project exports.WebHome]]707 +Is UseZipStream = true; the Content needs to be inflated using the ZipSteamHelper Class. The code can be found here: [[Setting up a Webservice connection for project exports>>Implementation documentation.Setting up a Webservice connection for project exports.WebHome]] 688 688 ))) 689 689 690 690