{"ref":"artifact:sap-samples-xsa-cap-migration-using-basextn","page":"/artifacts/sap-samples-xsa-cap-migration-using-basextn","json":"/artifacts/sap-samples-xsa-cap-migration-using-basextn.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"sap-samples-xsa-cap-migration-using-basextn","name":"xsa-cap-migration-using-basextn","artifact_type":"sample","ecosystem":"cap","domain":"operations-and-runtime","origin_ring":"sap-official","use_as":"reference","description":{"one_line":"A step-by-step guide to migrating an XS Advanced application's database artefacts to the Cloud Application Programming Model with the SAP HANA Application Migration extension.","short":"Guide to migrating XS Advanced database artefacts to CAP","what_it_solves":"Runs through creating a dev space with the SAP HANA Application Migration extension in [SAP Business Application Studio](artifact:btp-business-application-studio) or SAP Build, connecting it to the source system through the [Cloud Connector](artifact:sap-cloud-connector) and an SAP BTP destination, and converting XS Advanced database objects such as `.hdbcds`, `.hdbtable` and `.hdbview` files into CAP CDS models renamed for [SAP HANA Cloud](artifact:btp-hana-cloud) conventions. A generative-AI step reads the `.xsodata`, `.xsjs` and `.xsjslib` files and drafts a `service.cds`, a `service.js` and custom handlers under the CAP `srv/` layer; the README restricts that step to SAP Build plans, calls it experimental, and states the converted output is not guaranteed to be 100% runnable or semantically equivalent. The walkthrough runs on the [hana-shine-xsa](artifact:sap-samples-hana-shine-xsa) demo application, lists the post-migration changes the extension does not make, among them the `mta.yaml` rewrite multiple containers need, and ends by deploying the migrated database artefacts as an MTA. Its stated scope is the database artefacts: the README says the sample covers only their migration, with the service-layer step and the manual validation it needs written up beside that note."},"links":{"repo":"https://github.com/SAP-samples/xsa-cap-migration-using-basextn"},"identity":{"license":"Apache-2.0"},"source_available":true,"demonstrates":["capability:platform-migration"],"requires":[{"ref":"artifact:sap-cloud-connector","for":"reaching the on-premise XS Advanced source database from the BTP subaccount, with a TCP mapping to the HANA system behind a virtual host.","sources":[{"url":"https://github.com/SAP-samples/xsa-cap-migration-using-basextn","title":"SAP-samples/xsa-cap-migration-using-basextn — README, Step-1","checked":"2026-10-19","quote":"Install the [SAP Cloud Connector](https://tools.hana.ondemand.com/#cloud) on your local system."}]},{"ref":"artifact:btp-hana-cloud","for":"the database the migrated CAP application targets, and the HDI container the converted artefacts are deployed into.","sources":[{"url":"https://github.com/SAP-samples/xsa-cap-migration-using-basextn","title":"SAP-samples/xsa-cap-migration-using-basextn — README, Description","checked":"2026-10-19","quote":"The SAP HANA Application Migration Extension allows users to migrate XS Advanced application to a SAP CAP application with SAP HANA Cloud as a database."}]},{"ref":"artifact:btp-business-application-studio","for":"the dev space the SAP HANA Application Migration extension is installed into and the migration wizard is run from.","requirement":"conditional","condition":"SAP Business Application Studio is the chosen platform; the README also names SAP Build, which its service-layer conversion requires, and Visual Studio Code in vscode.md.","sources":[{"url":"https://github.com/SAP-samples/xsa-cap-migration-using-basextn","title":"SAP-samples/xsa-cap-migration-using-basextn — README, Step-3","checked":"2026-10-19","quote":"In the SAP BTP subaccount where you created the destination, create a subscription to SAP Business Application Studio (BAS) or SAP Build."},{"url":"https://github.com/SAP-samples/xsa-cap-migration-using-basextn","title":"SAP-samples/xsa-cap-migration-using-basextn — README, Choose Your Development Platform","checked":"2026-10-19","quote":"The SAP HANA Application Migration extension supports two development platforms:"}]}],"maintainers":["actor:sap-samples"],"drafted_with_ai":true,"provenance":{"discovered_via":[{"source":"source:curator"}],"first_seen":"2026-09-14"},"contributors":["actor:ajinkyapatil8190","actor:kesavanking","actor:lalithmanokar","actor:priyankashivakumar","actor:yashika-gulati"]},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"unknown","evidence":"no release data"},{"label":"Continuity","tier":"good","evidence":"7 contributors, org-owned"},{"label":"Repository","tier":"good","evidence":"pushed 2026-06, 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":"8 test files"},{"label":"Docs","tier":"good","evidence":"README 27 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":null,"unit":"installs/week"},{"value":6,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-25","npm":"not published under this name","stars":6,"forks":1,"open_issues":2,"archived":false,"pushed_at":"2026-06-11","license_spdx":"Apache-2.0","org_owned":true,"default_branch":"main","created_at":"2024-10-16T07:23:47Z","open_prs":1,"tree_truncated":false,"test_files":8,"workflows":0,"other_ci":false,"readme_bytes":28129,"docs_files":0,"changelog":false,"license_file":true,"dts_files":0,"first_commit":"2024-10-16","last_commit":"2026-03-30","commits":87,"contributors":7,"readme_path":"README.md","readme_sha":"43d5864a9441ceeb5ebed2cb4416055e60603b2a","repo_read":"2026-10-25"},"edges":{"maintainers":[{"ref":"actor:sap-samples","name":"SAP Samples","json":"/actors/sap-samples.json"}],"contributors":[{"ref":"actor:ajinkyapatil8190","name":"Ajinkya Patil","json":"/actors/ajinkyapatil8190.json"},{"ref":"actor:kesavanking","name":"Kesavan","json":"/actors/kesavanking.json"},{"ref":"actor:lalithmanokar","name":"LalithManokar","json":"/actors/lalithmanokar.json"},{"ref":"actor:priyankashivakumar","name":"Priyanka R S","json":"/actors/priyankashivakumar.json"},{"ref":"actor:yashika-gulati","name":"yashika-Gulati","json":"/actors/yashika-gulati.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}