Changes for page Download a project (export)

Last modified by Nico Lemaire on 2025/09/01 13:36

From 6.6 to 6.5 From 15.5 to 15.4

From version 15.4

edited by Robert Jan Daams
on 2025/03/05 18:01

Change comment: There is no comment for this version

To version 6.6

edited by Robert Jan Daams
on 2022/08/23 11:18

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (3 modified, 0 added, 0 removed)

Details

Page properties

Title

@@ -1,1 +1,1 @@
--Download a project (export)
++Setting up a Webservice connection for project exports

Parent

@@ -1,1 +1,1 @@
--Implementation documentation.For customers.WebHome
++Implementation documentation.WebHome

Content

@@ -25,27 +25,13 @@
  | |**URL**|
  |**Old**|{{code language="none"}}https://web.terraindex.com/DataWS/{{/code}}|(((
  [[https:~~/~~/web.terraindex.com/DataWS/ITWDataRestService_V1_0/GetProjectsJSON>>https://web.terraindex.com/DataWS/ITWDataRestService_V1_0/GetProjectsJSON]]
--
--[[https:~~/~~/web.terraindex.com/DataWS/ITWImportExportServiceASMX_V1_0.asmx>>https://web.terraindex.com/DataWSExternals/ITWImportExportServiceASMX_V1_0.asmx]]
  )))
  |**New**|{{code language="none"}}https://web.terraindex.com/DataWSExternals/{{/code}}|(((
  [[https:~~/~~/web.terraindex.com/DataWSExternals/ITWDataRestService_V1_0/GetProjectsJSON>>https://web.terraindex.com/DataWSExternals/ITWDataRestService_V1_0/GetProjectsJSON]]
--
--[[https:~~/~~/web.terraindex.com/DataWSExternals/ITWImportExportServiceASMX_V1_0.asmx>>https://web.terraindex.com/DataWSExternals/ITWImportExportServiceASMX_V1_0.asmx?wsdl]]
  )))
  ==  ==
--{{info}}
--We also have new REST Calls, with the same Input Output formats:
--\\[[https:~~/~~/web.terraindex.com/datawsExternals/ITWImportExportRestService_V1_0/export>>https://web.terraindex.com/datawsExternals/ITWImportExportRestService_V1_0/export]]
--
--input as json: ExportRequest
--output as json: ExportResult
--
--as  POST  or   GET
--{{/info}}
--
  == 1. Retreive all changed project from TerraIndex ==
  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.
@@ -268,12 +268,11 @@
  == 2. Retreive the project export from TerraIndex ==
  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.
--The format of the projectfile is documentated here: [[Documentation TerraIndex Export format - dsFieldProject.xsd>>Implementation documentation.For customers.Documentation TerraIndex Export format - dsFieldProject\.xsd.WebHome]]
++The format of the projectfile is documentated here: [[Documentation TerraIndex Export format - dsFieldProject.xsd>>Implementation documentation.Documentation TerraIndex Export format - dsFieldProject\.xsd.WebHome]]
--To start connecting this webservice, you should use this URL of the Import Export Webservice:
++To start connecting this webservice, you should use this URL of the Import Export Webservice:
++[[https:~~/~~/web.terraindex.com/DataWSExternals/ITWImportExportServiceASMX_V1_0.asmx>>https://web.terraindex.com/DataWSExternals/ITWImportExportServiceASMX_V1_0.asmx]]
--[[https:~~/~~/web.terraindex.com/DataWSExternals/ITWImportExportService_V1_0.svc>>https://web.terraindex.com/DataWSExternals/ITWImportExportService_V1_0.svc]]
--
  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.
  [[image:image-20200108-123431.png]]
@@ -408,7 +408,137 @@
  </soap:Envelope>
  {{/code}}
--
++
++== Zip Stream class ==
++
++If needed, this is the Zip Stream class you can use to extract the zipstream as used above:
++
++{{code language="Csharp" layout="LINENUMBERS"}}
++/// <summary>
++/// Helper class for compress en decompress of file data
++/// </summary>
++public static class ZipStreamHelper {
++  #region Compress and encode
++  /// <summary>
++  /// Comprimeer een string en geeft deze terug in Base64 string.
++  /// </summary>
++  /// <param name="content">filecontent</param>
++  /// <returns>gecomprimeerde string</returns>
++  public static string CompressToBase64String(string content) {
++    //string to byte[]
++    byte[] contentArray = stringToByteArray(content);
++    // Compress
++    byte[] compressed = Compress(contentArray);
++    return base64_encode(compressed);
++  }
++
++  /// <summary>
++  /// Zet een string om naar een ByteArray
++  /// </summary>
++  /// <param name="content">filecontent</param>
++  /// <returns>ByteArray</returns>
++  public static byte[] stringToByteArray(string content) {
++    System.Text.UTF8Encoding encoding = new System.Text.UTF8Encoding();
++    return encoding.GetBytes(content);
++  }
++
++  /// <summary>
++  /// comprimeer een ByteArray
++  /// </summary>
++  /// <param name="data">filedata als ByteArray</param>
++  /// <returns>gecomprimeerde ByteArray</returns>
++  public static byte[] Compress(byte[] data) {
++    using(var compressedStream = new MemoryStream())
++    using(var zipStream = new GZipStream(compressedStream, CompressionMode.Compress)) {
++      zipStream.Write(data, 0, data.Length);
++      zipStream.Close();
++      return compressedStream.ToArray();
++    }
++  }
++
++  /// <summary>
++  /// Zet een ByteArray om naar een Base64 string
++  /// </summary>
++  /// <param name="data">gecomprimeerde ByteArray</param>
++  /// <returns>Base 64 string</returns>
++  public static string base64_encode(byte[] data) {
++    if (data == null)
++      return string.Empty;
++    return Convert.ToBase64String(data);
++  }
++
++  /// <summary>
++  /// Zet een string om naar een Base64 string
++  /// </summary>
++  /// <param name="data">string</param>
++  /// <returns>Base 64 string</returns>
++  public static string string_base64_encode(string data) {
++    if (string.IsNullOrEmpty(data))
++      return string.Empty;
++
++    //string to byte[]
++    byte[] contentArray = stringToByteArray(data);
++    return base64_encode(contentArray);
++  }
++  #endregion
++
++  #region Decompress and decode
++  // Decode and decompress
++  /// <summary>
++  /// Decomprimeer een Base64 string naar een string
++  /// </summary>
++  /// <param name="contentBase64">GZIP Base64 string</param>
++  /// <returns>string</returns>
++  public static string DecompressBase64StringToString(string contentBase64) {
++    // Decompress
++    byte[] decoded = base64_decode(contentBase64);
++    byte[] decompressed = Decompress(decoded);
++
++    return byteArrayTostring(decompressed);
++  }
++
++  /// <summary>
++  /// Zet een ByteArray om in een normale string
++  /// </summary>
++  /// <param name="data">ByteArray</param>
++  /// <returns>string</returns>
++  public static string byteArrayTostring(byte[] data) {
++    System.Text.UTF8Encoding enc = new System.Text.UTF8Encoding();
++    return enc.GetString(data);
++  }
++
++  /// <summary>
++  /// Zet een Base64 string om naar een ByteArray
++  /// </summary>
++  /// <param name="encodedData">Base64 string</param>
++  /// <returns>gecomprimeerde ByteArray</returns>
++  public static byte[] base64_decode(string encodedData) {
++    byte[] encodedDataAsBytes = Convert.FromBase64String(encodedData);
++    return encodedDataAsBytes;
++  }
++
++  /// <summary>
++  /// Zet een gecomprimeerde ByteArray om in een ByteArray
++  /// </summary>
++  /// <param name="data">gecomprimeerde ByteArray</param>
++  /// <returns>ByteArray (gedecomprimeerd)</returns>
++  public static byte[] Decompress(byte[] data) {
++    using(var compressedStream = new MemoryStream(data))
++    using(var zipStream = new GZipStream(compressedStream, CompressionMode.Decompress))
++    using(var resultStream = new MemoryStream()) {
++      var buffer = new byte[4096];
++      int read;
++
++      while ((read = zipStream.Read(buffer, 0, buffer.Length)) > 0) {
++        resultStream.Write(buffer, 0, read);
++      }
++
++      return resultStream.ToArray();
++    }
++  }
++  #endregion
++}
++{{/code}}
  )))