Update from SAP DITA CMS (squashed):

commit aea5b648ff9f6d8737466820fcd2ac44d2acc664
Author: REDACTED
Date:   Wed Jan 22 14:45:53 2025 +0000

    Update from SAP DITA CMS 2025-01-22 14:45:53

    Project: dita-all/nih1586262997200
    Project map: baa817af5a7c4aa798ad5d2792ae0111.ditamap
    Output: loio0f341afe0f5e4107ad982c53bfc412dc
    Language: en-US
    Builddable map: 6dd68ae2cfea4cdf8ba6b96497472829.ditamap

commit 6238f4f25b601fa37c06c79b3b277de6653ce8a7
Author: REDACTED
Date:   Wed Jan 22 09:52:30 2025 +0000

    Update from SAP DITA CMS 2025-01-22 09:52:30

    Project: dita-all/nih1586262997200
    Project map: baa817af5a7c4aa798ad5d2792ae0111.ditamap
    Output: loio0f341afe0f5e4107ad982c53bfc412dc
    Language: en-US
    Builddable map: 6dd68ae2cfea4cdf8ba6b96497472829.ditamap

commit 1ded3700b772531b7ff0992c6bf8eb1393483bdc
Author: REDACTED
Date:   Wed Jan 22 09:26:26 2025 +0000

    Update from SAP DITA CMS 2025-01-22 09:26:26

    Project: dita-all/nih1586262997200
    Project map: baa817af5a7c4aa798ad5d2792ae0111.ditamap

##################################################
[Remaining squash message was removed before commit...]

Author: ditaccms-bot

docs/01_required_setup/role-collections-e1915af.md

@@ -4,7 +4,13 @@
 
 Role collections in SAP Cloud ALM are delivered predefined and ready to use.
 
-Each application role in SAP Cloud ALM represents a role collection in your SAP BTP subaccount. Most SAP Cloud ALM role collections correspond 1:1 to the respective role template and can be assigned to users without any further configuration.
+
+
+
+
+### 
+
+In general, each application role in SAP Cloud ALM represents a role collection in your SAP BTP subaccount. This means that most SAP Cloud ALM role collections correspond 1:1 to the respective role template and can be assigned to users without any further configuration.
 
 Each application role contains all the necessary authorizations that are required for all tasks that belong to a certain business role, rather than being confined to a single task. For example, the role *Health Monitoring Administrator* also contains authorizations in apps other than *Health Monitoring* because someone in that role also needs to be able to configure events and set up notifications.
 
@@ -659,7 +665,7 @@ Project Management
 
 Manage projects, deployment plans, tasks, scopes, requirements, features, documents, test cases, defects, tags, and SAP Readiness Check analyses. View process hierarchy nodes.
 
