{"ref":"artifact:miyasuta-blog-bookshop","page":"/artifacts/miyasuta-blog-bookshop","json":"/artifacts/miyasuta-blog-bookshop.json","generated":"2026-11-15","drafted_with_ai":true,"entity":{"id":"miyasuta-blog-bookshop","name":"blog-bookshop","artifact_type":"sample","ecosystem":"cap","domain":"ui-and-frontend-bridge","origin_ring":"independent","use_as":"reference","description":{"one_line":"A CAP service with a Fiori elements UI deployed whole to Cloud Foundry: an approuter, an HTML5 deployer, a launchpad content deployer and xs-security.json beside the db and srv modules in one mta.yaml.","short":"CAP bookshop with Fiori elements UI deployed whole to Cloud Foundry","what_it_solves":"Six modules sit in the one mta.yaml: the CAP service and its HDI deployer, the UI generated by SAP Fiori tools as an html5 module, [@sap/approuter](artifact:sap-approuter) as the entry point that routes /v2/catalog to the srv-api destination, a deployer that uploads the built app to the [SAP HTML5 Application Repository service for SAP BTP](artifact:btp-html5-application-repository), and a portal content deployer whose CommonDataModel.json is what makes the app appear in a Cloud Foundry launchpad. SAP Fiori tools reads the service over /v2, so the project puts the OData V2 adapter proxy in front of the V4 endpoint. It is a 2020 project and pinned like one: [@sap/cds](artifact:sap-cds) at ^4, the V2 proxy at ^1.4.44, the HANA client as a dependency for the deployed database and the cds kind sql for development. [Developing a Fiori elements app with CAP and Fiori Tools](content:developing-a-fiori-elements-app-with-cap-and-fiori-tools) is the walkthrough it was written for."},"links":{"repo":"https://github.com/miyasuta/blog-bookshop"},"compat":{"runtimes":["node"],"deployment":["cf"]},"type_properties":{"form":{"value":"tutorial","sources":[{"url":"https://community.sap.com/t5/technology-blog-posts-by-members/developing-a-fiori-elements-app-with-cap-and-fiori-tools/ba-p/13487547","title":"Developing a Fiori elements app with CAP and Fiori Tools — SAP Community","checked":"2026-10-19","quote":"In this blog, I'm going to share how I have achieved these requirements.\nThe source code is available at GitHub ."},{"url":"https://github.com/miyasuta/blog-bookshop","title":"miyasuta/blog-bookshop on GitHub","checked":"2026-10-19","quote":"Developing a Fiori elements app with CAP and Fiori Tools"}]}},"demonstrates":["capability:fiori-annotations","capability:deployment"],"requires":[{"ref":"artifact:cap-js-community-odata-v2-adapter","for":"The V2 endpoint SAP Fiori tools reads, put in front of the service's own V4 one; the project depends on it under its former name, @sap/cds-odata-v2-adapter-proxy.","requirement":"required","sources":[{"url":"https://raw.githubusercontent.com/miyasuta/blog-bookshop/master/package.json","title":"miyasuta/blog-bookshop — package.json","checked":"2026-10-19","quote":"\"@sap/cds-odata-v2-adapter-proxy\": \"^1.4.44\""},{"url":"https://community.sap.com/t5/technology-blog-posts-by-members/developing-a-fiori-elements-app-with-cap-and-fiori-tools/ba-p/13487547","title":"Developing a Fiori elements app with CAP and Fiori Tools — SAP Community","checked":"2026-10-19","quote":"As we are going to use Fiori Tools, the OData service needs to be adapted to v2 (Fiori tools currently do not fully support OData v4).\nFor this, we use @sap/cds-odata-v2-adapter-proxy"}]},{"ref":"artifact:sap-approuter","for":"The entry point in front of the application, which routes the requests under /v2/catalog to the CAP service and forwards the auth token to it.","requirement":"required","sources":[{"url":"https://community.sap.com/t5/technology-blog-posts-by-members/developing-a-fiori-elements-app-with-cap-and-fiori-tools/ba-p/13487547","title":"Developing a Fiori elements app with CAP and Fiori Tools — SAP Community","checked":"2026-10-19","quote":"redirects requests containing path /v2/catalog to srv-api destination"},{"url":"https://raw.githubusercontent.com/miyasuta/blog-bookshop/master/mta.yaml","title":"miyasuta/blog-bookshop — mta.yaml","checked":"2026-10-19","quote":"- name: bookshop-app-router\n   type: approuter.nodejs\n   path: approuter"}]},{"ref":"artifact:btp-html5-application-repository","for":"Where the built UI module is uploaded to and served from; the MTA binds the app-host plan to the deployer and the app-runtime plan to the approuter.","requirement":"required","sources":[{"url":"https://community.sap.com/t5/technology-blog-posts-by-members/developing-a-fiori-elements-app-with-cap-and-fiori-tools/ba-p/13487547","title":"Developing a Fiori elements app with CAP and Fiori Tools — SAP Community","checked":"2026-10-19","quote":"Deployer module will upload html5 app to HTML5 Application Repository."},{"url":"https://raw.githubusercontent.com/miyasuta/blog-bookshop/master/mta.yaml","title":"miyasuta/blog-bookshop — mta.yaml","checked":"2026-10-19","quote":"- name: bookshop_html5_repo_host\n   type: org.cloudfoundry.managed-service\n   parameters:\n     service-plan: app-host\n     service: html5-apps-repo"}]},{"ref":"artifact:btp-authorization-and-trust-management","for":"The UI module's xs-app.json sets authenticationType xsuaa for the HTML5 Application Repository route, so an xsuaa instance built from the project's xs-security.json is bound to the approuter.","requirement":"required","sources":[{"url":"https://community.sap.com/t5/technology-blog-posts-by-members/developing-a-fiori-elements-app-with-cap-and-fiori-tools/ba-p/13487547","title":"Developing a Fiori elements app with CAP and Fiori Tools — SAP Community","checked":"2026-10-19","quote":"We have specified in bookshopapp/webapp/xs-app.json that HTML5 Application Repository requires user authentication as below, so we need XSUAA service instance bound to Approuter."},{"url":"https://raw.githubusercontent.com/miyasuta/blog-bookshop/master/mta.yaml","title":"miyasuta/blog-bookshop — mta.yaml","checked":"2026-10-19","quote":"- name: bookshop_uaa\n   type: org.cloudfoundry.managed-service\n   parameters:\n     path: ./xs-security.json\n     service-plan: application\n     service: xsuaa"}]},{"ref":"artifact:btp-cloud-portal","for":"What the launchpad module's content is deployed into, and what the app runs in once deployed; the MTA binds a portal instance on the standard plan to the approuter and to the launchpad deployer.","requirement":"required","sources":[{"url":"https://community.sap.com/t5/technology-blog-posts-by-members/developing-a-fiori-elements-app-with-cap-and-fiori-tools/ba-p/13487547","title":"Developing a Fiori elements app with CAP and Fiori Tools — SAP Community","checked":"2026-10-19","quote":"6. Add Launchpad module\nThis module is necessary for the app to be able to run in CF Launchpad."},{"url":"https://raw.githubusercontent.com/miyasuta/blog-bookshop/master/mta.yaml","title":"miyasuta/blog-bookshop — mta.yaml","checked":"2026-10-19","quote":"- name: bookshop_portal\n   type: org.cloudfoundry.managed-service\n   parameters:\n     service-plan: standard\n     service: portal"}]}],"maintainers":["actor:mio-yasutake"],"contributors":["actor:mio-yasutake"],"provenance":{"discovered_via":[{"source":"source:github-orgs","channel":"miyasuta"}],"first_seen":"2026-10-08"},"drafted_with_ai":true},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"unknown","evidence":"no release data"},{"label":"Continuity","tier":"fair","evidence":"one contributor, personally owned"},{"label":"Repository","tier":"poor","evidence":"pushed 2020-09, not archived"}],"compatibility":[{"label":"Declared for","tier":"fair","evidence":"nothing declared"},{"label":"Survived majors","tier":"unknown","evidence":"no release dates"},{"label":"Maintainer's CI","tier":"fair","evidence":"no CI configured"}],"practice":[{"label":"Tests","tier":"good","evidence":"4 test files"},{"label":"Docs","tier":"poor","evidence":"README 1 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":null,"unit":"installs/week"},{"value":4,"unit":"watching"}]},"signals":{"crawled_at":"2026-11-13","npm":"not published under this name","stars":4,"forks":13,"open_issues":1,"archived":false,"pushed_at":"2020-09-05","license_spdx":null,"org_owned":false,"default_branch":"master","created_at":"2020-09-05T00:32:48Z","open_prs":0,"tree_truncated":false,"test_files":4,"workflows":0,"other_ci":false,"readme_bytes":674,"docs_files":0,"changelog":false,"license_file":false,"dts_files":0,"first_commit":"2020-09-05","last_commit":"2020-09-05","commits":2,"contributors":1,"readme_path":"README.md","readme_sha":"be0b6d2fb1ccb80b646079ae6e54178496b53301","repo_read":"2026-11-13","language":"JavaScript"},"edges":{"maintainers":[{"ref":"actor:mio-yasutake","name":"Mio Yasutake","json":"/actors/mio-yasutake.json"}],"contributors":[{"ref":"actor:mio-yasutake","name":"Mio Yasutake","json":"/actors/mio-yasutake.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}