DokuWiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

===== CeRTNA Sample Web Service Toolbox Project =====

CeRTNA has uploaded a sample Visual Studio 2015 C# project entitled Web Service Toolbox that provides a high-level demonstration of how to call the CeRTNA web services that are sending and retrieving payloads and checking a transaction status.

**Disclaimer:** This sample project is provided as is for reference purposes only. It is not intended to represent production quality code.

The application demonstrates functions like:

* Logging in to obtain a soft-token for use with the various web services.
  * Obtaining a list of payloads that reside in a remote folder (repository).
  * Locking, unlocking, and deleting a payload from a remote folder (repository).
  * Sending/Retrieving payloads to/from remote folders.
  * Getting a transaction status and transaction history.

The project can be downloaded by clicking this link: ({{guides:web_service_toolbox.zip|Web Service Toolbox}})

The Web ServiceToolbox project uses the following NuGet packages, which you will need to install into your Visual Studio setup, if you do not already have them installed:

* Newtonsoft.Json
  * RestSharp

The project uses the Windows Presentation Foundation (WPF) classes for the UI.

Following is a brief outline of how to use the tool:

After starting the tool, the following UI will be displayed:

To use the tool, the typical order of steps would be:

{{tablelayout?colwidth="200px,400px"&rowsFixed=1&rowsVisible=10&float=center}}
^ Step ^ Comment ^
| Enter User Name & PW | These are special web service user accounts provided to you by CeRTNA. |
| Select/Load an XML file | You can use a REQUEST or RESPONSE file. |
| Enter a Doc Seq# | This identies which Doc Seq# contained in the XML file that you wish to work with. |
| Click the Calculate button | The SHA3 checksum is calculated and displayed in the Base64 Document Checksum field. |
| Click the Store button | The calculated checksum is stored in the CeRTNA Portal and a Checksum Key is returned and displayed in the Base64 Document Checksum Key field. |
| Click the Validate button | The ChecksumKey and Checksum values displayed on the form are used to validate the locally calculated checksum value against the stored value in the database. |
| Click the Reset button | This clears the form fields. |

**Note:** The Checksum Value field is unprotected so that you can modify the checksum value manually to test the negative result of the ValidateChecksum flow.

There are plenty of other tools available for testing web services as well. One of the tools CeRTNA works with is POSTMAN. You can download a free version of POSTMAN from the following URL: https://www.getpostman.com/apps

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International