Step: Combine Packages

This step merges together any packages from the same playbook that have been separated, either from the Split Package step or from one step pointing to two or more steps downstream. Any graphs with the same name are merged together, and any package variables with the same name are combined into an array (table) or optionally it will only keep the first value returned for each variable.

  • Do not combine package variables checkbox
    • When unchecked, each variable from the incoming packages are combined into an array (table). The ordering of the rows of this table are the same for each variable in the package. For instance, ${firstname[0][1] and ${lastname[0][1] would refer to the same package from the previous split. This is useful when the incoming data is different and you will want to refer to each value after the Combine. Note that since this options puts each new item into an array (table), a variable that was previously referred to as ${subject} would now be referred to as ${subject[0]}
    • When checked, the first variable returned from the incoming package is used and all other package variables with the same name are ignored. This is useful when you know that the value of the variable will be the same for all incoming packages. With this option, the incoming variable will be output at the same level (e.g. ${subject} remains unchanged)

  • For Reference: Terminology: Package, Variable, Value

This playbook ingests a JSON file from Active Directory, reifies it, then finds each of five date formats that the reifier does not know how to convert into a date. Since the Reify JSON Object step points to five separate JSON Path steps, this playbook creates five separate packages that all flow independently through their steps. The Combine Packages step at the end creates one new package that is then published. Without the Combine step, the Publish step would run five times; once for each package.

Note that the last step in each of the five columns is to add the converted date to the default graph in each package. When combined together in the Combine step, those graphs are all merged together into one new graph.

  • step/combine-packages
  • Last modified: 2019/02/20 22:23