Document examples of filtering output in an operation chain

[n3101]

Today a user asked for help constructing an operation chain where the returned results were filtered using an OR predicate. @GCHQDev404 constructed the code fragment below; which may be useful when rewriting the doc for Gaffer 2.0:

{
  "class" : "uk.gov.gchq.gaffer.operation.OperationChain",
  "operations" : [ {
    "class" : "uk.gov.gchq.gaffer.operation.impl.get.GetAllElements"
  }, {
    "class" : "uk.gov.gchq.gaffer.operation.impl.function.Filter",
    "edges" : {
      "edgeGroupName" : {
        "predicates" : [ {
          "selection" : [ "selection1" ],
          "predicate" : {
            "class" : "uk.gov.gchq.koryphe.impl.predicate.Or",
            "predicates" : [ {
              "class" : "uk.gov.gchq.koryphe.impl.predicate.CollectionContains",
              "value" : 1111
            }, {
              "class" : "uk.gov.gchq.koryphe.impl.predicate.CollectionContains",
              "value" : 3333
            } ]
          }
        } ]
      }
    }
  } ]
}

[n3101]

Or a more complicated example using TupleAdaptedPredicate for multiple fields:

{
    "class": "uk.gov.gchq.gaffer.operation.OperationChain",
    "operations": [
        {
            "class": "uk.gov.gchq.gaffer.operation.impl.get.GetAllElements",
            "options": {
                "gaffer.federatedstore.operation.graphIds": "graphSource1"
            }
        },
        {
            "class": "uk.gov.gchq.gaffer.operation.impl.function.Filter",
            "edges": {
                "edgeGroupName": {
                    "groupBy": [
                        "types"
                    ],
                    "predicates": [
                        {
                            "selection": [
                                "names",
                                "types"
                            ],
                            "predicate": {
                                "class": "uk.gov.gchq.koryphe.impl.predicate.Or",
                                "predicates": [
                                    {
                                        "class": "uk.gov.gchq.koryphe.tuple.predicate.TupleAdaptedPredicate",
                                        "selection": [
                                            0
                                        ],
                                        "predicate": {
                                            "class": "uk.gov.gchq.koryphe.impl.predicate.CollectionContains",
                                            "value": "jane"
                                        }
                                    },
                                    {
                                        "class": "uk.gov.gchq.koryphe.tuple.predicate.TupleAdaptedPredicate",
                                        "selection": [
                                            1
                                        ],
                                        "predicate": {
                                            "class": "uk.gov.gchq.koryphe.impl.predicate.CollectionContains",
                                            "value": "person"
                                        }
                                    }
                                ]
                            }
                        }
                    ]
                }
            },
            "options": {
                "gaffer.federatedstore.operation.graphIds": "graphSource1"
            }
        }
    ]
}