docs(adms): document integration test env vars and fix wrong field names

- Add ADMS placeholder block to .env_integration_tests.example so reviewers
  know which env vars to set for external/BTP mode.
- Correct the env var names in conftest docstring and INTEGRATION_TESTS_ADMS.md:
  the loader expects CLIENTID / CLIENTSECRET / URL / URI (matching the IAS
  binding field names used by destination/), not the underscored CLIENT_ID /
  IAS_URL / SERVICE_URL variants — those would have failed with KeyError.
- Add the optional RESOURCE entry (IAS resource URI) the docs were missing.
- Rename leftover "DMS Integration Tests" heading to "ADMS Integration Tests".

Author: adwitiyasushant

.env_integration_tests.example

@@ -25,3 +25,13 @@ CLOUD_SDK_CFG_SDM_DEFAULT_UAA='{"url":"https://your-auth-url","clientid":"your-c
 
 CLOUD_SDK_CFG_HANA_AGENT_MEMORY_DEFAULT_APPLICATION_URL=https://your-agent-memory-api-url-here
 CLOUD_SDK_CFG_HANA_AGENT_MEMORY_DEFAULT_UAA='{"url":"https://your-auth-url","clientid":"your-client-id","clientsecret":"your-client-secret"}'
+
+# ADMS (Advanced Document Management Service) — external/BTP integration tests.
+# Set CLOUD_SDK_ADMS_INTEGRATION_URL to switch the test fixtures from local
+# HDM auto-start to a deployed ADMS instance.
+CLOUD_SDK_ADMS_INTEGRATION_URL=https://your-adm-host.cfapps.eu20.hana.ondemand.com
+CLOUD_SDK_CFG_ADMS_DEFAULT_CLIENTID=your-adms-client-id-here
+CLOUD_SDK_CFG_ADMS_DEFAULT_CLIENTSECRET=your-adms-client-secret-here
+CLOUD_SDK_CFG_ADMS_DEFAULT_URL=https://your-tenant.accounts.ondemand.com
+CLOUD_SDK_CFG_ADMS_DEFAULT_URI=https://your-adm-host.cfapps.eu20.hana.ondemand.com
+CLOUD_SDK_CFG_ADMS_DEFAULT_RESOURCE=urn:sap:identity:application:provider:name:your-adm-app-name

docs/INTEGRATION_TESTS_ADMS.md

@@ -1,4 +1,4 @@
-# DMS Integration Tests
+# ADMS Integration Tests
 
 End-to-end tests that verify the `sap_cloud_sdk.adms` module is correctly wired to a running **SAP Advanced Document Management (ADM / HDM)** server.
 
@@ -45,10 +45,11 @@ HDM startup takes ~30–60 seconds on first run. The server is kept alive for th
 
 ```bash
 export CLOUD_SDK_ADMS_INTEGRATION_URL=https://your-adm.cfapps.eu20.hana.ondemand.com
-export CLOUD_SDK_CFG_ADMS_DEFAULT_SERVICE_URL=$CLOUD_SDK_ADMS_INTEGRATION_URL
-export CLOUD_SDK_CFG_ADMS_DEFAULT_IAS_URL=https://your-tenant.accounts.ondemand.com
-export CLOUD_SDK_CFG_ADMS_DEFAULT_CLIENT_ID=...
-export CLOUD_SDK_CFG_ADMS_DEFAULT_CLIENT_SECRET=...
+export CLOUD_SDK_CFG_ADMS_DEFAULT_URL=https://your-tenant.accounts.ondemand.com
+export CLOUD_SDK_CFG_ADMS_DEFAULT_URI=$CLOUD_SDK_ADMS_INTEGRATION_URL
+export CLOUD_SDK_CFG_ADMS_DEFAULT_CLIENTID=...
+export CLOUD_SDK_CFG_ADMS_DEFAULT_CLIENTSECRET=...
+export CLOUD_SDK_CFG_ADMS_DEFAULT_RESOURCE=urn:sap:identity:application:provider:name:your-app
 
 .venv/bin/python -m pytest tests/adms/integration/ -m integration -v
 ```

tests/adms/integration/conftest.py

@@ -1,5 +1,5 @@
 """
-Pytest fixtures for DMS end-to-end integration tests.
+Pytest fixtures for ADMS end-to-end integration tests.
 
 Two modes are supported — controlled by environment variables:
 
@@ -10,9 +10,11 @@
   env-var pattern (CLOUD_SDK_CFG_ADMS_DEFAULT_*).
 
     export CLOUD_SDK_ADMS_INTEGRATION_URL=https://your-adm.cfapps.eu20.hana.ondemand.com
-    export CLOUD_SDK_CFG_ADMS_DEFAULT_IAS_URL=https://your-tenant.accounts.ondemand.com
-    export CLOUD_SDK_CFG_ADMS_DEFAULT_CLIENT_ID=...
-    export CLOUD_SDK_CFG_ADMS_DEFAULT_CLIENT_SECRET=...
+    export CLOUD_SDK_CFG_ADMS_DEFAULT_URL=https://your-tenant.accounts.ondemand.com
+    export CLOUD_SDK_CFG_ADMS_DEFAULT_URI=https://your-adm.cfapps.eu20.hana.ondemand.com
+    export CLOUD_SDK_CFG_ADMS_DEFAULT_CLIENTID=...
+    export CLOUD_SDK_CFG_ADMS_DEFAULT_CLIENTSECRET=...
+    export CLOUD_SDK_CFG_ADMS_DEFAULT_RESOURCE=urn:sap:identity:application:provider:name:your-app
 
   MODE 2 — Local HDM server (auto-started)
   -----------------------------------------