{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"type":{"value":"flat"}},"macroMetadata":{"macroId":{"value":"e6c81fa0baeddeae961727a21c3f7a6a"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"64f0aeab-3535-4b68-b59e-bb6629fd6cef"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Description","type":"text"}]},{"type":"paragraph","content":[{"text":"This unit is a ","type":"text"},{"text":"Processor","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/latest/pages/95213765"}}]},{"text":" unit type.","type":"text"}]},{"type":"paragraph","content":[{"text":"The XML Parser unit parses events containing a properly formatted XML, using the Jackson parser.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"An event comes in through the ","type":"text"},{"text":"in","type":"text","marks":[{"type":"em"}]},{"text":" port. The data field content is parsed using Jackson.","type":"text"}]},{"type":"paragraph","content":[{"text":"Successfully parsed input events are enriched with a new field containing the parse result and are output through the ","type":"text"},{"text":"out","type":"text","marks":[{"type":"em"}]},{"text":" port.","type":"text"}]},{"type":"paragraph","content":[{"text":"If an error occurs, the input event is enriched with new fields describing the problem, and the event is sent through the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"error ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":"port.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":106,"id":"4cdaa09c-babe-4012-b19d-d1a6f34d7a42","collection":"contentId-95215308","type":"file","height":84}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"After dragging this unit into the Flow canvas, double-click it to access its configuration options. The following table describes the configuration options of this unit:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"24130393-be4e-4803-8a2f-c13093a42d26"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[110.0]},"content":[{"type":"paragraph","content":[{"text":"Tab","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":4,"colwidth":[110.0]},"content":[{"type":"paragraph","content":[{"text":"General","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"paragraph","content":[{"text":"Enter a name for the unit. It must start with a letter, and cannot contain spaces. Only letters, numbers, and underscores are allowed.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"paragraph","content":[{"text":"Enter a description detailing the scope of the unit.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"In field","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"paragraph","content":[{"text":"Enter the name of the input event field containing JSON data.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"Out field","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"paragraph","content":[{"text":"Enter a name for the output event field containing the parse result.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Input ports","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"6723d03c-c111-40dc-95e7-aef75f5ef864"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Port","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"in","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Events containing a properly formatted XML to be parsed.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Output ports","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"e94d9273-f4c3-487d-a7d6-76654b522c22"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Port","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"out","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Outputs events enriched with an extra field containing the parsed XML.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"error","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Signals when an error occurred. Outputs input events enriched with standard error fields.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example, we want to insert an XML message containing information on threats and parse it to be sent to a ","type":"text"},{"text":"my.app ","type":"text","marks":[{"type":"strong"}]},{"text":"data table.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":1064,"id":"1d8e636f-b632-4e14-aaee-f93ddcd33ac2","collection":"contentId-95215308","type":"file","height":186}}]},{"type":"paragraph","content":[{"text":"First, we will use a ","type":"text"},{"text":"Tick","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":" unit to send the fields when clicked.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Fields ","type":"text","marks":[{"type":"strong"}]},{"text":"tab of the properties, add the ","type":"text"},{"text":"Type ","type":"text","marks":[{"type":"strong"}]},{"text":"as ","type":"text"},{"text":"string ","type":"text","marks":[{"type":"em"}]},{"text":"and enter the following expression in the ","type":"text"},{"text":"Value ","type":"text","marks":[{"type":"strong"}]},{"text":"field:","type":"text"}]},{"type":"codeBlock","content":[{"text":" Threat investigator Developer Comment A threat has been detected ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":573,"id":"674e106a-b185-4171-92b1-fda7b980b0ac","collection":"contentId-95215308","type":"file","height":729}}]},{"type":"paragraph","content":[{"text":"Then, we will link it to an XML Parser unit in order to parse this string.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the properties, select the ","type":"text"},{"text":"In field ","type":"text","marks":[{"type":"strong"}]},{"text":"as ","type":"text"},{"text":"threat ","type":"text","marks":[{"type":"em"}]},{"text":"to correspond with the field previously set in the Tick. Set a name for the ","type":"text"},{"text":"out ","type":"text","marks":[{"type":"strong"}]},{"text":"field, in this case, ","type":"text"},{"text":"data.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Next, we use a ","type":"text"},{"text":"Map","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/latest/pages/95214080"}}]},{"text":" unit to remove and add fields to the parsed message. Link the ","type":"text"},{"text":"out ","type":"text","marks":[{"type":"em"}]},{"text":"port of the XML Parser to the ","type":"text"},{"text":"in ","type":"text","marks":[{"type":"em"}]},{"text":"port.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Fields to add ","type":"text","marks":[{"type":"strong"}]},{"text":"tab of the properties, add the following fields:","type":"text"}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":533,"id":"95398ac0-d4a3-4066-bb66-960e21e830c1","collection":"contentId-95215308","type":"file","height":400}}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":531,"id":"910c18bc-2b03-4dd8-8e4f-f086f302e9a8","collection":"contentId-95215308","type":"file","height":401}}]}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":530,"id":"449c66f4-8d36-441a-a18b-611e67faf315","collection":"contentId-95215308","type":"file","height":398}}]},{"type":"paragraph"}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":534,"id":"e2a7191e-4cb7-4725-aeba-34b7c4d28d93","collection":"contentId-95215308","type":"file","height":403}}]},{"type":"paragraph"}]}]},{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Fields to remove ","type":"text","marks":[{"type":"strong"}]},{"text":"tab, enter ","type":"text"},{"text":"threat ","type":"text","marks":[{"type":"em"}]},{"text":"and ","type":"text"},{"text":"data. ","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Finally, we will link its ","type":"text"},{"text":"out ","type":"text","marks":[{"type":"em"}]},{"text":"output port to a ","type":"text"},{"text":"Devo sink","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":" unit to send the formatted events to a ","type":"text"},{"text":"my.app","type":"text","marks":[{"type":"strong"}]},{"text":" table.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":" Download this example","type":"text"}]},{"type":"paragraph","content":[{"text":"You can try this flow by downloading this JSON and uploading it to your domain using the ","type":"text"},{"text":"Import ","type":"text","marks":[{"type":"strong"}]},{"text":"option:","type":"text"}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"8d6cec96-bad4-43e6-bec7-d3db8bf1b9d3","collection":"contentId-95215308","type":"file"}}]},{"type":"paragraph"}],"version":1}

Browser not supported