@itentialopensource/filter-array-of-objects v0.1.11-2023.1.1

Deprecation Notice

This Pre-Built has been deprecated as of 01-15-2024 and will be end of life on 01-15-2025. The capabilities of this Pre-Built have been replaced by the IAP - Data Manipulation

Filter Array of Objects

Table of Contents

• Overview
• Installation Prerequisites
• Requirements
• Features
• Future Enhancements
• How to Install
• How to Run

Overview

This Pre-Built Transformation allows you to filter any array of objects by providing a key and a value to match on, and the option to discard the matching items from the array.

Installation Prerequisites

Users must satisfy the following pre-requisites:

• Itential Automation Platform
  • ^2022.1.x

How to Install

To install the artifact:

• Verify you are running a supported version of the Itential Automation Platform (IAP) as listed above in the Requirements section in order to install the artifact.
• The artifact can be installed from within App-Admin_Essential. Simply search for the name of your desired artifact and click the install button.

How to Run

To use this JST, provide an array of objects as an input. Also provide a key and a value to find. Lastly, choose whether you want to discard or keep changes.

For example, this will return all the object matching key "state" and value "GA":

{
  "filterableArray": [
    {"city":"Atlanta", "state":"GA"},
    {"city":"Sandy Springs", "state":"GA"},
    {"city":"Dallas", "state":"TX"},
    {"city":"Orlando", "state":"FL"}
  ],
  "keyToFilterOn": "state",
  "valueToFind": "GA",
  "discardMatching": false
}

Output:

{
  "filteredArray": [
    {
      "city": "Atlanta",
      "state": "GA"
    },
    {
      "city": "Sandy Springs",
      "state": "GA"
    }
  ],
  "firstFilteredElement": {
    "city": "Atlanta",
    "state": "GA"
  }
}