Empire Burlesque

{"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":"699b5000f190a4058985b1a238203f79"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"9e07d282-86e8-436f-961e-a18087283c32"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Description","type":"text"}]},{"type":"paragraph","content":[{"text":"This unit is a ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":" Processor ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"link","attrs":{"href":"/wiki/spaces/latest/pages/95213765"}}]},{"text":"type unit.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"The XPath unit executes XPath queries against XML documents. The result is provided as a new XML document.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"An event comes in through the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"in ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":"port. The expression specified in the properties is executed and the data field content is parsed.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"Successfully parsed input events are enriched with a new field containing the xpath result, and the event is output through the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"out ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":"port.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"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":101,"id":"5ef13f0b-608e-40a6-a975-da86da7f2c51","collection":"contentId-95215333","type":"file","height":81}}]},{"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":"efb6275f-bc65-44c6-a137-24ae70598709"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[107.0]},"content":[{"type":"paragraph","content":[{"text":"Tab","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[166.0]},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[487.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":6,"colwidth":[107.0]},"content":[{"type":"paragraph","content":[{"text":"General","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[166.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[487.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":[166.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[487.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":[166.0]},"content":[{"type":"paragraph","content":[{"text":"Expression","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[487.0]},"content":[{"type":"paragraph","content":[{"text":"Enter an XPath valid expression to determine the behavior of the unit.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[166.0]},"content":[{"type":"paragraph","content":[{"text":"Result type","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[487.0]},"content":[{"type":"paragraph","content":[{"text":"The type of the expected result. XML stands for XML String. Java stands for generic java types (Map, List, String, ...).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[166.0]},"content":[{"type":"paragraph","content":[{"text":"In field","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[487.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":[166.0]},"content":[{"type":"paragraph","content":[{"text":"Out field","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[487.0]},"content":[{"type":"paragraph","content":[{"text":"Enter a name for the output event field containing the 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":"45868118-d614-4da8-bb23-9e98e46ddcc9"},"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.","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":"ae15f8e4-a386-4e5a-90e6-c7bf44929fb9"},"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 new 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. Events are 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":"Imagine you receive an XML with a HTTP sender and you wish to extract certain values to send via email. Here, we have received an XML document containing CD information and we wish to extract the year in a new XML using Xpath queries.","type":"text"}]},{"type":"paragraph","content":[{"text":"For this, we will use an XPath unit to extract certain values and output them.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":83.0},"content":[{"type":"media","attrs":{"width":834,"id":"3e702be8-7618-4066-81ee-2f270279959e","collection":"contentId-95215333","type":"file","height":174}}]},{"type":"paragraph","content":[{"text":"To simulate the HTTP sender information, we will use a ","type":"text"},{"text":"Tick","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/latest/pages/95214835"}}]},{"text":" unit. In the ","type":"text"},{"text":"Fields ","type":"text","marks":[{"type":"strong"}]},{"text":"tab, add the XML example as a ","type":"text"},{"text":"string ","type":"text","marks":[{"type":"em"}]},{"text":"Type","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"to include in the output event:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\nEmpire Burlesque\nBob Dylan\nUSA\nColumbia\n10.90\n1985\n\n\nHide your heart\nBonnie Tyler\nUK\nCBS Records\n9.90\n1988\n\n","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":66.0},"content":[{"type":"media","attrs":{"width":543,"id":"8ac7ddd4-d78f-451d-9c8b-3234da77d1af","collection":"contentId-95215333","type":"file","height":642}}]},{"type":"paragraph","content":[{"text":"Next, we add the XPath unit and in the properties specify the XPath expression to execute against the XML, in this case, ","type":"text"},{"text":"/CATALOG/CD/YEAR.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"You must specify the","type":"text"},{"text":" In field ","type":"text","marks":[{"type":"strong"}]},{"text":"that will receive the data from the Tick unit, and the ","type":"text"},{"text":"out ","type":"text","marks":[{"type":"strong"}]},{"text":"field to send output events.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":541,"id":"8bca2db9-a593-430d-88f3-a583b609d88f","collection":"contentId-95215333","type":"file","height":646}}]},{"type":"paragraph","content":[{"text":"Link the XPath unit to the ","type":"text"},{"text":"Tick","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/latest/pages/95214835"}}]},{"text":" unit. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Finally, we need to specify the destination to receive the XML containing only information on the years. Add an ","type":"text"},{"text":"Email Sink ","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/latest/pages/95215374"}}]},{"text":"unit and in the ","type":"text"},{"text":"To Recipients ","type":"text","marks":[{"type":"strong"}]},{"text":"tab add the email destination. Link the XPath unit to this Email Sink.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"After ","type":"text"},{"text":"saving and starting","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/latest/pages/95213352"}}]},{"text":" the Flow, you must click the red button of the Tick unit to begin sending events.","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 the following JSON file 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":"4da0ed6c-65c9-4e19-ac49-e8098b2ae0d2","collection":"contentId-95215333","type":"file"}}]},{"type":"paragraph"}],"version":1}

Browser not supported