From 4f9839406e37bd203b1b4a1a3cbd797bbfc0f3ff Mon Sep 17 00:00:00 2001 From: I548646 Date: Tue, 30 Dec 2025 10:53:54 +0100 Subject: [PATCH 1/5] feat: add warning about known limitation --- node.js/fiori.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/node.js/fiori.md b/node.js/fiori.md index 94ee6c181..287160114 100644 --- a/node.js/fiori.md +++ b/node.js/fiori.md @@ -67,6 +67,10 @@ The `NEW` event is triggered when the user created a new draft. As a result `MyEntity.drafts` is created in the database. You can modify the initial draft data in a `before` handler. +:::warning Warning: Known Limitation! +Due to an implementation detail of the [`hdb` HANA driver](https://www.npmjs.com/package/hdb), trying to `INSERT` draft entities with fields that use the [`LargeBinary` type](https://cap.cloud.sap/docs/cds/types#core-built-in-types) will cause a deadlock. +Unfortunately, the only currently known workaround is to [configure your CAP app](../guides/databases-hana#setup-configuration) to use the [`hana-client` HANA driver](https://www.npmjs.com/package/@sap/hana-client) instead. +::: ### `EDIT` From 949029870ac1041093185ecfec8f88727363f5ba Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ren=C3=A9=20Jeglinsky?= Date: Wed, 7 Jan 2026 15:11:38 +0100 Subject: [PATCH 2/5] Apply suggestion from @renejeglinsky --- node.js/fiori.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/node.js/fiori.md b/node.js/fiori.md index 287160114..4a75fb9c2 100644 --- a/node.js/fiori.md +++ b/node.js/fiori.md @@ -69,7 +69,7 @@ You can modify the initial draft data in a `before` handler. :::warning Warning: Known Limitation! Due to an implementation detail of the [`hdb` HANA driver](https://www.npmjs.com/package/hdb), trying to `INSERT` draft entities with fields that use the [`LargeBinary` type](https://cap.cloud.sap/docs/cds/types#core-built-in-types) will cause a deadlock. -Unfortunately, the only currently known workaround is to [configure your CAP app](../guides/databases-hana#setup-configuration) to use the [`hana-client` HANA driver](https://www.npmjs.com/package/@sap/hana-client) instead. +Unfortunately, the only currently known workaround is to [configure your CAP app](../guides/databases/hana#setup-configuration) to use the [`hana-client` HANA driver](https://www.npmjs.com/package/@sap/hana-client) instead. ::: ### `EDIT` From f9502a0703244aa9cf3abe73dc754e2b53a6186e Mon Sep 17 00:00:00 2001 From: Paul Date: Thu, 8 Jan 2026 11:20:00 +0100 Subject: [PATCH 3/5] fix: adjust warning headline MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: René Jeglinsky --- node.js/fiori.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/node.js/fiori.md b/node.js/fiori.md index 4a75fb9c2..67c5c2329 100644 --- a/node.js/fiori.md +++ b/node.js/fiori.md @@ -67,7 +67,7 @@ The `NEW` event is triggered when the user created a new draft. As a result `MyEntity.drafts` is created in the database. You can modify the initial draft data in a `before` handler. -:::warning Warning: Known Limitation! +:::warning Known Limitation Due to an implementation detail of the [`hdb` HANA driver](https://www.npmjs.com/package/hdb), trying to `INSERT` draft entities with fields that use the [`LargeBinary` type](https://cap.cloud.sap/docs/cds/types#core-built-in-types) will cause a deadlock. Unfortunately, the only currently known workaround is to [configure your CAP app](../guides/databases/hana#setup-configuration) to use the [`hana-client` HANA driver](https://www.npmjs.com/package/@sap/hana-client) instead. ::: From f65c2ca5bdcec506e78e15e07ba5ab358e9465f4 Mon Sep 17 00:00:00 2001 From: Paul Date: Thu, 8 Jan 2026 11:20:48 +0100 Subject: [PATCH 4/5] feat: identify sap MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: René Jeglinsky --- node.js/fiori.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/node.js/fiori.md b/node.js/fiori.md index 67c5c2329..a6f5f7f87 100644 --- a/node.js/fiori.md +++ b/node.js/fiori.md @@ -69,7 +69,7 @@ You can modify the initial draft data in a `before` handler. :::warning Known Limitation Due to an implementation detail of the [`hdb` HANA driver](https://www.npmjs.com/package/hdb), trying to `INSERT` draft entities with fields that use the [`LargeBinary` type](https://cap.cloud.sap/docs/cds/types#core-built-in-types) will cause a deadlock. -Unfortunately, the only currently known workaround is to [configure your CAP app](../guides/databases/hana#setup-configuration) to use the [`hana-client` HANA driver](https://www.npmjs.com/package/@sap/hana-client) instead. +The known workaround is to [configure your CAP app](../guides/databases/hana#setup-configuration) to use the [`hana-client` SAP HANA driver](https://www.npmjs.com/package/@sap/hana-client) instead. ::: ### `EDIT` From ed36e0e0e753bd56e36325716a5b795cba49d0e2 Mon Sep 17 00:00:00 2001 From: Paul Date: Thu, 8 Jan 2026 11:21:06 +0100 Subject: [PATCH 5/5] fix: use relative link MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: René Jeglinsky --- node.js/fiori.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/node.js/fiori.md b/node.js/fiori.md index a6f5f7f87..eed9479cc 100644 --- a/node.js/fiori.md +++ b/node.js/fiori.md @@ -68,7 +68,7 @@ As a result `MyEntity.drafts` is created in the database. You can modify the initial draft data in a `before` handler. :::warning Known Limitation -Due to an implementation detail of the [`hdb` HANA driver](https://www.npmjs.com/package/hdb), trying to `INSERT` draft entities with fields that use the [`LargeBinary` type](https://cap.cloud.sap/docs/cds/types#core-built-in-types) will cause a deadlock. +With the [`hdb` SAP HANA driver](https://www.npmjs.com/package/hdb), trying to `INSERT` draft entities with fields that use the [`LargeBinary` type](../cds/types#core-built-in-types) will cause a deadlock. The known workaround is to [configure your CAP app](../guides/databases/hana#setup-configuration) to use the [`hana-client` SAP HANA driver](https://www.npmjs.com/package/@sap/hana-client) instead. :::