====== GetFrameVariable ======

\\ \\  
This function returns the name of a frame variable (see [[en:transformation:mappings:framevariables|]]) as an argument and returns the structure or the value stored in the frame variable.
\\  

==== Syntax: ====

<code>GetFrameVariable('FrameVariablenName')</code>

==== Sample: ====

<code>GetFrameVariable('eBiss.DocumentVars.FileName')</code>
returns the file name in which the document is located.
\\ 
\\ 
Another new addition is the OriginDocObject.
With its help it is now possible to access the source of the currently processed SupplierArticleDocument with ArticleSelector.

==== further example: ====

  - A DESADV is mapped to RetailMW and then held against the ArticleSelector.\\
  - Now a mapping of SupplierArticleDocument to IndustryTradeItemDocument is coming.\\ 
  - Here you can now access the output desadv (in middleware format).\\ 

For the current case, for example, you can determine the quantity specifications at item level from DESADV using the following statements at item level::\\ 
<code>GetFrameVariable('eBiss.DocumentVars.OriginDocObject')/DespatchAdvice/Items[@Ean=XVar('CurEan')]/@Quantity</code>
For example, this quantity could be assigned to the field @quantity of the target object in a mapping rule.