diff --git a/Home.md b/Home.md index 93a012c..bcd0774 100644 --- a/Home.md +++ b/Home.md @@ -1,21 +1,42 @@ -# Deploy the Project on CamelX Platform +# Extract Field Action -Deploy on CamelX Platform in three steps +Extract a field from the message body. -## Step 1: Create a release -From the project space, click on **"Create a release"** +The extract field action expects an application/json content type. -The new version is automatically available in the list +The field parameter allows you to specify which field of the json the user wants to extract. By default the message body will be overriden with the extracted field. -## Step 2: Deploy -Click on **"Deploy"** +The optional parameter headerOutput allows the user to specify wheter the extracted field should be stored in a message header named 'CamelKameletsExtractFieldName', leaving the message body untouched. -- **Version:** Select the desired release -- **Environment:** Choose `Development`, `Staging`, or `Production` -- **Configuration:** Select the configuration source -- **Resources:** Set CPU and Memory +The optional parameter headerOutputName allows the user to specify a custom header name instead of the default 'CamelKameletsExtractFieldName'. This parameter must be used in conjunction with headerOutput. +If no headerOutputName parameter will be provided, the default 'CamelKameletsExtractFieldName' will be used. -## Step 3: Expose -Enable **"Expose"** +The optional parameter strictHeaderCheck allows to user to enable a strict header name check. If enabled the action will check if the header output name (custom or default) has been used already in the exchange. If so, the extracted field will be stored in the message body, if not, the extracted field will be stored in the selected header (custom or default). -Choose an **API Gateway** (Internal, Public, etc.) +The headerOutput/headerOutputName/strictHeaderCheck parameters are particulary useful in case you would like to reuse an extracted field as parameter for another header, for example. + +## Metadata + +| Property | Value | +|----------|-------| +| Type | action | +| Group | Actions | +| Namespace | Transformation | +| Support Level | Stable | +| Provider | Apache Software Foundation | + +## Properties + +| Name | Type | Required | Default | Description | +|------|------|----------|---------|-------------| +| `field` | string | ✓ | | The name of the field to extract | +| `headerOutput` | boolean | | `false` | If enable the action will store the extracted field in an header named CamelKameletsExtractFieldName | +| `headerOutputName` | string | | `none` | A custom name for the header containing the extracted field | +| `strictHeaderCheck` | boolean | | `false` | If enabled the action will check if the header output name (custom or default) has been used already in the exchange. If so, the extracted field will be stored in the message body, if not, the extracted field will be stored in the selected header (custom or default). | +| `trimField` | boolean | | `false` | If enabled we return the Raw extracted field | + +## Dependencies + +- `camel:kamelet` +- `camel:core` +- `camel:jackson`