From 8b9a474005574d53988fe81fcd01c265c3242c78 Mon Sep 17 00:00:00 2001 From: D050513 Date: Fri, 8 Aug 2025 16:09:26 +0200 Subject: [PATCH 1/3] UCL docs for Node.js --- node.js/_menu.md | 1 + node.js/platform-services.md | 57 ++++++++++++++++++++++++++++++++++++ 2 files changed, 58 insertions(+) create mode 100644 node.js/platform-services.md diff --git a/node.js/_menu.md b/node.js/_menu.md index db335c82e..7629fe2f7 100644 --- a/node.js/_menu.md +++ b/node.js/_menu.md @@ -32,6 +32,7 @@ ## [Class cds. MessagingService](messaging) ## [Class cds. DatabaseService](databases) ## [Serving Fiori UIs](fiori) + ## [Platform Services](platform-services) # [cds. Events](events) diff --git a/node.js/platform-services.md b/node.js/platform-services.md new file mode 100644 index 000000000..bee79627f --- /dev/null +++ b/node.js/platform-services.md @@ -0,0 +1,57 @@ +--- +label: Platform Services +synopsis: > + Platform services provide CAP-level integrations to technical components of SAP BTP. +#status: released +--- + +# Platform Services + +
+ +[[toc]] + + +## Unified Customer Landscape (UCL) + + +The CAP integration with the Unified Customer Landscape (UCL) makes it easy to plug into UCL´s Tenant Mapping API (aka Service Provider Integration Interface (SPII)). +This is required if your application shall participate in UCL formations and exchange configuration data with other participants of the formation. + +BLA BLA BLA + +Activate `UCLService` via: + +```jsonc +"cds": { + "requires": { + "ucl": true + } +} +``` + +Implement `assign` and `unassign` callbacks as follows: + +```js +const cds = require('@sap/cds') + +cds.on('served', async () => { + const ucl = await cds.connect.to('ucl') + ucl.on('assign', async function(req) { + // execute assign procedure + + return { + state: 'READY', + configuration: { ... } + } + }) + ucl.on('unassign', async function(req) { + // execute unassign procedure + + return { + state: 'READY', + configuration: { ... } + } + }) +}) +``` From ddbae6bdefab6c6602a288ed70b588abc57c09dc Mon Sep 17 00:00:00 2001 From: D050513 Date: Fri, 8 Aug 2025 16:19:04 +0200 Subject: [PATCH 2/3] ucl fragment --- node.js/platform-services.md | 44 +----------------------------------- 1 file changed, 1 insertion(+), 43 deletions(-) diff --git a/node.js/platform-services.md b/node.js/platform-services.md index bee79627f..da7dc6acf 100644 --- a/node.js/platform-services.md +++ b/node.js/platform-services.md @@ -12,46 +12,4 @@ synopsis: > [[toc]] -## Unified Customer Landscape (UCL) - - -The CAP integration with the Unified Customer Landscape (UCL) makes it easy to plug into UCL´s Tenant Mapping API (aka Service Provider Integration Interface (SPII)). -This is required if your application shall participate in UCL formations and exchange configuration data with other participants of the formation. - -BLA BLA BLA - -Activate `UCLService` via: - -```jsonc -"cds": { - "requires": { - "ucl": true - } -} -``` - -Implement `assign` and `unassign` callbacks as follows: - -```js -const cds = require('@sap/cds') - -cds.on('served', async () => { - const ucl = await cds.connect.to('ucl') - ucl.on('assign', async function(req) { - // execute assign procedure - - return { - state: 'READY', - configuration: { ... } - } - }) - ucl.on('unassign', async function(req) { - // execute unassign procedure - - return { - state: 'READY', - configuration: { ... } - } - }) -}) -``` +
From e85a47ea7cbb1f475c66e3aec7c5f87d9bb9c68f Mon Sep 17 00:00:00 2001 From: Rene Jeglinsky Date: Tue, 12 Aug 2025 12:10:55 +0200 Subject: [PATCH 3/3] adjust --- node.js/_menu.md | 2 +- node.js/platform-services.md | 15 --------------- 2 files changed, 1 insertion(+), 16 deletions(-) delete mode 100644 node.js/platform-services.md diff --git a/node.js/_menu.md b/node.js/_menu.md index 7629fe2f7..569f0a606 100644 --- a/node.js/_menu.md +++ b/node.js/_menu.md @@ -32,7 +32,7 @@ ## [Class cds. MessagingService](messaging) ## [Class cds. DatabaseService](databases) ## [Serving Fiori UIs](fiori) - ## [Platform Services](platform-services) + ## [Platform Services](../../node.js/platform-services) # [cds. Events](events) diff --git a/node.js/platform-services.md b/node.js/platform-services.md deleted file mode 100644 index da7dc6acf..000000000 --- a/node.js/platform-services.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -label: Platform Services -synopsis: > - Platform services provide CAP-level integrations to technical components of SAP BTP. -#status: released ---- - -# Platform Services - -
- -[[toc]] - - -