This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new 509fc859c468 camel-docling: document that html_split_page cannot be
used (#29720)
509fc859c468 is described below
commit 509fc859c4681eac7cd4edcc61ed930f3e762f6e
Author: WMK666666 <[email protected]>
AuthorDate: Fri Nov 13 15:25:00 2026 +0800
camel-docling: document that html_split_page cannot be used (#29720)
---
.../org/apache/camel/catalog/components/docling.json | 4 ++--
.../org/apache/camel/component/docling/docling.json | 4 ++--
.../camel/component/docling/DoclingConfiguration.java | 5 +++--
.../component/dsl/DoclingComponentBuilderFactory.java | 5 ++++-
.../endpoint/dsl/DoclingEndpointBuilderFactory.java | 15 ++++++++++++---
5 files changed, 23 insertions(+), 10 deletions(-)
diff --git
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/docling.json
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/docling.json
index 9220ecae9be9..3a85690006bf 100644
---
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/docling.json
+++
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/docling.json
@@ -31,7 +31,7 @@
"includeLayoutInfo": { "index": 4, "kind": "property", "displayName":
"Include Layout Info", "group": "common", "label": "", "required": false,
"type": "boolean", "javaType": "boolean", "deprecated": false, "autowired":
false, "secret": false, "defaultValue": false, "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Show layout information
with bounding boxes" },
"ocrLanguage": { "index": 5, "kind": "property", "displayName": "Ocr
Language", "group": "common", "label": "", "required": false, "type": "string",
"javaType": "java.lang.String", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": "en", "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Language code for OCR
processing" },
"operation": { "index": 6, "kind": "property", "displayName": "Operation",
"group": "common", "label": "", "required": true, "type": "enum", "javaType":
"org.apache.camel.component.docling.DoclingOperations", "enum": [
"CONVERT_TO_MARKDOWN", "CONVERT_TO_HTML", "CONVERT_TO_JSON", "EXTRACT_TEXT",
"EXTRACT_STRUCTURED_DATA", "SUBMIT_ASYNC_CONVERSION",
"CHECK_CONVERSION_STATUS", "BATCH_CONVERT_TO_MARKDOWN",
"BATCH_CONVERT_TO_HTML", "BATCH_CONVERT_TO_JSON", "BATCH_EXTRACT_TEXT",
"BATCH_EXT [...]
- "outputFormat": { "index": 7, "kind": "property", "displayName": "Output
Format", "group": "common", "label": "", "required": false, "type": "string",
"javaType": "java.lang.String", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": "markdown", "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Output format for
document conversion" },
+ "outputFormat": { "index": 7, "kind": "property", "displayName": "Output
Format", "group": "common", "label": "", "required": false, "type": "string",
"javaType": "java.lang.String", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": "markdown", "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Output format of the
SUBMIT_ASYNC_CONVERSION operation; the other operations always [...]
"useDoclingServe": { "index": 8, "kind": "property", "displayName": "Use
Docling Serve", "group": "common", "label": "", "required": false, "type":
"boolean", "javaType": "boolean", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": false, "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Use docling-serve API
instead of CLI command" },
"bridgeErrorHandler": { "index": 9, "kind": "property", "displayName":
"Bridge Error Handler", "group": "consumer", "label": "consumer", "required":
false, "type": "boolean", "javaType": "boolean", "deprecated": false,
"autowired": false, "secret": false, "defaultValue": false, "description":
"Allows for bridging the consumer to the Camel routing Error Handler, which
mean any exceptions (if possible) occurred while the Camel consumer is trying
to pickup incoming messages, or the like [...]
"lazyStartProducer": { "index": 10, "kind": "property", "displayName":
"Lazy Start Producer", "group": "producer", "label": "producer", "required":
false, "type": "boolean", "javaType": "boolean", "deprecated": false,
"autowired": false, "secret": false, "defaultValue": false, "description":
"Whether the producer should be started lazy (on the first message). By
starting lazy you can use this to allow CamelContext and routes to startup in
situations where a producer may otherwise fai [...]
@@ -134,7 +134,7 @@
"includeLayoutInfo": { "index": 4, "kind": "parameter", "displayName":
"Include Layout Info", "group": "common", "label": "", "required": false,
"type": "boolean", "javaType": "boolean", "deprecated": false, "autowired":
false, "secret": false, "defaultValue": false, "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Show layout information
with bounding boxes" },
"ocrLanguage": { "index": 5, "kind": "parameter", "displayName": "Ocr
Language", "group": "common", "label": "", "required": false, "type": "string",
"javaType": "java.lang.String", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": "en", "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Language code for OCR
processing" },
"operation": { "index": 6, "kind": "parameter", "displayName":
"Operation", "group": "common", "label": "", "required": true, "type": "enum",
"javaType": "org.apache.camel.component.docling.DoclingOperations", "enum": [
"CONVERT_TO_MARKDOWN", "CONVERT_TO_HTML", "CONVERT_TO_JSON", "EXTRACT_TEXT",
"EXTRACT_STRUCTURED_DATA", "SUBMIT_ASYNC_CONVERSION",
"CHECK_CONVERSION_STATUS", "BATCH_CONVERT_TO_MARKDOWN",
"BATCH_CONVERT_TO_HTML", "BATCH_CONVERT_TO_JSON", "BATCH_EXTRACT_TEXT",
"BATCH_EX [...]
- "outputFormat": { "index": 7, "kind": "parameter", "displayName": "Output
Format", "group": "common", "label": "", "required": false, "type": "string",
"javaType": "java.lang.String", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": "markdown", "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Output format for
document conversion" },
+ "outputFormat": { "index": 7, "kind": "parameter", "displayName": "Output
Format", "group": "common", "label": "", "required": false, "type": "string",
"javaType": "java.lang.String", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": "markdown", "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Output format of the
SUBMIT_ASYNC_CONVERSION operation; the other operations alway [...]
"useDoclingServe": { "index": 8, "kind": "parameter", "displayName": "Use
Docling Serve", "group": "common", "label": "", "required": false, "type":
"boolean", "javaType": "boolean", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": false, "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Use docling-serve API
instead of CLI command" },
"sendEmptyMessageWhenIdle": { "index": 9, "kind": "parameter",
"displayName": "Send Empty Message When Idle", "group": "consumer", "label":
"consumer", "required": false, "type": "boolean", "javaType": "boolean",
"deprecated": false, "autowired": false, "secret": false, "defaultValue":
false, "description": "If the polling consumer did not poll any files, you can
enable this option to send an empty message (no body) instead." },
"bridgeErrorHandler": { "index": 10, "kind": "parameter", "displayName":
"Bridge Error Handler", "group": "consumer (advanced)", "label":
"consumer,advanced", "required": false, "type": "boolean", "javaType":
"boolean", "deprecated": false, "autowired": false, "secret": false,
"defaultValue": false, "description": "Allows for bridging the consumer to the
Camel routing Error Handler, which mean any exceptions (if possible) occurred
while the Camel consumer is trying to pickup incoming [...]
diff --git
a/components/camel-ai/camel-docling/src/generated/resources/META-INF/org/apache/camel/component/docling/docling.json
b/components/camel-ai/camel-docling/src/generated/resources/META-INF/org/apache/camel/component/docling/docling.json
index 9220ecae9be9..3a85690006bf 100644
---
a/components/camel-ai/camel-docling/src/generated/resources/META-INF/org/apache/camel/component/docling/docling.json
+++
b/components/camel-ai/camel-docling/src/generated/resources/META-INF/org/apache/camel/component/docling/docling.json
@@ -31,7 +31,7 @@
"includeLayoutInfo": { "index": 4, "kind": "property", "displayName":
"Include Layout Info", "group": "common", "label": "", "required": false,
"type": "boolean", "javaType": "boolean", "deprecated": false, "autowired":
false, "secret": false, "defaultValue": false, "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Show layout information
with bounding boxes" },
"ocrLanguage": { "index": 5, "kind": "property", "displayName": "Ocr
Language", "group": "common", "label": "", "required": false, "type": "string",
"javaType": "java.lang.String", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": "en", "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Language code for OCR
processing" },
"operation": { "index": 6, "kind": "property", "displayName": "Operation",
"group": "common", "label": "", "required": true, "type": "enum", "javaType":
"org.apache.camel.component.docling.DoclingOperations", "enum": [
"CONVERT_TO_MARKDOWN", "CONVERT_TO_HTML", "CONVERT_TO_JSON", "EXTRACT_TEXT",
"EXTRACT_STRUCTURED_DATA", "SUBMIT_ASYNC_CONVERSION",
"CHECK_CONVERSION_STATUS", "BATCH_CONVERT_TO_MARKDOWN",
"BATCH_CONVERT_TO_HTML", "BATCH_CONVERT_TO_JSON", "BATCH_EXTRACT_TEXT",
"BATCH_EXT [...]
- "outputFormat": { "index": 7, "kind": "property", "displayName": "Output
Format", "group": "common", "label": "", "required": false, "type": "string",
"javaType": "java.lang.String", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": "markdown", "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Output format for
document conversion" },
+ "outputFormat": { "index": 7, "kind": "property", "displayName": "Output
Format", "group": "common", "label": "", "required": false, "type": "string",
"javaType": "java.lang.String", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": "markdown", "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Output format of the
SUBMIT_ASYNC_CONVERSION operation; the other operations always [...]
"useDoclingServe": { "index": 8, "kind": "property", "displayName": "Use
Docling Serve", "group": "common", "label": "", "required": false, "type":
"boolean", "javaType": "boolean", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": false, "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Use docling-serve API
instead of CLI command" },
"bridgeErrorHandler": { "index": 9, "kind": "property", "displayName":
"Bridge Error Handler", "group": "consumer", "label": "consumer", "required":
false, "type": "boolean", "javaType": "boolean", "deprecated": false,
"autowired": false, "secret": false, "defaultValue": false, "description":
"Allows for bridging the consumer to the Camel routing Error Handler, which
mean any exceptions (if possible) occurred while the Camel consumer is trying
to pickup incoming messages, or the like [...]
"lazyStartProducer": { "index": 10, "kind": "property", "displayName":
"Lazy Start Producer", "group": "producer", "label": "producer", "required":
false, "type": "boolean", "javaType": "boolean", "deprecated": false,
"autowired": false, "secret": false, "defaultValue": false, "description":
"Whether the producer should be started lazy (on the first message). By
starting lazy you can use this to allow CamelContext and routes to startup in
situations where a producer may otherwise fai [...]
@@ -134,7 +134,7 @@
"includeLayoutInfo": { "index": 4, "kind": "parameter", "displayName":
"Include Layout Info", "group": "common", "label": "", "required": false,
"type": "boolean", "javaType": "boolean", "deprecated": false, "autowired":
false, "secret": false, "defaultValue": false, "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Show layout information
with bounding boxes" },
"ocrLanguage": { "index": 5, "kind": "parameter", "displayName": "Ocr
Language", "group": "common", "label": "", "required": false, "type": "string",
"javaType": "java.lang.String", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": "en", "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Language code for OCR
processing" },
"operation": { "index": 6, "kind": "parameter", "displayName":
"Operation", "group": "common", "label": "", "required": true, "type": "enum",
"javaType": "org.apache.camel.component.docling.DoclingOperations", "enum": [
"CONVERT_TO_MARKDOWN", "CONVERT_TO_HTML", "CONVERT_TO_JSON", "EXTRACT_TEXT",
"EXTRACT_STRUCTURED_DATA", "SUBMIT_ASYNC_CONVERSION",
"CHECK_CONVERSION_STATUS", "BATCH_CONVERT_TO_MARKDOWN",
"BATCH_CONVERT_TO_HTML", "BATCH_CONVERT_TO_JSON", "BATCH_EXTRACT_TEXT",
"BATCH_EX [...]
- "outputFormat": { "index": 7, "kind": "parameter", "displayName": "Output
Format", "group": "common", "label": "", "required": false, "type": "string",
"javaType": "java.lang.String", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": "markdown", "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Output format for
document conversion" },
+ "outputFormat": { "index": 7, "kind": "parameter", "displayName": "Output
Format", "group": "common", "label": "", "required": false, "type": "string",
"javaType": "java.lang.String", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": "markdown", "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Output format of the
SUBMIT_ASYNC_CONVERSION operation; the other operations alway [...]
"useDoclingServe": { "index": 8, "kind": "parameter", "displayName": "Use
Docling Serve", "group": "common", "label": "", "required": false, "type":
"boolean", "javaType": "boolean", "deprecated": false, "autowired": false,
"secret": false, "defaultValue": false, "configurationClass":
"org.apache.camel.component.docling.DoclingConfiguration",
"configurationField": "configuration", "description": "Use docling-serve API
instead of CLI command" },
"sendEmptyMessageWhenIdle": { "index": 9, "kind": "parameter",
"displayName": "Send Empty Message When Idle", "group": "consumer", "label":
"consumer", "required": false, "type": "boolean", "javaType": "boolean",
"deprecated": false, "autowired": false, "secret": false, "defaultValue":
false, "description": "If the polling consumer did not poll any files, you can
enable this option to send an empty message (no body) instead." },
"bridgeErrorHandler": { "index": 10, "kind": "parameter", "displayName":
"Bridge Error Handler", "group": "consumer (advanced)", "label":
"consumer,advanced", "required": false, "type": "boolean", "javaType":
"boolean", "deprecated": false, "autowired": false, "secret": false,
"defaultValue": false, "description": "Allows for bridging the consumer to the
Camel routing Error Handler, which mean any exceptions (if possible) occurred
while the Camel consumer is trying to pickup incoming [...]
diff --git
a/components/camel-ai/camel-docling/src/main/java/org/apache/camel/component/docling/DoclingConfiguration.java
b/components/camel-ai/camel-docling/src/main/java/org/apache/camel/component/docling/DoclingConfiguration.java
index cbd70eb54da8..35494251f4c1 100644
---
a/components/camel-ai/camel-docling/src/main/java/org/apache/camel/component/docling/DoclingConfiguration.java
+++
b/components/camel-ai/camel-docling/src/main/java/org/apache/camel/component/docling/DoclingConfiguration.java
@@ -52,8 +52,9 @@ public class DoclingConfiguration implements Cloneable {
private String ocrLanguage = "en";
@UriParam
- @Metadata(description = "Output format for document conversion",
defaultValue = "markdown",
- enums = "md,json,html,html_split_page,text,doctags")
+ @Metadata(description = "Output format of the SUBMIT_ASYNC_CONVERSION
operation; the other operations always use their own format. The
html_split_page value is rejected, as docling-serve does not return the split
pages; use html instead",
+ defaultValue = "markdown",
+ enums = "markdown,md,json,html,html_split_page,text,doctags")
private String outputFormat = "markdown";
@UriParam(label = "advanced")
diff --git
a/dsl/camel-componentdsl/src/generated/java/org/apache/camel/builder/component/dsl/DoclingComponentBuilderFactory.java
b/dsl/camel-componentdsl/src/generated/java/org/apache/camel/builder/component/dsl/DoclingComponentBuilderFactory.java
index adcc1b513bbe..8414dc652f2a 100644
---
a/dsl/camel-componentdsl/src/generated/java/org/apache/camel/builder/component/dsl/DoclingComponentBuilderFactory.java
+++
b/dsl/camel-componentdsl/src/generated/java/org/apache/camel/builder/component/dsl/DoclingComponentBuilderFactory.java
@@ -172,7 +172,10 @@ public interface DoclingComponentBuilderFactory {
/**
- * Output format for document conversion.
+ * Output format of the SUBMIT_ASYNC_CONVERSION operation; the other
+ * operations always use their own format. The html_split_page value is
+ * rejected, as docling-serve does not return the split pages; use html
+ * instead.
*
* The option is a: <code>java.lang.String</code> type.
*
diff --git
a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/DoclingEndpointBuilderFactory.java
b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/DoclingEndpointBuilderFactory.java
index cdf416663bb0..5ad441f0354e 100644
---
a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/DoclingEndpointBuilderFactory.java
+++
b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/DoclingEndpointBuilderFactory.java
@@ -202,7 +202,10 @@ public interface DoclingEndpointBuilderFactory {
return this;
}
/**
- * Output format for document conversion.
+ * Output format of the SUBMIT_ASYNC_CONVERSION operation; the other
+ * operations always use their own format. The html_split_page value is
+ * rejected, as docling-serve does not return the split pages; use html
+ * instead.
*
* The option is a: <code>java.lang.String</code> type.
*
@@ -2286,7 +2289,10 @@ public interface DoclingEndpointBuilderFactory {
return this;
}
/**
- * Output format for document conversion.
+ * Output format of the SUBMIT_ASYNC_CONVERSION operation; the other
+ * operations always use their own format. The html_split_page value is
+ * rejected, as docling-serve does not return the split pages; use html
+ * instead.
*
* The option is a: <code>java.lang.String</code> type.
*
@@ -3774,7 +3780,10 @@ public interface DoclingEndpointBuilderFactory {
return this;
}
/**
- * Output format for document conversion.
+ * Output format of the SUBMIT_ASYNC_CONVERSION operation; the other
+ * operations always use their own format. The html_split_page value is
+ * rejected, as docling-serve does not return the split pages; use html
+ * instead.
*
* The option is a: <code>java.lang.String</code> type.
*