-The permissions within implementation projects of users with this role additionally depend on the access level of the project and the team assignment. For more information, refer to [Configuring Project User Permissions](https://help.sap.com/docs/cloud-alm/setup-administration/project-user-permissions).
+The permissions of users with this role additionally depend on the access level of the project and the team assignment. For more information, refer to [Configuring Project User Permissions](https://help.sap.com/docs/cloud-alm/setup-administration/project-user-permissions).
 
 </td>
 <td valign="top">
@@ -693,7 +699,7 @@ Project Management
 
 Manage projects, deployment plans, tasks, scopes, requirements, features, documents, test cases, and defects. View process hierarchy nodes and SAP Readiness Check analyses.
 
-The permissions within implementation projects of users with this role additionally depend on the access level of the project and the team assignment. For more information, refer to [Configuring Project User Permissions](https://help.sap.com/docs/cloud-alm/setup-administration/project-user-permissions).
+The permissions of users with this role additionally depend on the access level of the project and the team assignment. For more information, refer to [Configuring Project User Permissions](https://help.sap.com/docs/cloud-alm/setup-administration/project-user-permissions).
 
 </td>
 <td valign="top">
@@ -727,7 +733,7 @@ Project Management
 
 Manage tasks, scopes, requirements, features \([with restrictions](https://help.sap.com/docs/cloud-alm/applicationhelp/features#roles-and-authorizations)\), documents, test cases, and defects. View projects, deployment plans, SAP Readiness Check analyses, and process hierarchy nodes.
 
-The permissions within implementation projects of users with this role additionally depend on the access level of the project and the team assignment. For more information, refer to [Configuring Project User Permissions](https://help.sap.com/docs/cloud-alm/setup-administration/project-user-permissions).
+The permissions of users with this role additionally depend on the access level of the project and the team assignment. For more information, refer to [Configuring Project User Permissions](https://help.sap.com/docs/cloud-alm/setup-administration/project-user-permissions).
 
 </td>
 <td valign="top">
@@ -761,7 +767,7 @@ Project Management
 
 View projects, deployment plans, tasks, scopes, process hierarchy nodes, requirements, features, documents, test cases, defects, and SAP Readiness Check analyses
 
-The permissions within implementation projects of users with this role additionally depend on the access level of the project and the team assignment. For more information, refer to [Configuring Project User Permissions](https://help.sap.com/docs/cloud-alm/setup-administration/project-user-permissions).
+The permissions of users with this role additionally depend on the access level of the project and the team assignment. For more information, refer to [Configuring Project User Permissions](https://help.sap.com/docs/cloud-alm/setup-administration/project-user-permissions).
 
 </td>
 <td valign="top">
@@ -1569,7 +1575,9 @@ Service Collaboration
 </td>
 <td valign="top">
 
-Execute service-specific administration tasks, configure and execute services, and view service execution results
+Maintain tenant mapping for receiving service information in your SAP Cloud ALM tenant. View all service information, collaborate in service delivery, and follow up on issues and actions.
+
+Users with this role additionally require the *Project Administrator* role.
 
 </td>
 <td valign="top">
@@ -1601,7 +1609,9 @@ Service Collaboration
 </td>
 <td valign="top">
 
-Configure and execute services, and view own and shared service execution results
+View all service information, collaborate in service delivery, and follow up on issues and actions.
+
+Users with this role additionally require the *Project Member* role.
 
 </td>
 <td valign="top">
@@ -1633,7 +1643,9 @@ Service Collaboration
 </td>
 <td valign="top">
 
-Browse through the service explorer and view the shared service execution results
+View all service information, including preparation tasks, notes, attachments, service results, and issues and actions.
+
+Users with this role additionally require the *Project Viewer* role.
 
 </td>
 <td valign="top">

docs/02_integration_and_config_options/connecting-sap-document-management-service-b788f20.md

@@ -15,7 +15,12 @@ If you want to upload [External Files](https://help.sap.com/docs/cloud-alm/appli
 
 ## Prerequisites
 
--   You need to provide your own SAP Document Management service instance and establish a connection to SAP Cloud ALM. For more information, see [Initial Setup for Document Management Service, Integration Option](https://help.sap.com/docs/document-management-service/sap-document-management-service/initial-setup-for-document-management-service-integration-option?version=Cloud). You can use an existing service instance for SAP Cloud ALM use.
+-   You need to provide your own SAP Document Management service instance and establish a connection to SAP Cloud ALM. For more information, see [Initial Setup for Document Management Service, Integration Option](https://help.sap.com/docs/document-management-service/sap-document-management-service/initial-setup-for-document-management-service-integration-option?version=Cloud).
+
+    > ### Note:  
+    > Do not use your SAP Cloud ALM global account. It should be a global account for SAP BTP DMS.
+
+    You can use an existing service instance for SAP Cloud ALM use.
 
 -   You've done the initial setup for the SAP Document Management integration option and you've obtained all the necessary login data.
 

docs/02_integration_and_config_options/enabling-sap-cloud-alm-api-704b5dc.md

@@ -84,15 +84,18 @@ To consume the selected service plan, you need to create a service instance.
 
 4.  Choose *Next*.
 
-5.  Paste the following JSON code into the text editor:
+5.  \(Optional\) If you want to use the service binding to access APIs, you need to add the appropriate scopes to it. You can find an overview of all available scopes and their use cases under [API Scopes](https://help.sap.com/viewer/fe419bfabbdc46dfbddbfd78b21483d5/latest/en-US/a111fd3cdaef4f36801eb43fff23ef20.html "") :arrow_upper_right:.
+
+    To add the scopes, insert the following JSON and replace the relevant parameters with your instance name and the required scopes, respectively.
 
     ```
     {
         "xs-security": {
             "xsappname": "<your-instance-name>",
             "authorities": [
-               "$XSMASTERAPPNAME.imp-cdm-feature-display-ui",
-               "$XSMASTERAPPNAME.imp-cdm-feature-manage-ui"
+               "<Required Scope 1>",
+               "<Required Scope 2>",
+               "<Required Scope 3>"
             ],
             "oauth2-configuration": {
                 "credential-types": [
@@ -104,11 +107,9 @@ To consume the selected service plan, you need to create a service instance.
     
     ```
 
-6.  Replace `<your-instance-name>` with your instance name you've created in step 3 of the *Create or Update an Instance* section of this guide.
-
-7.  Choose *Create*.
+6.  Choose *Create*.
 
-8.  When your instance has been created or updated, click on it.
+7.  When your instance has been created or updated, click on it.
 
 
 

docs/02_integration_and_config_options/enabling-sap-cloud-alm-api-in-cloud-foundry-7d4c180.md

@@ -118,24 +118,24 @@ To consume the selected service plan, you need to create a service instance in y
 
 6.  Choose *Next*.
 
-7.  Paste the following JSON code into the text editor:
+7.  \(Optional\) If you want to use the service key to access APIs, you need to add the appropriate scopes to it. You can find an overview of all available scopes and their use cases under [API Scopes](https://help.sap.com/viewer/fe419bfabbdc46dfbddbfd78b21483d5/latest/en-US/a111fd3cdaef4f36801eb43fff23ef20.html "") :arrow_upper_right:.
+
+    To add the scopes, insert the following JSON and replace the relevant parameters with your instance name and the required scopes, respectively.
 
     ```
     {
         "xs-security": {
             "xsappname": "<your-instance-name>",
             "authorities": [
-    			"$XSMASTERAPPNAME.imp-cdm-feature-display-ui",
-    			"$XSMASTERAPPNAME.imp-cdm-feature-manage-ui"
+    			"<Required Scope 1>",
+    			"<Required Scope 2>"
             ]
         }
     }
     
     ```
 
-8.  Replace `<your-instance-name>` with your instance name that you've created in step 5 of the *Create or Update an Instance* section of this guide.
-
-9.  Choose *Create*.
+8.  Choose *Create*.
 
 
 

docs/02_integration_and_config_options/integrating-sap-central-business-configuration-e21f915.md

@@ -8,7 +8,7 @@ By integrating SAP Central Business Configuration with SAP Cloud ALM, you can im
 
 SAP Central Business Configuration \(CBC\) is a solution that supports the configuration of SAP S/4HANA Cloud Public Edition. SAP S/4HANA Cloud Private Edition is not supported.
 
-While an SAP Cloud ALM project applies the SAP Activate methodology to provide end-to-end procedural guidance on how to start and execute an implementation project, an SAP Central Business Configuration project shows the project and configuration activities focused on your specific business configuration.
+While an SAP Cloud ALM project applies the SAP Activate methodology to provide end-to-end procedural guidance on how to start and execute an implementation project, an SAP Central Business Configuration workspace shows the project and configuration activities focused on your specific business configuration.
 
 To use SAP Central Business Configuration in SAP Cloud ALM, you first need to carry out the following setup procedure.
 
@@ -77,9 +77,9 @@ After you've completed the technical setup, select SAP Central Business Configur
         ![](images/CBC_Project-Creation_4b7a778.png)
 
 
-5.  Select the SAP Central Business Configuration project or projects that you want to connect to SAP Cloud ALM.
+5.  Select the SAP Central Business Configuration workspace or workspaces that you want to connect to SAP Cloud ALM.
 
-    You can unassign SAP Central Business Configuration projects from the corresponding SAP Cloud ALM project at any time.
+    You can unassign SAP Central Business Configuration workspaces from the corresponding SAP Cloud ALM project at any time.
 
 6.  Save the new project.
 
@@ -90,9 +90,9 @@ After you've completed the technical setup, select SAP Central Business Configur
 
 ## Result and Next Steps
 
-You have now connected your SAP Central Business Configuration project or projects with your SAP Cloud ALM project.
+You have now connected your SAP Central Business Configuration workspace or workspaces with your SAP Cloud ALM project.
 
-You can now navigate to your SAP Central Business Configuration project with the direct links in the table or via the respective tasks.
+You can now navigate to your SAP Central Business Configuration workspace with the direct links in the table or via the respective tasks.
 
 
 

docs/02_integration_and_config_options/integration-and-configuration-options-a4ea6fa.md

@@ -27,10 +27,10 @@ Learn how to enable the transport management of different transport environments
 -   **[Integrating Test Automation Providers](integrating-test-automation-providers-82b04bb.md "In addition to manual testing, which is performed directly in SAP Cloud ALM, you can
 		also integrate SAP and third-party test automation providers with SAP Cloud ALM.")**  
 In addition to manual testing, which is performed directly in SAP Cloud ALM, you can also integrate SAP and third-party test automation providers with SAP Cloud ALM.
--   **[Enabling Service Delivery](enabling-service-delivery-a1b2494.md "An SAP service is usually delivered as part of a service contract like SAP MaxAttention,
-		SAP ActiveAttention or SAP Enterprise Support.")**  
-An SAP service is usually delivered as part of a service contract like SAP MaxAttention, SAP ActiveAttention or SAP Enterprise Support.
 -   **[Connecting SAP Document Management Service](connecting-sap-document-management-service-b788f20.md "You can integrate and activate the SAP Document Management service for
 			document storage in SAP Cloud ALM.")**  
 You can integrate and activate the SAP Document Management service for document storage in SAP Cloud ALM.
+-   **[Enabling Service Delivery](enabling-service-delivery-a1b2494.md "An SAP service is usually delivered as part of a service contract like SAP MaxAttention,
+		SAP ActiveAttention or SAP Enterprise Support.")**  
+An SAP service is usually delivered as part of a service contract like SAP MaxAttention, SAP ActiveAttention or SAP Enterprise Support.
 

docs/02_integration_and_config_options/managing-your-service-credentials-87b7851.md

@@ -61,6 +61,17 @@ If no service credentials have been uploaded yet, you can add it as follows:
 
 10. Upload the TXT file containing the service credentials.
 
+    Make sure that the file has the following characteristics:
+
+    -   The service key in the TXT file is in valid JSON format.
+
+    -   The service key belongs to the SAP Cloud ALM tenant you're working in. Verify the field `uaa.identityzone`.
+
+    -   The service key contains the fields `uaa.clientid` and `uaa.clientsecret`.
+
+    -   The value for the field `uaa.credential-type` is `instance-secret`.
+
+
     > ### Note:  
     > -   You can only upload one service key or binding for this SAP Cloud ALM tenant.
     > 

docs/02_integration_and_config_options/sap-cloud-transport-management-service-8b4af2f.md

@@ -31,6 +31,8 @@ To use the transport capabilities of SAP Cloud ALM with the SAP Cloud Transport
 
     For more information about the general setup, refer to [Initial Setup of SAP Cloud Integration in the Cloud Foundry Environment](https://help.sap.com/docs/CLOUD_INTEGRATION/368c481cd6954bdfa5d0435479fd4eaf/302b47b11e1749c3aa9478f4123fc216.html).
 
+-   You've created a service key for SAP Cloud Transport Management service. For more information, see [Creating a Service Instance and a Service Key](https://help.sap.com/docs/cloud-transport-management/sap-cloud-transport-management/creating-service-instance-and-service-key?version=Cloud).
+
 -   You've familiarized yourself with how to use the [SAP Business Technology Platform \(SAP BTP\)](https://help.sap.com/viewer/product/BTP/Cloud/en-US?task=discover_task) cockpit, in particular [Account Administration](https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/5d62ec89de39442f8f31d527855cbced.html) concepts.
 
 -   You've subscribed to the SAP Cloud Transport Management service and your user has the required transport management roles *Transport Management Viewer* and *Transport Management Operator*.
@@ -126,7 +128,7 @@ To use the transport capabilities of SAP Cloud ALM with the SAP Cloud Transport
         </td>
         <td valign="top">
         
-        Value of `uri` from the service key of your SAP Cloud Transport Management service instance.
+        Value of `uri` from the service key of your SAP Cloud Transport Management service instance. For example: https://transport-service-app-backend.ts.cfapps.euXX.hana.ondemand.com
 
         </td>
         </tr>
@@ -186,7 +188,7 @@ To use the transport capabilities of SAP Cloud ALM with the SAP Cloud Transport
         </td>
         <td valign="top">
         
-        Value of `URL` \(`uaa` section\) from the service key of your SAP Cloud Transport Management service instance. For example: https://transport-service-app-backend.ts.cfapps.euXX.hana.ondemand.com
+        Value of `URL` \(`uaa` section\) from the service key of your SAP Cloud Transport Management service instance.
 
         Append `/oauth/token` to the `URL` retrieved from the service key. For example: https://YYY.authentication.euXX.hana.ondemand.com/oauth/token
 
@@ -372,7 +374,7 @@ We strongly advise you against using the existing integration within the SAP BTP
     </tr>
     </table>
 
-    Additional information about how to set up the HTTP destination, please have a look at the following information: [Creating HTTP Destinations and Transport Route](https://help.sap.com/docs/CLOUD_INTEGRATION/368c481cd6954bdfa5d0435479fd4eaf/270f353a5b69472696617d91ceb58c93.html) Go to the *Cloud Transport Management* tab.
+    For additional information on how to set up the HTTP destination, see [Creating HTTP Destinations and Transport Route](https://help.sap.com/docs/CLOUD_INTEGRATION/368c481cd6954bdfa5d0435479fd4eaf/270f353a5b69472696617d91ceb58c93.html) under the *Cloud Transport Management* tab.
 
     In the URL section for the endpoint, enter the URL of your SAP Cloud ALM API instance that follows the pattern `https://<tenant name>.<region>.alm.cloud.sap/api/imp-cdm-transport-management-api/v1`. The first part of the URL until `/api` depends on your company account and is variable.