Summary

• Page properties (1 modified, 0 added, 0 removed)
• Attachments (0 modified, 2 added, 0 removed)
  • 2021-04-27_21h31_55.png
  • 2021-04-27_21h32_07.png

Details

Page properties

Content

...	...	@@ -1,7 +1,11 @@
	1	+{{toc/}}
	2	+
1	1	= Introduction =
2	2
3		- Variable is a container that holds a value and can be called in the iXPath Scenario. The importance of variables is to make flexibility in using some values without referring to their origins.
	5	+ Variable is a container that holds a value and can be called in the iXPath Scenario. The importance of
4	4
	7	+variables is to make flexibility in using some values without referring to their origins.
	8	+
5	5	There are 2 types of  variables:
6	6
7	7	* System variables
...	...	@@ -9,7 +9,7 @@
9	9
10	10	To call a variable, we should put it inside ${}. Eg: for a variable named ‘iXVar’, it can be called as ${iXVar}.
11	11
12		-== System variables ==
	16	+== System variables ==
13	13
14	14	System variables define some default values in the system, and they can be called by users several times.
15	15
...	...	@@ -27,8 +27,9 @@
27	27	1*. iXFrom: return the value of the AS2 sender.
28	28	1. All connectors declare a system variable of type BpmnFile, the connector variable uses a bunch of functions to handle the list of BpmnFiles that will be detailed in the table below :
29	29	1*. (((
30		-|(% style="width:150px" %)**Function**|(% style="width:365px" %)**Description**|(% style="width:394px" %)**Use**
31		-|(% style="width:150px" %)Get(i) |(% style="width:365px" %)Get a file with index number "i" from the BpmnFile list, the indexes begin from 0 as the first element, and so on.|(% style="width:394px" %)(((
	34	+(% style="width:884px" %)
	35	+|(% style="width:150px" %)**Function**|(% style="width:365px" %)**Description**|(% style="width:367px" %)**Use**
	36	+|(% style="width:150px" %)Get(x) |(% style="width:365px" %)Get a file with index number "x" from the BpmnFile list, the indexes begin from 0 as the first element, and so on.|(% style="width:367px" %)(((
32	32	if we have an XmlToXml connector named "XmlToXml1" we can get __the second__ BpmnFile as :
33	33
34	34	${XmlToXml1.get(1)}
...	...	@@ -35,33 +35,64 @@
35	35
36	36	NB: we will make examples on the same connector "XmlToXml1".
37	37	)))
38		-|(% style="width:150px" %)getTrkValues()|(% style="width:365px" %)Return the Tracking values from a BpmnFile.|(% style="width:394px" %)Eg : ${XmlToXml1.get(0).getTrkValues()} returns the tracking values of the first BpmnFile.
39		-|(% style="width:150px" %)path()|(% style="width:365px" %)Return the absolute path of the BpmnFile.|(% style="width:394px" %)Eg : ${XmlToXml.get(3).path()} returns the path of the __fourth__ BpmnFile
40		-|(% style="width:150px" %)fileName()|(% style="width:365px" %)Return the name of the BpmnFile. |(% style="width:394px" %)Eg : ${XmlToXml1.get(2).fileName()} retrieves the name of the third BpmnFile.
41		-|(% style="width:150px" %)extension()|(% style="width:365px" %)Returns the extension of the BpmnFile.|(% style="width:394px" %)(((
	43	+|(% style="width:150px" %)getTrkValues()|(% style="width:365px" %)Return the Tracking values from a BpmnFile.|(% style="width:367px" %)Eg : ${XmlToXml1.get(0).getTrkValues()} returns the tracking values of the first BpmnFile.
	44	+|(% style="width:150px" %)path()|(% style="width:365px" %)Return the absolute path of the BpmnFile.|(% style="width:367px" %)Eg : ${XmlToXml.get(3).path()} returns the path of the __fourth__ BpmnFile
	45	+|(% style="width:150px" %)fileName()|(% style="width:365px" %)Return the name of the BpmnFile. |(% style="width:367px" %)Eg : ${XmlToXml1.get(2).fileName()} retrieves the name of the third BpmnFile.
	46	+|(% style="width:150px" %)extension()|(% style="width:365px" %)Returns the extension of the BpmnFile.|(% style="width:367px" %)(((
42	42	Eg : if we want to get the extension of the first BpmnFile, we will proceed as below :
43	43
44	44	${XmlToXml1.get(0).extension()}
45	45	)))
46		-|(% style="width:150px" %)fullName()|(% style="width:365px" %)Returns the file name + its extension  |(% style="width:394px" %)Eg : ${XmlToXml1.get(0).fullName()} returns the full name of the BpmnFile.
47		-|(% style="width:150px" %)size()|(% style="width:365px" %)Returns the size of the BpmnFile in megabit.|(% style="width:394px" %)(((
	51	+|(% style="width:150px" %)fullName()|(% style="width:365px" %)Returns the file name + its extension  |(% style="width:367px" %)Eg : ${XmlToXml1.get(0).fullName()} returns the full name of the BpmnFile.
	52	+|(% style="width:150px" %)size()|(% style="width:365px" %)Returns the size of the BpmnFile in megabit.|(% style="width:367px" %)(((
48	48	Eg : ${XmlToXml1.get(0).size()} returns the size of the first BpmnFile.
49	49	)))
50		-|(% style="width:150px" %)type()|(% style="width:365px" %)Returns the type of the BpmnFile|(% style="width:394px" %)(((
	55	+|(% style="width:150px" %)type()|(% style="width:365px" %)Returns the type of the BpmnFile|(% style="width:367px" %)(((
51	51	Eg : To get the type of the second BpmnFile ,
52	52
53	53	${XmlToXml1.get(1).type()}
54	54	)))
55		-|(% style="width:150px" %) |(% style="width:365px" %) |(% style="width:394px" %)
56		-|(% style="width:150px" %) |(% style="width:365px" %) |(% style="width:394px" %)
57		-|(% style="width:150px" %) |(% style="width:365px" %) |(% style="width:394px" %)
58		-|(% style="width:150px" %) |(% style="width:365px" %) |(% style="width:394px" %)
59		-
60		-
61	61	)))
62	62
	62	+== Local variables ==
63	63
	64	+Local variable is a type of variable that can be newly created and used for a certain need.
64	64
	66	+So as to create a local variable "newVar" with a value equals to "var number 1", we should write this piece of XSL code :
65	65
	68	+{{code language="XML"}}
	69	+<xsl:value-of select=" ixf:SetVar('newVar', 'var Number 1')"></xsl:value-of>
66	66
	71	+{{/code}}
	72	+
	73	+The call of this new variable in the scenario is similar to previous system variables:  **${newVar}.**
	74	+
	75	+To get 'newVar' inside an XSL file :
	76	+
	77	+{{code language="XML"}}
	78	+<xsl:value-of select="ixf:getVar('newVar')"></xsl:value-of>
	79	+{{/code}}
	80	+
	81	+= Examples =
	82	+
	83	+We set a simple example of a scenario to illustrate how to use variables.
	84	+
	85	+We want to receive a file by a FileListener and send it by mail that contains a message body.
	86	+
	87	+here is the scenario:
	88	+
	89	+ [[image:2021-04-27_21h31_55.png||height="140" width="446"]]
	90	+
	91	+The configuration of the "SendMail" is :
	92	+
	93	+ [[image:2021-04-27_21h32_07.png||height="373" width="281"]]
	94	+
	95	+As shown in the mail body, we called 3 variables which are :
	96	+
	97	+* Env : the current environment
	98	+* iXSession : ID session
	99	+* path : path of the BpmnFile in FileListener1.
	100	+
	101	+
	102	+
67	67

2021-04-27_21h31_55.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.omoustaghfir

Size

...	...	@@ -1,0 +1,1 @@
	1	+27.0 KB

Content

2021-04-27_21h32_07.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.omoustaghfir

Size

...	...	@@ -1,0 +1,1 @@
	1	+36.4 KB

Content