This is an automated email from the ASF dual-hosted git repository.
oscerd pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel-kamelets.git
The following commit(s) were added to refs/heads/main by this push:
new 34f455764 chore: fix Kamelets that fail to start or ignore an option
(#3158)
34f455764 is described below
commit 34f455764674dbd43e90a8f2b39f20ca3c41e69b
Author: Claus Ibsen <[email protected]>
AuthorDate: Tue Nov 17 09:35:46 2026 +0100
chore: fix Kamelets that fail to start or ignore an option (#3158)
* chore: fix Kamelets that fail to start or ignore an option
- scp-sink: knownHostsUri and privateKeyPassphrase are mapped to the scp
options knownHostsFile and privateKeyFilePassphrase; setting either made
it fail to start with "Unknown parameters". knownHostsUri now takes a
path or classpath: resource, the forms the scp component accepts.
- google-mail-source: labels is optional, but the template required it.
- mail-sink: from, to and subject are optional, as the ce-* headers can
give them, but the template required them.
- header-matches-filter-action headerName, jira-source jql,
salesforce-create-sink sObjectName, fhir-sink apiName and
aws-bedrock-agent-sink dataSourceId are required: the route cannot work
without them.
- pdf-action: the default font Helvetica failed every message; the font
names are HELVETICA, COURIER_BOLD and so on.
- xj-template-action failed at start: the xj component takes the
stylesheet from its path, not from resourceUri. Its description is
rewritten to docs/modules/ROOT/pages/documenting.adoc (#3140) with the
fix.
- rest-openapi-sink: clientRequestValidation is passed as the producer's
requestValidationEnabled; it had no effect.
- mariadb-source and sqlserver-source declared their output type as input,
and google-storage-source named the aws2-s3 cloudevents data type.
Each was reproduced and verified on Camel 4.23.0 and 4.24.0-SNAPSHOT.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
* chore: solr-source sends the answer of Solr as JSON text again
The marshal step was lost when the Kamelet was re-introduced, so the body
was the SolrJ NamedList object, while the Kamelet declares
application/json. The types block was also under in instead of out.
The rewritten description and partial page come with the fix.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
---------
Co-authored-by: Claude Opus 5.5 <[email protected]>
---
.../ROOT/partials/solr-source-description.adoc | 50 +++++++++-------------
kamelets/aws-bedrock-agent-sink.kamelet.yaml | 1 +
kamelets/fhir-sink.kamelet.yaml | 1 +
kamelets/google-mail-source.kamelet.yaml | 2 +-
kamelets/google-storage-source.kamelet.yaml | 2 +-
kamelets/header-matches-filter-action.kamelet.yaml | 1 +
kamelets/jira-source.kamelet.yaml | 1 +
kamelets/mail-sink.kamelet.yaml | 2 +-
kamelets/mariadb-source.kamelet.yaml | 2 +-
kamelets/pdf-action.kamelet.yaml | 2 +-
kamelets/rest-openapi-sink.kamelet.yaml | 2 +-
kamelets/salesforce-create-sink.kamelet.yaml | 1 +
kamelets/scp-sink.kamelet.yaml | 4 +-
kamelets/solr-source.kamelet.yaml | 30 +++++++++----
kamelets/sqlserver-source.kamelet.yaml | 2 +-
kamelets/xj-template-action.kamelet.yaml | 19 +++++---
.../xj-template-action.kamelet.yaml.orig | 17 ++++++--
.../main/resources/META-INF/kamelets-index.json | 4 +-
.../kamelets/aws-bedrock-agent-sink.kamelet.yaml | 1 +
.../main/resources/kamelets/fhir-sink.kamelet.yaml | 1 +
.../kamelets/google-mail-source.kamelet.yaml | 2 +-
.../kamelets/google-storage-source.kamelet.yaml | 2 +-
.../header-matches-filter-action.kamelet.yaml | 1 +
.../resources/kamelets/jira-source.kamelet.yaml | 1 +
.../main/resources/kamelets/mail-sink.kamelet.yaml | 2 +-
.../resources/kamelets/mariadb-source.kamelet.yaml | 2 +-
.../resources/kamelets/pdf-action.kamelet.yaml | 2 +-
.../kamelets/rest-openapi-sink.kamelet.yaml | 2 +-
.../kamelets/salesforce-create-sink.kamelet.yaml | 1 +
.../main/resources/kamelets/scp-sink.kamelet.yaml | 4 +-
.../resources/kamelets/solr-source.kamelet.yaml | 30 +++++++++----
.../kamelets/sqlserver-source.kamelet.yaml | 2 +-
.../kamelets/xj-template-action.kamelet.yaml | 19 +++++---
33 files changed, 136 insertions(+), 79 deletions(-)
diff --git a/docs/modules/ROOT/partials/solr-source-description.adoc
b/docs/modules/ROOT/partials/solr-source-description.adoc
index 3d75c6e6f..1ae65c521 100644
--- a/docs/modules/ROOT/partials/solr-source-description.adoc
+++ b/docs/modules/ROOT/partials/solr-source-description.adoc
@@ -2,42 +2,34 @@
=== Authentication methods
-This Kamelet connects to Solr using appropriate authentication mechanisms:
-
-- Service-specific authentication methods
-- API keys, tokens, or credential-based authentication
-- Connection configuration
+This Kamelet connects to Solr over plain HTTP. For a Solr with Basic
authentication, set the `username` and `password` properties; leave them out
for a Solr without login.
=== Output format
-The Kamelet consumes data from Solr and produces the data in JSON format.
+The Kamelet runs the configured query at every `period`, and produces one
message per query: the answer of Solr as JSON text, with the documents found
under `response`. Every query returns all the matching documents again, not
only the new ones.
=== Configuration
-The Kamelet requires connection parameters specific to Solr:
+The Kamelet requires the following properties:
-- Service connection details
-- Authentication credentials
-- Query or consumption parameters
+- `servers`: the Solr server, as `host:port`
+- `collection`: the collection, or the core, to query
+- `query`: the query, in the Solr query syntax, such as `status_s:new`
+- `period`: the time between two queries, in milliseconds
=== Usage example
-```yaml
-apiVersion: camel.apache.org/v1alpha1
-kind: KameletBinding
-metadata:
- name: solr-source-binding
-spec:
- source:
- ref:
- kind: Kamelet
- apiVersion: camel.apache.org/v1alpha1
- name: solr-source
- properties:
- # Add service-specific properties here
- sink:
- ref:
- kind: Service
- apiVersion: v1
- name: my-service
-```
+[source,yaml,subs='+attributes,macros']
+----
+- route:
+ from:
+ uri: "kamelet:solr-source"
+ parameters:
+ servers: "solr.example.com:8983"
+ collection: "products"
+ query: "status_s:new"
+ period: 60000
+ steps:
+ - to:
+ uri: "kamelet:log-sink"
+----
diff --git a/kamelets/aws-bedrock-agent-sink.kamelet.yaml
b/kamelets/aws-bedrock-agent-sink.kamelet.yaml
index 09d914e24..10476155d 100644
--- a/kamelets/aws-bedrock-agent-sink.kamelet.yaml
+++ b/kamelets/aws-bedrock-agent-sink.kamelet.yaml
@@ -33,6 +33,7 @@ spec:
description: Manage the data source ingestion jobs of an AWS Bedrock
knowledge base.
required:
- knowledgeBaseId
+ - dataSourceId
- region
type: object
properties:
diff --git a/kamelets/fhir-sink.kamelet.yaml b/kamelets/fhir-sink.kamelet.yaml
index 729df44a7..ed6d53917 100644
--- a/kamelets/fhir-sink.kamelet.yaml
+++ b/kamelets/fhir-sink.kamelet.yaml
@@ -34,6 +34,7 @@ spec:
description: Forward data to a FHIR endpoint.
required:
- serverUrl
+ - apiName
- methodName
type: object
properties:
diff --git a/kamelets/google-mail-source.kamelet.yaml
b/kamelets/google-mail-source.kamelet.yaml
index 56bb9a589..3b9a93ef1 100644
--- a/kamelets/google-mail-source.kamelet.yaml
+++ b/kamelets/google-mail-source.kamelet.yaml
@@ -161,7 +161,7 @@ spec:
- "camel:google-mail"
template:
from:
- uri:
"google-mail-stream://{{index}}?accessToken=RAW({{accessToken}})&applicationName={{applicationName}}&clientId={{clientId}}&clientSecret=RAW({{clientSecret}})&delay={{delay}}&labels={{labels}}&markAsRead={{markAsRead}}&query={{query}}&refreshToken=RAW({{refreshToken}})"
+ uri:
"google-mail-stream://{{index}}?accessToken=RAW({{accessToken}})&applicationName={{applicationName}}&clientId={{clientId}}&clientSecret=RAW({{clientSecret}})&delay={{delay}}&labels={{?labels}}&markAsRead={{markAsRead}}&query={{query}}&refreshToken=RAW({{refreshToken}})"
steps:
- marshal:
json: {}
diff --git a/kamelets/google-storage-source.kamelet.yaml
b/kamelets/google-storage-source.kamelet.yaml
index d678f93ca..122dde09c 100644
--- a/kamelets/google-storage-source.kamelet.yaml
+++ b/kamelets/google-storage-source.kamelet.yaml
@@ -91,7 +91,7 @@ spec:
description: Default binary representation of the Google Storage
Cloud object retrieved from the bucket.
mediaType: application/octet-stream
cloudevents:
- format: "aws2-s3:application-cloudevents"
+ format: "google-storage:application-cloudevents"
description: Output data type represents Google Storage download
response as CloudEvent V1. The data type sets Camel specific CloudEvent headers
on the exchange with respective data from the Google Storage bucket and its
derived object.
headers:
CamelCloudEventID:
diff --git a/kamelets/header-matches-filter-action.kamelet.yaml
b/kamelets/header-matches-filter-action.kamelet.yaml
index 50767a97f..10050d0f8 100644
--- a/kamelets/header-matches-filter-action.kamelet.yaml
+++ b/kamelets/header-matches-filter-action.kamelet.yaml
@@ -33,6 +33,7 @@ spec:
description: "Filter based on header value compared to regex."
required:
- regex
+ - headerName
properties:
regex:
title: Regex
diff --git a/kamelets/jira-source.kamelet.yaml
b/kamelets/jira-source.kamelet.yaml
index b0622ee12..ac4c1ead4 100644
--- a/kamelets/jira-source.kamelet.yaml
+++ b/kamelets/jira-source.kamelet.yaml
@@ -34,6 +34,7 @@ spec:
required:
- jiraUrl
+ - jql
type: object
properties:
jiraUrl:
diff --git a/kamelets/mail-sink.kamelet.yaml b/kamelets/mail-sink.kamelet.yaml
index 8c6a525f9..032925e7d 100644
--- a/kamelets/mail-sink.kamelet.yaml
+++ b/kamelets/mail-sink.kamelet.yaml
@@ -149,7 +149,7 @@ spec:
- removeHeaders:
pattern: ce-*
- to:
- uri:
"{{protocol}}:{{connectionHost}}:{{connectionPort}}?subject={{subject}}&from={{from}}&to={{to}}&username={{username}}&password={{password}}&useHeaderSubject=true&useHeaderFrom=true&useHeaderRecipients=true"
+ uri:
"{{protocol}}:{{connectionHost}}:{{connectionPort}}?subject={{?subject}}&from={{?from}}&to={{?to}}&username={{username}}&password={{password}}&useHeaderSubject=true&useHeaderFrom=true&useHeaderRecipients=true"
# camel-mail ignores the Subject / From / To / Cc headers unless
# these are enabled; without them the ce-* mappings above are
# dead code. Reply-To stays disabled - it is not part of the
diff --git a/kamelets/mariadb-source.kamelet.yaml
b/kamelets/mariadb-source.kamelet.yaml
index 1e3bad661..07ee19618 100644
--- a/kamelets/mariadb-source.kamelet.yaml
+++ b/kamelets/mariadb-source.kamelet.yaml
@@ -82,7 +82,7 @@ spec:
type: integer
default: 500
types:
- in:
+ out:
mediaType: application/json
dependencies:
- "camel:jackson"
diff --git a/kamelets/pdf-action.kamelet.yaml b/kamelets/pdf-action.kamelet.yaml
index f95c36422..d0ddc4a5b 100644
--- a/kamelets/pdf-action.kamelet.yaml
+++ b/kamelets/pdf-action.kamelet.yaml
@@ -41,7 +41,7 @@ spec:
title: Font
description: The font to use while generating the PDF. One of Courier,
Courier-Bold, Courier-Oblique, Courier-BoldOblique, Helvetica, Helvetica-Bold,
Helvetica-Oblique, Helvetica-BoldOblique, Times-Roman, Times-Bold,
Times-Italic, Times-BoldItalic, Symbol, ZapfDingbats
type: string
- default: Helvetica
+ default: HELVETICA
fontSize:
title: Font Size
description: The Font size to use while generating the PDF
diff --git a/kamelets/rest-openapi-sink.kamelet.yaml
b/kamelets/rest-openapi-sink.kamelet.yaml
index a14002387..e63d19b75 100644
--- a/kamelets/rest-openapi-sink.kamelet.yaml
+++ b/kamelets/rest-openapi-sink.kamelet.yaml
@@ -75,5 +75,5 @@ spec:
specificationUri: "{{specification}}"
operationId: "{{operation}}"
basePath: "{{?basePath}}"
- clientRequestValidation: "{{clientRequestValidation}}"
+ requestValidationEnabled: "{{clientRequestValidation}}"
host: "{{?host}}"
diff --git a/kamelets/salesforce-create-sink.kamelet.yaml
b/kamelets/salesforce-create-sink.kamelet.yaml
index 8b35dcb8d..c56081be1 100644
--- a/kamelets/salesforce-create-sink.kamelet.yaml
+++ b/kamelets/salesforce-create-sink.kamelet.yaml
@@ -34,6 +34,7 @@ spec:
required:
- clientId
- clientSecret
+ - sObjectName
type: object
properties:
sObjectName:
diff --git a/kamelets/scp-sink.kamelet.yaml b/kamelets/scp-sink.kamelet.yaml
index 478c67215..e540d05ca 100644
--- a/kamelets/scp-sink.kamelet.yaml
+++ b/kamelets/scp-sink.kamelet.yaml
@@ -81,7 +81,7 @@ spec:
from the classpath by default. Needed when the process has no
$HOME/.ssh/known_hosts to fall back on.
type: string
- pattern: "^(http|https|file|classpath|ref|bean)://.*"
+ pattern: "^(classpath:)?[^:]+$"
useUserKnownHostsFile:
title: Use User Known Hosts File
description: If knownHostFile has not been explicit configured then
use the host file from System.getProperty(user.home)/.ssh/known_hosts.
@@ -95,4 +95,4 @@ spec:
uri: kamelet:source
steps:
- to:
- uri:
"scp:{{serverName}}:{{serverPort}}?knownHostsUri={{?knownHostsUri}}&password=RAW({{?password}})&privateKeyFile=RAW({{?privateKeyFile}})&privateKeyPassphrase={{?privateKeyPassphrase}}&strictHostKeyChecking={{?strictHostKeyChecking}}&useUserKnownHostsFile={{?useUserKnownHostsFile}}&username=RAW({{?username}})"
+ uri:
"scp:{{serverName}}:{{serverPort}}?knownHostsFile={{?knownHostsUri}}&password=RAW({{?password}})&privateKeyFile=RAW({{?privateKeyFile}})&privateKeyFilePassphrase=RAW({{?privateKeyPassphrase}})&strictHostKeyChecking={{?strictHostKeyChecking}}&useUserKnownHostsFile={{?useUserKnownHostsFile}}&username=RAW({{?username}})"
diff --git a/kamelets/solr-source.kamelet.yaml
b/kamelets/solr-source.kamelet.yaml
index a1e04260d..07d026226 100644
--- a/kamelets/solr-source.kamelet.yaml
+++ b/kamelets/solr-source.kamelet.yaml
@@ -30,7 +30,14 @@ metadata:
spec:
definition:
title: "Solr Source"
- description: Query for documents to Solr Collection.
+ description: |-
+ Runs the same query on a collection or core of Apache Solr at a regular
interval, and sends the result of each query as one message.
+
+ Use it to watch a Solr collection on a schedule, for example to send the
documents that match a query to another system. To add documents to Solr, use
`solr-sink`.
+
+ Output: the body is JSON text, the answer of Solr: `responseHeader`, and
under `response` the list of the documents found, each with its fields. The
`Content-Type` header is `application/json`.
+
+ Good to know: every query returns all the matching documents again, not
only the new ones; filter on a date in the query to get only new documents.
Each query returns only the first documents found, 10 with the usual Solr
settings. It connects with plain HTTP.
required:
- period
- servers
@@ -40,36 +47,40 @@ spec:
properties:
period:
title: Period between Polls
- description: The interval between fetches to the Solr collection
+ description: How long to wait between two queries, in milliseconds.
For example, 60000 is one minute.
type: integer
default: 10000
+ example: 60000
collection:
title: Collection
- description: Solr Collection name
+ description: The name of the Solr collection, or of the core on a Solr
server that does not run in SolrCloud mode, to query.
type: string
+ example: products
servers:
title: Servers
- description: Comma separated list of Solr Servers and ports
+ description: The address of the Solr server, as `host:port`, without
`http://` and without the `/solr` path. The port of Solr is 8983 by default.
type: string
+ example: "solr.example.com:8983"
query:
title: Query
- description: The query to submit to Solr
+ description: The query to run, in the Solr query syntax, as given in
the `q` parameter of a Solr search, such as `*:*` for every document or
`status_s:new`.
type: string
+ example: "status_s:new"
username:
title: Username
- description: Username to connect to Solr.
+ description: The Solr user to log in as, with Basic authentication.
Leave it out for a Solr without login.
type: string
x-descriptors:
- urn:camel:group:credentials
password:
title: Password
- description: Password to connect to Solr.
+ description: The password of the Solr user in `username`.
type: string
format: password
x-descriptors:
- urn:camel:group:credentials
types:
- in:
+ out:
mediaType: application/json
dependencies:
- "camel:solr"
@@ -102,5 +113,8 @@ spec:
name: content-type
- to:
uri:
"solr:{{servers}}/solr/?password=RAW({{?password}})&username=RAW({{?username}})"
+ - marshal:
+ json:
+ library: Jackson
- to:
uri: kamelet:sink
diff --git a/kamelets/sqlserver-source.kamelet.yaml
b/kamelets/sqlserver-source.kamelet.yaml
index 4a435a6d8..7fb540627 100644
--- a/kamelets/sqlserver-source.kamelet.yaml
+++ b/kamelets/sqlserver-source.kamelet.yaml
@@ -93,7 +93,7 @@ spec:
type: integer
default: 500
types:
- in:
+ out:
mediaType: application/json
dependencies:
- "camel:jackson"
diff --git a/kamelets/xj-template-action.kamelet.yaml
b/kamelets/xj-template-action.kamelet.yaml
index ab4eb4ae7..7a5dcca96 100644
--- a/kamelets/xj-template-action.kamelet.yaml
+++ b/kamelets/xj-template-action.kamelet.yaml
@@ -30,7 +30,16 @@ metadata:
spec:
definition:
title: "XJ Template Action"
- description: Apply the XJ Template Transformation to transform JSON to XML
and XML to JSON.
+ description: |-
+ Converts each message from XML to JSON, or from JSON to XML, with an
XSLT stylesheet that decides what the result looks like.
+
+ Use it to map the XML of one system to the JSON of another, or the other
way round, when the fixed mapping of `xj-identity-action` does not give the
shape you need.
+
+ Input: XML or JSON as text, bytes or a stream, as `direction` says. With
`JSON2XML` the stylesheet sees the JSON as XML in which each value is an
`object` element with its name and type in `xj:name` and `xj:type` attributes,
such as `<object xj:name="qty" xj:type="int">2</object>`; select a field with
`object[@xj:name='qty']`.
+
+ Output: the body is JSON text or XML text. With `XML2JSON` the
stylesheet must write that same form, which becomes JSON: `<object
xj:type="object"><object xj:name="qty" xj:type="int">2</object></object>` gives
`{"qty":2}`. The prefix `xj` stands for the namespace
`http://camel.apache.org/component/xj`. The headers are kept.
+
+ Good to know: the stylesheet is loaded from a file, the classpath or a
URL given by the `template` option; it cannot come from the message.
required:
- direction
- template
@@ -38,14 +47,14 @@ spec:
properties:
direction:
title: Direction
- description: The transform direction.
+ description: "Which way to convert: `XML2JSON` turns XML into JSON,
and `JSON2XML` turns JSON into XML."
type: string
enum: ["XML2JSON", "JSON2XML"]
template:
title: Template
- description: The inline template to apply a transformation through
template.
+ description: "Where to load the XSLT stylesheet from, not the
stylesheet itself: `file://` followed by the path of a file, `classpath://`
followed by a resource in the application, or an `http://` or `https://` URL."
type: string
- example: "file:////template.vm"
+ example: "file:///opt/templates/order.xsl"
pattern: "^(http|https|file|classpath|ref|bean)://.*"
dependencies:
- "camel:xj"
@@ -55,4 +64,4 @@ spec:
uri: kamelet:source
steps:
- to:
- uri:
"xj:?resourceUri={{template}}&transformDirection={{direction}}"
+ uri: "xj:{{template}}?transformDirection={{direction}}"
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/xj-template-action.kamelet.yaml
b/kamelets/xj-template-action.kamelet.yaml.orig
similarity index 78%
copy from
library/camel-kamelets/src/main/resources/kamelets/xj-template-action.kamelet.yaml
copy to kamelets/xj-template-action.kamelet.yaml.orig
index ab4eb4ae7..6a8df5bfe 100644
---
a/library/camel-kamelets/src/main/resources/kamelets/xj-template-action.kamelet.yaml
+++ b/kamelets/xj-template-action.kamelet.yaml.orig
@@ -30,7 +30,16 @@ metadata:
spec:
definition:
title: "XJ Template Action"
- description: Apply the XJ Template Transformation to transform JSON to XML
and XML to JSON.
+ description: |-
+ Converts each message from XML to JSON, or from JSON to XML, with an
XSLT stylesheet that decides what the result looks like.
+
+ Use it to map the XML of one system to the JSON of another, or the other
way round, when the fixed mapping of `xj-identity-action` does not give the
shape you need.
+
+ Input: XML or JSON as text, bytes or a stream, as `direction` says. With
`JSON2XML` the stylesheet sees the JSON as XML in which each value is an
`object` element with its name and type in `xj:name` and `xj:type` attributes,
such as `<object xj:name="qty" xj:type="int">2</object>`; select a field with
`object[@xj:name='qty']`.
+
+ Output: the body is JSON text or XML text. With `XML2JSON` the
stylesheet must write that same form, which becomes JSON: `<object
xj:type="object"><object xj:name="qty" xj:type="int">2</object></object>` gives
`{"qty":2}`. The prefix `xj` stands for the namespace
`http://camel.apache.org/component/xj`. The headers are kept.
+
+ Good to know: the stylesheet is loaded from a file, the classpath or a
URL given by the `template` option; it cannot come from the message.
required:
- direction
- template
@@ -38,14 +47,14 @@ spec:
properties:
direction:
title: Direction
- description: The transform direction.
+ description: "Which way to convert: `XML2JSON` turns XML into JSON,
and `JSON2XML` turns JSON into XML."
type: string
enum: ["XML2JSON", "JSON2XML"]
template:
title: Template
- description: The inline template to apply a transformation through
template.
+ description: "Where to load the XSLT stylesheet from, not the
stylesheet itself: `file://` followed by the path of a file, `classpath://`
followed by a resource in the application, or an `http://` or `https://` URL."
type: string
- example: "file:////template.vm"
+ example: "file:///opt/templates/order.xsl"
pattern: "^(http|https|file|classpath|ref|bean)://.*"
dependencies:
- "camel:xj"
diff --git
a/library/camel-kamelets/src/main/resources/META-INF/kamelets-index.json
b/library/camel-kamelets/src/main/resources/META-INF/kamelets-index.json
index ab7036f4c..bad4ac38c 100644
--- a/library/camel-kamelets/src/main/resources/META-INF/kamelets-index.json
+++ b/library/camel-kamelets/src/main/resources/META-INF/kamelets-index.json
@@ -2110,7 +2110,7 @@
"type" : "source",
"supportLevel" : "Stable",
"title" : "Solr Source",
- "description" : "Query for documents to Solr Collection.",
+ "description" : "Runs the same query on a collection or core of Apache
Solr at a regular interval, and sends the result of each query as one
message.\n\nUse it to watch a Solr collection on a schedule, for example to
send the documents that match a query to another system. To add documents to
Solr, use `solr-sink`.\n\nOutput: the body is JSON text, the answer of Solr:
`responseHeader`, and under `response` the list of the documents found, each
with its fields. The `Content-Type` head [...]
"group" : "Solr",
"namespace" : "Search",
"provider" : "Apache Software Foundation"
@@ -2326,7 +2326,7 @@
"type" : "action",
"supportLevel" : "Stable",
"title" : "XJ Template Action",
- "description" : "Apply the XJ Template Transformation to transform JSON to
XML and XML to JSON.",
+ "description" : "Converts each message from XML to JSON, or from JSON to
XML, with an XSLT stylesheet that decides what the result looks like.\n\nUse it
to map the XML of one system to the JSON of another, or the other way round,
when the fixed mapping of `xj-identity-action` does not give the shape you
need.\n\nInput: XML or JSON as text, bytes or a stream, as `direction` says.
With `JSON2XML` the stylesheet sees the JSON as XML in which each value is an
`object` element with its na [...]
"group" : "Actions",
"namespace" : "Transformation",
"provider" : "Apache Software Foundation"
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/aws-bedrock-agent-sink.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/aws-bedrock-agent-sink.kamelet.yaml
index 09d914e24..10476155d 100644
---
a/library/camel-kamelets/src/main/resources/kamelets/aws-bedrock-agent-sink.kamelet.yaml
+++
b/library/camel-kamelets/src/main/resources/kamelets/aws-bedrock-agent-sink.kamelet.yaml
@@ -33,6 +33,7 @@ spec:
description: Manage the data source ingestion jobs of an AWS Bedrock
knowledge base.
required:
- knowledgeBaseId
+ - dataSourceId
- region
type: object
properties:
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/fhir-sink.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/fhir-sink.kamelet.yaml
index 729df44a7..ed6d53917 100644
--- a/library/camel-kamelets/src/main/resources/kamelets/fhir-sink.kamelet.yaml
+++ b/library/camel-kamelets/src/main/resources/kamelets/fhir-sink.kamelet.yaml
@@ -34,6 +34,7 @@ spec:
description: Forward data to a FHIR endpoint.
required:
- serverUrl
+ - apiName
- methodName
type: object
properties:
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/google-mail-source.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/google-mail-source.kamelet.yaml
index 56bb9a589..3b9a93ef1 100644
---
a/library/camel-kamelets/src/main/resources/kamelets/google-mail-source.kamelet.yaml
+++
b/library/camel-kamelets/src/main/resources/kamelets/google-mail-source.kamelet.yaml
@@ -161,7 +161,7 @@ spec:
- "camel:google-mail"
template:
from:
- uri:
"google-mail-stream://{{index}}?accessToken=RAW({{accessToken}})&applicationName={{applicationName}}&clientId={{clientId}}&clientSecret=RAW({{clientSecret}})&delay={{delay}}&labels={{labels}}&markAsRead={{markAsRead}}&query={{query}}&refreshToken=RAW({{refreshToken}})"
+ uri:
"google-mail-stream://{{index}}?accessToken=RAW({{accessToken}})&applicationName={{applicationName}}&clientId={{clientId}}&clientSecret=RAW({{clientSecret}})&delay={{delay}}&labels={{?labels}}&markAsRead={{markAsRead}}&query={{query}}&refreshToken=RAW({{refreshToken}})"
steps:
- marshal:
json: {}
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/google-storage-source.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/google-storage-source.kamelet.yaml
index d678f93ca..122dde09c 100644
---
a/library/camel-kamelets/src/main/resources/kamelets/google-storage-source.kamelet.yaml
+++
b/library/camel-kamelets/src/main/resources/kamelets/google-storage-source.kamelet.yaml
@@ -91,7 +91,7 @@ spec:
description: Default binary representation of the Google Storage
Cloud object retrieved from the bucket.
mediaType: application/octet-stream
cloudevents:
- format: "aws2-s3:application-cloudevents"
+ format: "google-storage:application-cloudevents"
description: Output data type represents Google Storage download
response as CloudEvent V1. The data type sets Camel specific CloudEvent headers
on the exchange with respective data from the Google Storage bucket and its
derived object.
headers:
CamelCloudEventID:
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/header-matches-filter-action.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/header-matches-filter-action.kamelet.yaml
index 50767a97f..10050d0f8 100644
---
a/library/camel-kamelets/src/main/resources/kamelets/header-matches-filter-action.kamelet.yaml
+++
b/library/camel-kamelets/src/main/resources/kamelets/header-matches-filter-action.kamelet.yaml
@@ -33,6 +33,7 @@ spec:
description: "Filter based on header value compared to regex."
required:
- regex
+ - headerName
properties:
regex:
title: Regex
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/jira-source.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/jira-source.kamelet.yaml
index b0622ee12..ac4c1ead4 100644
---
a/library/camel-kamelets/src/main/resources/kamelets/jira-source.kamelet.yaml
+++
b/library/camel-kamelets/src/main/resources/kamelets/jira-source.kamelet.yaml
@@ -34,6 +34,7 @@ spec:
required:
- jiraUrl
+ - jql
type: object
properties:
jiraUrl:
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/mail-sink.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/mail-sink.kamelet.yaml
index 8c6a525f9..032925e7d 100644
--- a/library/camel-kamelets/src/main/resources/kamelets/mail-sink.kamelet.yaml
+++ b/library/camel-kamelets/src/main/resources/kamelets/mail-sink.kamelet.yaml
@@ -149,7 +149,7 @@ spec:
- removeHeaders:
pattern: ce-*
- to:
- uri:
"{{protocol}}:{{connectionHost}}:{{connectionPort}}?subject={{subject}}&from={{from}}&to={{to}}&username={{username}}&password={{password}}&useHeaderSubject=true&useHeaderFrom=true&useHeaderRecipients=true"
+ uri:
"{{protocol}}:{{connectionHost}}:{{connectionPort}}?subject={{?subject}}&from={{?from}}&to={{?to}}&username={{username}}&password={{password}}&useHeaderSubject=true&useHeaderFrom=true&useHeaderRecipients=true"
# camel-mail ignores the Subject / From / To / Cc headers unless
# these are enabled; without them the ce-* mappings above are
# dead code. Reply-To stays disabled - it is not part of the
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/mariadb-source.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/mariadb-source.kamelet.yaml
index 1e3bad661..07ee19618 100644
---
a/library/camel-kamelets/src/main/resources/kamelets/mariadb-source.kamelet.yaml
+++
b/library/camel-kamelets/src/main/resources/kamelets/mariadb-source.kamelet.yaml
@@ -82,7 +82,7 @@ spec:
type: integer
default: 500
types:
- in:
+ out:
mediaType: application/json
dependencies:
- "camel:jackson"
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/pdf-action.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/pdf-action.kamelet.yaml
index f95c36422..d0ddc4a5b 100644
--- a/library/camel-kamelets/src/main/resources/kamelets/pdf-action.kamelet.yaml
+++ b/library/camel-kamelets/src/main/resources/kamelets/pdf-action.kamelet.yaml
@@ -41,7 +41,7 @@ spec:
title: Font
description: The font to use while generating the PDF. One of Courier,
Courier-Bold, Courier-Oblique, Courier-BoldOblique, Helvetica, Helvetica-Bold,
Helvetica-Oblique, Helvetica-BoldOblique, Times-Roman, Times-Bold,
Times-Italic, Times-BoldItalic, Symbol, ZapfDingbats
type: string
- default: Helvetica
+ default: HELVETICA
fontSize:
title: Font Size
description: The Font size to use while generating the PDF
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/rest-openapi-sink.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/rest-openapi-sink.kamelet.yaml
index a14002387..e63d19b75 100644
---
a/library/camel-kamelets/src/main/resources/kamelets/rest-openapi-sink.kamelet.yaml
+++
b/library/camel-kamelets/src/main/resources/kamelets/rest-openapi-sink.kamelet.yaml
@@ -75,5 +75,5 @@ spec:
specificationUri: "{{specification}}"
operationId: "{{operation}}"
basePath: "{{?basePath}}"
- clientRequestValidation: "{{clientRequestValidation}}"
+ requestValidationEnabled: "{{clientRequestValidation}}"
host: "{{?host}}"
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/salesforce-create-sink.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/salesforce-create-sink.kamelet.yaml
index 8b35dcb8d..c56081be1 100644
---
a/library/camel-kamelets/src/main/resources/kamelets/salesforce-create-sink.kamelet.yaml
+++
b/library/camel-kamelets/src/main/resources/kamelets/salesforce-create-sink.kamelet.yaml
@@ -34,6 +34,7 @@ spec:
required:
- clientId
- clientSecret
+ - sObjectName
type: object
properties:
sObjectName:
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/scp-sink.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/scp-sink.kamelet.yaml
index 478c67215..e540d05ca 100644
--- a/library/camel-kamelets/src/main/resources/kamelets/scp-sink.kamelet.yaml
+++ b/library/camel-kamelets/src/main/resources/kamelets/scp-sink.kamelet.yaml
@@ -81,7 +81,7 @@ spec:
from the classpath by default. Needed when the process has no
$HOME/.ssh/known_hosts to fall back on.
type: string
- pattern: "^(http|https|file|classpath|ref|bean)://.*"
+ pattern: "^(classpath:)?[^:]+$"
useUserKnownHostsFile:
title: Use User Known Hosts File
description: If knownHostFile has not been explicit configured then
use the host file from System.getProperty(user.home)/.ssh/known_hosts.
@@ -95,4 +95,4 @@ spec:
uri: kamelet:source
steps:
- to:
- uri:
"scp:{{serverName}}:{{serverPort}}?knownHostsUri={{?knownHostsUri}}&password=RAW({{?password}})&privateKeyFile=RAW({{?privateKeyFile}})&privateKeyPassphrase={{?privateKeyPassphrase}}&strictHostKeyChecking={{?strictHostKeyChecking}}&useUserKnownHostsFile={{?useUserKnownHostsFile}}&username=RAW({{?username}})"
+ uri:
"scp:{{serverName}}:{{serverPort}}?knownHostsFile={{?knownHostsUri}}&password=RAW({{?password}})&privateKeyFile=RAW({{?privateKeyFile}})&privateKeyFilePassphrase=RAW({{?privateKeyPassphrase}})&strictHostKeyChecking={{?strictHostKeyChecking}}&useUserKnownHostsFile={{?useUserKnownHostsFile}}&username=RAW({{?username}})"
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/solr-source.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/solr-source.kamelet.yaml
index a1e04260d..07d026226 100644
---
a/library/camel-kamelets/src/main/resources/kamelets/solr-source.kamelet.yaml
+++
b/library/camel-kamelets/src/main/resources/kamelets/solr-source.kamelet.yaml
@@ -30,7 +30,14 @@ metadata:
spec:
definition:
title: "Solr Source"
- description: Query for documents to Solr Collection.
+ description: |-
+ Runs the same query on a collection or core of Apache Solr at a regular
interval, and sends the result of each query as one message.
+
+ Use it to watch a Solr collection on a schedule, for example to send the
documents that match a query to another system. To add documents to Solr, use
`solr-sink`.
+
+ Output: the body is JSON text, the answer of Solr: `responseHeader`, and
under `response` the list of the documents found, each with its fields. The
`Content-Type` header is `application/json`.
+
+ Good to know: every query returns all the matching documents again, not
only the new ones; filter on a date in the query to get only new documents.
Each query returns only the first documents found, 10 with the usual Solr
settings. It connects with plain HTTP.
required:
- period
- servers
@@ -40,36 +47,40 @@ spec:
properties:
period:
title: Period between Polls
- description: The interval between fetches to the Solr collection
+ description: How long to wait between two queries, in milliseconds.
For example, 60000 is one minute.
type: integer
default: 10000
+ example: 60000
collection:
title: Collection
- description: Solr Collection name
+ description: The name of the Solr collection, or of the core on a Solr
server that does not run in SolrCloud mode, to query.
type: string
+ example: products
servers:
title: Servers
- description: Comma separated list of Solr Servers and ports
+ description: The address of the Solr server, as `host:port`, without
`http://` and without the `/solr` path. The port of Solr is 8983 by default.
type: string
+ example: "solr.example.com:8983"
query:
title: Query
- description: The query to submit to Solr
+ description: The query to run, in the Solr query syntax, as given in
the `q` parameter of a Solr search, such as `*:*` for every document or
`status_s:new`.
type: string
+ example: "status_s:new"
username:
title: Username
- description: Username to connect to Solr.
+ description: The Solr user to log in as, with Basic authentication.
Leave it out for a Solr without login.
type: string
x-descriptors:
- urn:camel:group:credentials
password:
title: Password
- description: Password to connect to Solr.
+ description: The password of the Solr user in `username`.
type: string
format: password
x-descriptors:
- urn:camel:group:credentials
types:
- in:
+ out:
mediaType: application/json
dependencies:
- "camel:solr"
@@ -102,5 +113,8 @@ spec:
name: content-type
- to:
uri:
"solr:{{servers}}/solr/?password=RAW({{?password}})&username=RAW({{?username}})"
+ - marshal:
+ json:
+ library: Jackson
- to:
uri: kamelet:sink
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/sqlserver-source.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/sqlserver-source.kamelet.yaml
index 4a435a6d8..7fb540627 100644
---
a/library/camel-kamelets/src/main/resources/kamelets/sqlserver-source.kamelet.yaml
+++
b/library/camel-kamelets/src/main/resources/kamelets/sqlserver-source.kamelet.yaml
@@ -93,7 +93,7 @@ spec:
type: integer
default: 500
types:
- in:
+ out:
mediaType: application/json
dependencies:
- "camel:jackson"
diff --git
a/library/camel-kamelets/src/main/resources/kamelets/xj-template-action.kamelet.yaml
b/library/camel-kamelets/src/main/resources/kamelets/xj-template-action.kamelet.yaml
index ab4eb4ae7..7a5dcca96 100644
---
a/library/camel-kamelets/src/main/resources/kamelets/xj-template-action.kamelet.yaml
+++
b/library/camel-kamelets/src/main/resources/kamelets/xj-template-action.kamelet.yaml
@@ -30,7 +30,16 @@ metadata:
spec:
definition:
title: "XJ Template Action"
- description: Apply the XJ Template Transformation to transform JSON to XML
and XML to JSON.
+ description: |-
+ Converts each message from XML to JSON, or from JSON to XML, with an
XSLT stylesheet that decides what the result looks like.
+
+ Use it to map the XML of one system to the JSON of another, or the other
way round, when the fixed mapping of `xj-identity-action` does not give the
shape you need.
+
+ Input: XML or JSON as text, bytes or a stream, as `direction` says. With
`JSON2XML` the stylesheet sees the JSON as XML in which each value is an
`object` element with its name and type in `xj:name` and `xj:type` attributes,
such as `<object xj:name="qty" xj:type="int">2</object>`; select a field with
`object[@xj:name='qty']`.
+
+ Output: the body is JSON text or XML text. With `XML2JSON` the
stylesheet must write that same form, which becomes JSON: `<object
xj:type="object"><object xj:name="qty" xj:type="int">2</object></object>` gives
`{"qty":2}`. The prefix `xj` stands for the namespace
`http://camel.apache.org/component/xj`. The headers are kept.
+
+ Good to know: the stylesheet is loaded from a file, the classpath or a
URL given by the `template` option; it cannot come from the message.
required:
- direction
- template
@@ -38,14 +47,14 @@ spec:
properties:
direction:
title: Direction
- description: The transform direction.
+ description: "Which way to convert: `XML2JSON` turns XML into JSON,
and `JSON2XML` turns JSON into XML."
type: string
enum: ["XML2JSON", "JSON2XML"]
template:
title: Template
- description: The inline template to apply a transformation through
template.
+ description: "Where to load the XSLT stylesheet from, not the
stylesheet itself: `file://` followed by the path of a file, `classpath://`
followed by a resource in the application, or an `http://` or `https://` URL."
type: string
- example: "file:////template.vm"
+ example: "file:///opt/templates/order.xsl"
pattern: "^(http|https|file|classpath|ref|bean)://.*"
dependencies:
- "camel:xj"
@@ -55,4 +64,4 @@ spec:
uri: kamelet:source
steps:
- to:
- uri:
"xj:?resourceUri={{template}}&transformDirection={{direction}}"
+ uri: "xj:{{template}}?transformDirection={{direction}}"