WebserviceCOM

In order to use the Webservice, you have first to configure it in the ConfigurationCOM menu in the portal in the distant tab. This configuration is unique to the environment, and cannot be reused in another environment.

22

23

24

[[image:1667487553991-372.png]]

25

26

27

There are so many parameters to configure for the WebService connector:

28

29

(((

30

* __**Name**__: The name of the distant Webservice used

31

* __**IP/host**__: The domain name of the servor or the IP address used

32

* __**URI**__: The path in the IP/host used to send the files

33

* __**Method**__: signifies the method used to get the data( GET, POST, PUT, DELETE)

34

* __**Port**__: The port of the listening

35

* __**Protocol**__: HTTP ou HTTPS

36

* __**Authentification Mode**__: There is 2 different ways for the authentification mode

37

38

1. __**Basic**__: is a mode that needs 3 attributes(**header**: the header'name, **user **encoded in base64, **password **encoded in base64)

39

1. __**Token**__: is a mode that consists on putting a token in the header. This mode uses 2 parameters: The **header** and the **token** is an encoded and encrypted data with a unique key using the HASHMAC algorithm.

40

41

* __**Timeout**__: is the max time acceptable to connect to the WS and get the result.

42

* __**Charset**__: is the encodage of the json file that will be sent to WS and of the result file

43

44

* (((

45

===== **Configuring the Webservice connector in the scenario:** =====

46

)))

47

48

Second, you have to configure the connector in the Scenario menu.

49

50

[[image:1667492134946-717.png]]

51

52

53

For this configuration, you have to fill these parameters:

54

55

* __**Destinataire**__: The environment where the distant configuration exists

56

* __**Config**__: The name of the distant configuration in the chosen environment

57

* __**Dyn.enveloppe**__: is a Yes or No value that mentions if the enveloppe is dynamic

58

* __**Enveloppe**__:if the enveloppe is not dynamic, this parameter is for uploading the file of the enveloppe or the connector's name that contains the file for the enveloppe.

59

* __**Data**__:the connector's name ythat contains the data

60

* __**Output FileName**__: The output file name

61

62

==== __**Elements of the WS:**__ ====

63

64

* (((

65

====== __**The enveloppe:**__ ======

66

67

It contains the enveloppe of the informations that will be transferred to the WS.

68

69

The enveloppe can be linked to the message data in this way.

70

71

* **%DATA%** : Le content of the file mentionned in the parameter DATA will the same in the message

72

* **%DATA64%** : the message file linked to DATA will be encoded in base 64 and inserted

73

* **%DATAZIP%** : the message file linked to DATA will be zipped and inserted

74

* **%DATAZIP64%** : the message file linked to DATA will be encoded in base 64 and zipped then inserted

75

76

__**Note**__: The enveloppe may be:

77

78

* uploaded in the enveloppe parameter of the WS as a file or as a connector name that contains the file

79

* inserted with a reference to the message

)))

* (((

====== __**The message:**__ ======

85

86

It contains the content of the message that will be transferred to the WS, it will be inserted inside the enveloppe of the connector. The message can be uploaded dynamically using the elements of the scenario or can be fixed and uploaded inside the WS connector.

)))

)))

==== __**Example:**__ ====

* **Scenario:**