Add extractor/transformer/loader examples to the custom plugin page

Author: JoMessina

content/connectivity/custom/_index.en.md

@@ -8,12 +8,16 @@ description: "Read transform and write files in any format"
 weight: 3
 ---
 
-- [What is it ?](#what-is-it-)
+- [What is it ?](#definition)
 - [Installation](#installation)
 - [Usage](#usage)
   - [Building an extractor](#building-an-extractor)
   - [Building a transformer](#building-a-transformer)
   - [Building a loader](#building-a-loader)
+- [Usage examples](#usage-examples)
+  - [Example of an extractor](#example-of-an-extractor)
+  - [Example of a transformer](#example-of-a-transformer)
+  - [Example of a loader](#example-of-a-loader)
 ---
 
 ## Definition
@@ -68,3 +72,130 @@ custom:
         calls:
           - withUsername: [ 'admin' ]
 ```
+
+## Usage examples
+
+Some examples of pipeline with Magento to extract, FastMap to transform and ZohoCRM to load data
+
+### Example of an extractor
+
+```yaml
+custom:
+  extractor:
+    use: 'App\Component\Flow\Magento2\CustomerExtractor'
+    services:
+      App\Component\Flow\Magento2\CustomerExtractor:
+        arguments:
+          - '@Monolog\Logger'
+          - ['@firstname_filter_group_1', '@firstname_filter_group_2']
+        public: true
+      firstname_filter_group_1:
+        class: App\Component\Flow\Magento2\FilterGroup
+        calls:
+          - withFilter: [ '@firstname_filter_1' ]
+      firstname_filter_1:
+        class: App\Component\Flow\Magento2\Filter
+        arguments:
+          - 'firstname'
+          - 'nlike'
+          - '%bm01.cc'
+      firstname_filter_group_2:
+        class: App\Component\Flow\Magento2\FilterGroup
+        calls:
+          - withFilter: [ '@firstname_filter_2' ]
+      firstname_filter_2:
+        class: App\Component\Flow\Magento2\Filter
+        arguments:
+          $field: 'firstname'
+          $conditionType: 'nlike'
+          $value: '%.xyz'
+      Monolog\Logger:
+        arguments:
+          - 'app'
+          - [ '@Monolog\Handler\StreamHandler' ]
+      Monolog\Handler\StreamHandler:
+        arguments:
+          - 'var/dev.log'
+          - 300
+```
+
+You can write the arguments of your service in 2 different ways.
+You can list them with a '-' but you need to respect the order of the arguments in the constructor,
+or you can simply name the arguments by their variable name in the constructor.
+
+#### Filter class constructor :
+```php
+class Filter
+{
+  public function __construct(
+      public string $field,
+      public string $conditionType,
+      public string $value,
+  ) {
+  }
+}
+```
+
+### Example of a transformer
+```yaml
+custom:
+  transformer:
+    use: 'App\CachedAttributeLookup'
+    services:
+      PDO:
+        arguments:
+          - 'mysql:host=127.0.0.1;port=3306;dbname=lacelier'
+          - 'user'
+          - 'password'
+      App\CachedAttributeLookup:
+        arguments:
+          - '@PDO'
+          - 'SELECT * FROM color WHERE region=:region AND code=:code'
+          - '@Cache\Adapter\Apcu\ApcuCachePool'
+          - 'color'
+          - '@App\ColorLookupMapper'
+        public: true
+      App\ColorLookupMapper: ~
+      Cache\Adapter\Apcu\ApcuCachePool: ~
+      Symfony\Component\Cache\Adapter\ApcuAdapter: ~
+```
+
+### Example of a loader
+```yaml
+custom:
+  loader:
+    use: 'App\Component\Flow\ZohoCRM\ContactLoader'
+    services:
+      App\Component\Flow\ZohoCRM\ContactLoader:
+        arguments:
+          - '@App\Component\Flow\ZohoCRM\Client\Client'
+          - '@Monolog\Logger'
+        public: true
+      GuzzleHttp\Client: ~
+      GuzzleHttp\Psr7\HttpFactory: ~
+      App\Component\Flow\ZohoCRM\Client\AuthenticationMiddleware:
+        arguments:
+          - '@GuzzleHttp\Client'
+          - '@GuzzleHttp\Psr7\HttpFactory'
+          - '@GuzzleHttp\Psr7\HttpFactory'
+          - '%env(ZOHO_OAUTH_HOST)%'
+          - '%env(ZOHO_CLIENT_ID)%'
+          - '%env(ZOHO_CLIENT_SECRET)%'
+          - '%env(ZOHO_ACCESS_TOKEN)%'
+          - '%env(ZOHO_REFRESH_TOKEN)%'
+      App\Component\Flow\ZohoCRM\Client\Client:
+        arguments:
+          - '%env(ZOHO_BASE_HOST)%'
+          - '@App\Component\Flow\ZohoCRM\Client\AuthenticationMiddleware'
+          - '@GuzzleHttp\Psr7\HttpFactory'
+          - '@GuzzleHttp\Psr7\HttpFactory'
+          - '@GuzzleHttp\Psr7\HttpFactory'
+      Monolog\Logger:
+        arguments:
+          - 'app'
+          - [ '@Monolog\Handler\StreamHandler' ]
+      Monolog\Handler\StreamHandler:
+        arguments:
+          - 'var/dev.log'
+          - 300
+```