Merge remote-tracking branch 'origin/master' into zoho-magento2

# Conflicts:
#	config.toml

Author: clemzarch

config.toml

@@ -180,17 +180,23 @@ hasChildren = true
    url = "connectivity/filtering"
    weight = 12
 
+  [[menu.main]]
+   parent = "Connectivity"
+   name = "Batch"
+   url = "connectivity/batch"
+   weight = 13
+
   [[menu.main]]
    parent = "Connectivity"
    name = "Magento 2"
    url = "connectivity/magento-2"
-   weight = 13
+   weight = 14
 
   [[menu.main]]
   parent = "Connectivity"
   name = "Zoho CRM"
   url = "connectivity/zoho"
-  weight = 14
+  weight = 15
 
 [params]
 logo = "logo-web.svg"

content/connectivity/batch/_index.en.md

@@ -0,0 +1,98 @@
+---
+title: "Batch"
+date: 2023-06-22T12:00:02+02:00
+draft: false
+type: "plugins"
+description: "Fork a single line into multiple lines, or merge multiple lines into one."
+weight: 13
+---
+
+- [What is it?](#what-is-it)
+- [Installation](#installation)
+- [Usage](#usage)
+    - [Forking a line](#forking-a-line)
+    - [Merging multiple lines](#merging-multiple-lines)
+---
+
+## What is it?
+
+The Batch plugin can split a single line of data into multiple ones, or can merge multiple lines into a single one.
+
+## Installation
+
+This plugin is already integrated into the Satellite package, so you can’t require it with composer.
+
+## Usage
+
+### Forking a line
+
+`fork` splits data into multiple lines.
+
+In the following example, we have one line containing 2 fields: an `id`, and `images` which contains multiple values.
+Instead we want to have multiple lines, each containing a single `image` along with the `id`.
+
+Our example input looks like this:
+```json
+[{"images": ["one.jpg", "two.jpg", "three.jpg"], "id": 15}]
+```
+
+We'll use the "fork" option to split the lines for each value under `images`:
+
+{{< tabs name="fork" >}}
+
+{{< tab name="YAML configuration" codelang="yaml" >}}
+batch:
+  fork:
+    foreach: '@=input["images"]'
+    do: '@={ id: input["id"], image: item }'
+{{< /tab >}}
+
+{{< tab name="interpreted code" codelang="php" >}}
+$results = [];
+foreach ($input["images"] as $key => $item) {
+    $results[] = ["id" => $input["id"], "image" => $item];
+}
+{{< /tab >}}
+{{< /tabs >}}
+
+The result will be: 
+```json
+[{"id": 15, "image": "one.jpg"}]
+[{"id": 15, "image": "two.jpg"}]
+[{"id": 15, "image": "three.jpg"}]
+```
+
+### Merging multiple lines
+
+`merge` concatenates many lines traversing the pipeline into fewer lines.
+
+This can be useful if the targeted API can handle many batches of data in a single payload, like Akeneo for example.
+
+Our example input looks like this:
+```json
+[{"foo": "bar"}]
+[{"lorem": "ipsum"}]
+[{"ga": "bu"}]
+[{"zo": "meu"}]
+[{"bla": "bli"}]
+```
+
+We'll use the "merge" option. `size` dictates the maximum number of lines to concatenate:
+
+{{< tabs name="fork" >}}
+
+{{< tab name="YAML configuration" codelang="yaml" >}}
+batch:
+  merge:
+    size: 2
+{{< /tab >}}
+{{< /tabs >}}
+
+When the number of item reaches `size`, the merge will be applied to the next lines, and so on.
+
+The output will be:
+```json
+[{"foo": "bar"},{"lorem": "ipsum"}]
+[{"ga": "bu"},{"zo": "meu"}]
+[{"bla": "bli"}]
+```

content/feature/expression-language/array-expression-functions/_index.en.md

@@ -60,6 +60,7 @@ foo: '@=map(input["attributes"], extractData("[fr_FR][data]"))'
 | intersect(`array` array, `array` ...arrays): `array`                      | Computes the intersection of arrays                                                                                                     |
 | filterList(`string` iterator, `string` callback): `FilterIterator`        | Filters elements of an array using a callback function                                                                                  |
 | mapValues(`array` input, `array{pattern: replacement}` values): `array`   | Finds multiple matches in the input and replaces them with a value, with the format `{pattern: replacement, pattern: replacement ... }` |
+| implode(`string` $separator, `array` $array): `string`                    | Turns a list into a string                                                                                                              |
 
 ### Closures that can be provided to reduce
 

content/feature/expression-language/string-expression-functions/_index.en.md

@@ -68,3 +68,4 @@ foo: '@=dateTime(input["updated_at"], "YYYY-MM-ddTHH:ii:ss", "Europe/Paris")'
 | asFloat(`string` value): `string`                                                                                                                                                              | Converts the value into a float number                                                          | 
 | asInteger(`string` value): `string`                                                                                                                                                            | Converts the value to an integer                                                                | 
 | asString(`string` value): `string`                                                                                                                                                             | Converts the value into a string                                                                | 
+| truncate(`string` input, `int` limit): `string`                                                                                                                                                | Truncates a value and adds "…" at the end of it                                                 | 

content/getting-started/environment-setup/_index.en.md

@@ -19,15 +19,17 @@ After installing PHP, you must ensure that Composer 2 is installed on your machi
 
 For more information on how to install Composer, go to the [official documentation](https://getcomposer.org/download/).
 
-### JQ
-
-Jq, a JSON processor, is also required for satellites to generate their composer.json files.
-
-For more information on how to install jq, go to the [official documentation](https://stedolan.github.io/jq/download/).
-
 ### Docker (optional)
 
 Gyroscops offers you the possibility to build your configurations as images that you can use in a dockerized environment.
 That's why you may also need Docker.
 
 For more information on how to install Docker, go to the [official documentation](https://docs.docker.com/get-docker/).
+
+## Before v0.6.6 of `php-etl/satellite`:
+
+### JQ
+
+Jq, a JSON processor, is also required for satellites to generate their composer.json files.
+
+For more information on how to install jq, go to the [official documentation](https://stedolan.github.io/jq/download/).

docs/categories/index.html

@@ -4,7 +4,7 @@
   <meta charset="utf-8">
   <title>Categories  | Gyroscops Documentation</title>
 
-  <meta name="generator" content="Hugo 0.92.2" />
+  <meta name="generator" content="Hugo 0.111.3">
 
   <!-- mobile responsive meta -->
   <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
@@ -162,6 +162,8 @@
 
             <a class="dropdown-item" href="/documentation/connectivity/filtering">Filtering, drop or reject</a>
 
+            <a class="dropdown-item" href="/documentation/connectivity/batch">Batch</a>
+            
           </div>
         </li>
 
@@ -523,6 +525,22 @@ <h1 class="single-title mb-5">
 
 
 
+
+            
+            
+            
+
+            
+            
+            
+            
+            
+            
+            
+            
+            
+            
+