Changes for page Base64 decoding

Summary

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

Details

Page properties

Title

...	...	@@ -1,1 +1,1 @@
1		-intermediate-data-handling-base64-decoding
	1	+Base64 decoding

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.marijn
	1	+XWiki.ebakker

Default language

...	...	@@ -1,0 +1,1 @@
	1	+en

Content

...	...	@@ -1,20 +1,11 @@
1		-{{html wiki="true"}}
2		-<div class="ez-academy">
3		- <div class="ez-academy_body">
	1	+{{container}}
	2	+{{container layoutStyle="columns"}}
	3	+(((
4	4
5		-<div class="doc">
6		-
7		-
8		-
9		-= Base64 decoding =
10		-
11	11	Most of the time, you can use the standard tooling of eMagiz to manipulate the data so that it makes sense for the (external) party that receives the data. However, sometimes there are cases in which you need a little bit of extra complexity. This microlearning will explain one of those more complex scenarios. In this microlearning, we will learn how to use base64 decoding on your (input) message. This functionality is beneficial when the message is encoded, but you need to manipulate part of the data.
12	12
13		-Should you have any questions, please get in touch with academy@emagiz.com.
	7	+Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
14	14
15		-* Last update: August 26th, 2021
16		-* Required reading time: 5 minutes
17		-
18	18	== 1. Prerequisites ==
19	19
20	20	* Basic knowledge of the eMagiz platform
...	...	@@ -31,8 +31,6 @@
31	31	* The component in eMagiz needs a base64 encoded string as input
32	32	* Multiple times encoding and decoding in the same integration is **not** advisable
33	33
34		-
35		-
36	36	== 3. Base64 decoding ==
37	37
38	38	Most of the time, you can use the standard tooling of eMagiz to manipulate the data so that it makes sense for the (external) party that receives the data. However, sometimes there are cases in which you need a little bit of extra complexity. This microlearning will explain one of those more complex scenarios. In this microlearning, we will learn how to use base64 decoding on your (input) message. This functionality is beneficial when the message is encoded, but you need to manipulate part of the data.
...	...	@@ -54,7 +54,7 @@
54	54
55	55	First, we need to navigate to the Create phase of eMagiz and open the flow in which we want to add this logic. Once you have opened your flow, you need to enter "Start editing" mode. This mode allows you to change the flow in question and add the logic to the transformation within the flow. When you have done so, it becomes time to add the base64 decode component to the flow.
56	56
57		-<p align="center">[[image:intermediate-data-handling-base64-decode--component.png||]]</p>
	46	+[[image:Main.Images.Microlearning.WebHome@intermediate-data-handling-base64-decode--component.png]]
58	58
59	59	At the component level, you need to define the input and output channel. Afterward, you need to determine if your output will be bytes or string (on the Advanced tab). If you want to transform the content of the base64 encoded string via the tooling, the string option will make more sense. However, that option also uses up more memory. So depending on your use case, you should consider the whole dynamic when making your choice.
60	60
...	...	@@ -62,8 +62,6 @@
62	62
63	63	Now that we know how to implement it, we can quickly look at possible use cases for this logic. We see this logic popping up mainly when dealing with attachments/files (i.e., pictures, pdf) within XML messages.
64	64
65		-===== Practice =====
66		-
67	67	== 4. Assignment ==
68	68
69	69	Look for places where you could use this logic to aid your integration process within your (Academy) project.
...	...	@@ -78,8 +78,6 @@
78	78	* The component in eMagiz needs a base64 encoded string as input
79	79	* Multiple times encoding and decoding in the same integration is **not** advisable
80	80
81		-
82		-
83	83	== 6. Suggested Additional Readings ==
84	84
85	85	If you are interested in this topic and want more information, please read the help text provided by eMagiz and the following links:
...	...	@@ -91,11 +91,7 @@
91	91
92	92	This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned.
93	93
94		-<iframe width="1280" height="720" src="../../vid/microlearning/intermediate-data-handling-base64-decode.mp4" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
	79	+{{video attachment="intermediate-data-handling-base64-decode.mp4" reference="Main.Videos.Microlearning.WebHome"/}})))
95	95
96		-</div>
97		-
98		-</div>
99		-</div>
100		-
101		-{{/html}}
	81	+((({{toc/}}))){{/container}}
	82	+{{/container}}