Last modified by Erik Bakker on 2024/08/26 12:38
From version 41.1
edited by Eva Torken
on 2023/06/27 10:26
Change comment: There is no comment for this version
To version 37.1
edited by Erik Bakker
on 2022/12/30 11:21
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.etorken
1 +XWiki.ebakker
Content
... ... @@ -1,8 +1,4 @@
1 1  {{container}}{{container layoutStyle="columns"}}(((
2 -{{warning}}
3 -Please note that this Microlearning is for Gen3.
4 -{{/warning}}
5 -
6 6  When setting up a point at which your customers can talk to you eMagiz offers various methods of creating such a point. One of those options is by hosting a SOAP Webservice in eMagiz that handles XML messages asynchronously or synchronously. In this microlearning, we will learn the basics of this configuration in the various phases of the platform so you can easily set up your SOAP web service.
7 7  
8 8  Should you have any questions, please contact academy@emagiz.com.
... ... @@ -53,10 +53,18 @@
53 53  
54 54  Now that we know what configurations are required, we can see how we can implement this in eMagiz. In the Capture phase, nothing changes. You simply draw a system on the canvas including at least one line that goes from the system towards eMagiz. When you are done you move to the Design phase in eMagiz. In this phase, you need to correctly set up the operation name(s) and the SOAP Webservice Namespace.
55 55  
56 -The configuration in Design starts at the system level. At the system level, you need to define the technical name (or let eMagiz automatically fill it in for you) and select the checkbox called SOAP Entry Connector. By selecting this checkbox you tell eMagiz that you want to host a SOAP endpoint for others to call. After you have done so eMagiz will automatically define the SOAP Webservice Name and SOAP Webservice Namespace.
52 +The configuration in Design starts at the system level. At the system level, you need to define the technical name (or let eMagiz automatically fill it in for you) and select the checkbox called Combined Entry Connector. By selecting this checkbox you tell eMagiz that you want to host an endpoint for others to call.
57 57  
58 -[[image:Main.Images.Microlearning.WebHome@novice-soap-webservice-connectivity-configure-your-soap-webservice-gen3--soap-entry-check.png]]
54 +[[image:Main.Images.Microlearning.WebHome@novice-soap-webservice-connectivity-configure-your-soap-webservice--combined-entry-check.png]]
59 59  
56 +As you can see, selecting this option opens up a new choice to make. In this case between SOAP Webservice and Custom.
57 +
58 +[[image:Main.Images.Microlearning.WebHome@novice-soap-webservice-connectivity-configure-your-soap-webservice--combined-entry-choice.png]]
59 +
60 +In this case, we opt for the SOAP web service. After you have done so eMagiz will automatically define the SOAP Webservice Name and SOAP Webservice Namespace.
61 +
62 +[[image:Main.Images.Microlearning.WebHome@novice-soap-webservice-connectivity-configure-your-soap-webservice--combined-entry-soap-ws-namespace.png]]
63 +
60 60  With this, you are done with your configuration on the system level. Don't forget to update the status of your task. Now that we have configured the system it is time to configure the integration that is drawn from the system to eMagiz. We can do so by double-clicking on it (or by accessing the context menu and selecting the edit option). When you open the Edit page on the integration level you will notice that a new segment is added (compared to other integrations). This segment defines the settings on the system level we have just specified and defines the operation name.
61 61  
62 62  [[image:Main.Images.Microlearning.WebHome@novice-soap-webservice-connectivity-configure-your-soap-webservice--edit-integration.png]]
... ... @@ -67,8 +67,13 @@
67 67  
68 68  Now that we have finished the configuration in Design the last step of this microlearning is to add the integration to Create. You can simply do so by navigating to Create -> Add integrations and selecting the integration to move it to Create. After you have selected it press Save to add the integration to Create.
69 69  
70 -== 4. Key takeaways ==
74 +== 4. Assignment ==
71 71  
76 +Configure a SOAP web service that consists of at least one operation and add it to Create.
77 +This assignment can be completed with the help of the (Academy) project that you have created/used in the previous assignment.
78 +
79 +== 5. Key takeaways ==
80 +
72 72  * Crucial parts in the configuration are:
73 73   ** Operation Name
74 74   ** SOAP Webservice Namespace
... ... @@ -76,8 +76,12 @@
76 76   ** Authentication
77 77  * For ease, you can use the default naming convention of eMagiz
78 78  
79 -== 5. Suggested Additional Readings ==
88 +== 6. Suggested Additional Readings ==
80 80  
81 81  If you are interested in this topic and want more information on it please read the help text provided by eMagiz.
82 82  
92 +== 7. Silent demonstration video ==
93 +
94 +{{video attachment="novice-soap-webservice-connectivity-configure-your-soap-webservice.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
95 +
83 83  )))((({{toc/}}))){{/container}}{{/container}}