Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.RobinHuisman
	1	+XWiki.RoelofZwaan

Content

...	...	@@ -16,32 +16,6 @@
16	16	(((
17	17	(% class="col-xs-12 col-sm-8" %)
18	18	(((
19		-== Changelog ==
20		-
21		-=== Update 2022-08-23 ===
22		-
23		-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.
24		-
25		-| |**URL**|
26		-|**Old**|{{code language="none"}}https://web.terraindex.com/DataWS/{{/code}}|(((
27		-[[https:~~/~~/web.terraindex.com/DataWS/ITWDataRestService_V1_0/GetProjectsJSON>>https://web.terraindex.com/DataWS/ITWDataRestService_V1_0/GetProjectsJSON]]
28		-
29		-[[https:~~/~~/web.terraindex.com/DataWS/ITWImportExportServiceASMX_V1_0.asmx>>https://web.terraindex.com/DataWSExternals/ITWImportExportServiceASMX_V1_0.asmx]]
30		-)))
31		-|**New**|​{{code language="none"}}https://web.terraindex.com/DataWSExternals/{{/code}}|(((
32		-[[https:~~/~~/web.terraindex.com/DataWSExternals/ITWDataRestService_V1_0/GetProjectsJSON>>https://web.terraindex.com/DataWSExternals/ITWDataRestService_V1_0/GetProjectsJSON]]
33		-
34		-[[https:~~/~~/web.terraindex.com/DataWSExternals/ITWImportExportServiceASMX_V1_0.asmx>>url:https://web.terraindex.com/DataWS/ITWImportExportServiceASMX_V1_0.asmx?wsdl]]
35		-)))
36		-
37		-== ==
38		-
39		-{{info}}
40		-This url also works; [[https:~~/~~/web.terraindex.com/DataWSExternals/ITWImportExportServiceASMX_V1_0.asmx?wsdl>>url:https://web.terraindex.com/DataWS/ITWImportExportServiceASMX_V1_0.asmx?wsdl]]
41		-\\We have updated our webservices from .asmx also to .svc, we recommend you to use the .svc version because it's safer and better.
42		-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.
43		-{{/info}}
44		-
45	45	== 1. Retreive all changed project from TerraIndex ==
46	46
47	47	To retreive all changed project from the TerraIndex database since a specific timestamp, there is a webservice call you can do. This will return all project rows that have changes since the timestamp you send within the request.
...	...	@@ -48,7 +48,7 @@
48	48	This way you only download projects that have changes, and it will not request project that are not needed, so it won’t keep our servers busy with exports that are not necessary.
49	49
50	50	To start connecting this webservice, you should use this URL:
51		-[[https:~~/~~/web.terraindex.com/DataWSExternals/ITWDataRestService_V1_0/GetProjectsJSON>>https://web.terraindex.com/DataWSExternals/ITWDataRestService_V1_0/GetProjectsJSON]]
	25	+[[https:~~/~~/web.terraindex.com/DataWS/ITWDataRestService_V1_0/GetProjectsJSON>>url:https://web.terraindex.com/DataWS/ITWDataRestService_V1_0/GetProjectsJSON]]
52	52
53	53	Fill the **Body **of a **POST **HTTP call with:
54	54
...	...	@@ -62,7 +62,7 @@
62	62	"Language": "en"
63	63	},
64	64	"LanguageCode": "en",
65		- "WebserviceVersion": "1.0",
	39	+ "WebserviceVersion": 1,
66	66	"SearchFilter": "",
67	67	"ArchiveID": 0,
68	68	"PageSize": 30,
...	...	@@ -266,10 +266,9 @@
266	266	To request the export from TerraIndex we have a SOAP webservice. This webservice is called the ExportService, and it will provide a full project in TerraIndex Format.
267	267	The format of the projectfile is documentated here: [[Documentation TerraIndex Export format - dsFieldProject.xsd>>Implementation documentation.Documentation TerraIndex Export format - dsFieldProject\.xsd.WebHome]]
268	268
269		-To start connecting this webservice, you should use this URL of the Import Export Webservice:
	243	+To start connecting this webservice, you should use this URL of the Import Export Webservice:
	244	+[[https:~~/~~/web.terraindex.com/DataWS/ITWImportExportServiceASMX_V1_0.asmx>>url:https://web.terraindex.com/DataWS/ITWImportExportServiceASMX_V1_0.asmx]]
270	270
271		-[[https:~~/~~/web.terraindex.com/DataWSExternals/ITWImportExportService_V1_0.svc>>https://web.terraindex.com/DataWSExternals/ITWImportExportService_V1_0.svc]]
272		-
273	273	With this URL many IDE’s can create a proxy for you, just by providing the URL. Once this proxy is created, you will have a few classes looking like the call in the image below.
274	274
275	275	[[image:image-20200108-123431.png]]
...	...	@@ -283,15 +283,12 @@
283	283	Also fill the license and the applicationCode. //(These two fields can be requested at the TerraIndex Servicedesk.)//
284	284	5; Fill the **ExportType **'**Export_FIELD_XML_v1_0_0**’. This export corresponds with dsFieldProject.xsd and is the best XML to connect TI with.
285	285	Create at least create 2 parameters as in the image. Beacause 2 parameters are needed.
286		-//If JSON is prevered use: ExportType = 'Export_FIELD_JSON_v1_0_0'//
287	287	6; Fill the parameter with the FileName.
288	288	7; Fill the parameter with **projectID**. Instead of ‘ProjectID' it’s also possible to fill the parameter ‘ProjectCode'.
289	289	8; Send the request and wait for the reponse. In response field ‘ResultCode’ should be 'SUCCES’ when it all went OK. If not it will tell what went wrong.
290	290	9; The response field 'Filecontent’is filled if it went OK, and it contains XML you can serialize.
291		-10; an extra parameter is added calles: **UseZipStream**. The result data is default Base64 encoded, if you add UseZipStream = true, the result string is GZIPSTREAMED Base64 encoded. **At the end of this page, we have added an class as code, to parse the base64 or ZIPStream Base64 to a normal string.**
292		-*Username and password are known by each TI user and the application manager of your company can create new usernames.
	263	+\\*Username and password are known by each TI user and the application manager of your company can create new usernames.
293	293
294		-
295	295	**EXAMPLE CODE**
296	296
297	297	ExportType:
...	...	@@ -337,7 +337,7 @@
337	337	<soapenv:Envelope
338	338	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
339	339	xmlns:itw="https://wsterraindex.terraindex.com/ITWorks.TerraIndex/">
340		- <soapenv:Header></soapenv:Header>
	310	+ <soapenv:Header/>
341	341	<soapenv:Body>
342	342	<itw:Export>
343	343	<itw:request>