Update from SAP DITA CMS (squashed):

commit 6317ccc997f55627dcc61135ebd8942e9ceea4dd
Author: REDACTED
Date:   Wed Mar 5 15:21:40 2025 +0000

    Update from SAP DITA CMS 2025-03-05 15:21:40

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

commit 64b96545b6b5dc396395a3c21925e6de846907a2
Author: REDACTED
Date:   Wed Mar 5 14:40:14 2025 +0000

    Update from SAP DITA CMS 2025-03-05 14:40:14

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

commit 9f61e0d5f87b5d2f2ba69c3288b697b1e2c3a80e
Author: REDACTED
Date:   Wed Mar 5 13:40:01 2025 +0000

    Update from SAP DITA CMS 2025-03-05 13:40:00

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

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

Author: ditaccms-bot

docs/01_required_setup/required-setup-for-sap-cloud-alm-80b2c30.md

@@ -55,9 +55,7 @@ Identity Authentication tenant
 
 *Administrator*
 
-If a new Identity Authentication tenant was created for you when you requested SAP Cloud ALM, you've automatically received the required roles in the Identity Authentication tenant.
-
-If someone else requested SAP Cloud ALM or if you're using a pre-existing Identity Authentication tenant for SAP Cloud ALM, the [administrator](https://iamtenants.accounts.cloud.sap/) can add you as an administrator by following the steps described in [Managing Administrators in Identity Authentication](https://help.sap.com/docs/IDENTITY_AUTHENTICATION/6d6d63354d1242d185ab4830fc04feb1/786eea2e06fa4bef84d914a7c319d74c.html).
+If you don't have this authorization, the [administrator](https://iamtenants.accounts.cloud.sap/) can add you as an administrator by following the steps described in [Managing Administrators in Identity Authentication](https://help.sap.com/docs/IDENTITY_AUTHENTICATION/6d6d63354d1242d185ab4830fc04feb1/786eea2e06fa4bef84d914a7c319d74c.html).
 
 </td>
 </tr>
@@ -79,10 +77,10 @@ SAP BTP cockpit
 
 -   *Org Manager* for the Cloud Foundry organization in your SAP Cloud ALM subaccount
 
-    This role is only required if a Cloud Foundry org and space exist in your SAP Cloud ALM subaccount and is in use in the context of SAP Cloud ALM APIs.
-
     If you don't have this role, the org manager can assign it to you by following the steps described in [Add Org Members Using the Cockpit](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/LATEST/en-US/a4eeaf179ee646b99558f27c0bae7b3e.html).
 
+    This role is only required for older SAP Cloud ALM tenants, which were provisioned with a Cloud Foundry org. If your SAP Cloud ALM tenant was provisioned after October 16, 2023, you now longer need this role.
+
 
 
 
@@ -116,8 +114,8 @@ If you don't have this authorization, the *Global Administrator* can assign the
 							(if required) set up landscape management.](images/Image_Map_Required_Setup_for_SAP_Cloud_ALM_d4f9ce5.png)
 
 -   **[Video-Guided Setup](video-guided-setup-cd38b1f.md "To learn how to set up SAP Cloud ALM for productive use, you can watch the following
-		step-by-step how-to videos.")**  
-To learn how to set up SAP Cloud ALM for productive use, you can watch the following step-by-step how-to videos.
+		step-by-step how-to videos (English only).")**  
+To learn how to set up SAP Cloud ALM for productive use, you can watch the following step-by-step how-to videos \(English only\).
 -   **[Step 1: Onboard Users in the Identity Authentication Service](step-1-onboard-users-in-the-identity-authentication-service-f2a8a8c.md "To give further users access to SAP Cloud ALM, you need to create or import users in
 		your Identity Authentication tenant. For users to be able to sign in to SAP Cloud ALM, they
 		need to be maintained both in the Identity Authentication tenant and in SAP Cloud

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

@@ -12,6 +12,9 @@ Role collections in SAP Cloud ALM are delivered predefined and ready to use.
 
 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.
 
+> ### Note:  
+> Some SAP Cloud ALM areas also offer single role templates. Before you can use these role templates, you need to assign them to a role collection. For more information, see [Role Templates](https://help.sap.com/docs/cloud-alm/setup-administration/role-templates).
+
 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.
 
 

docs/01_required_setup/role-templates-f7294b2.md

@@ -0,0 +1,103 @@
+<!-- loiof7294b2640b849d4adc7d43a30cf75dd -->
+
+# Role Templates
+
+Besides predefined role collections, which are ready to use, some areas also offer single role templates. Before you can use these role templates, you need to assign them to a role collection.
+
+
+
+<a name="loiof7294b2640b849d4adc7d43a30cf75dd__section_jbk_5kc_pdc"/>
+
+## Prerequisites
+
+You have the role *Subaccount Administrator* in the subaccount that contains your SAP Cloud ALM subscription.
+
+
+
+<a name="loiof7294b2640b849d4adc7d43a30cf75dd__section_ytx_5kc_pdc"/>
+
+## Procedure
+
+1.  Open the [SAP BTP cockpit](https://cockpit.btp.cloud.sap/).
+
+2.  In the global account that contains your SAP Cloud ALM entitlement, open the subaccount that contains your SAP Cloud ALM subscription.
+
+3.  Choose *Security* \> *Role Collections*.
+
+4.  Choose *Create*.
+
+5.  Enter a unique name and description for the role collection.
+
+6.  Open the created role collection and choose *Edit*.
+
+7.  Under *Roles*, select the role template or templates that you want to include, and choose *Add*.
+
+8.  Save the role collection.
+
+
+
+
+<a name="loiof7294b2640b849d4adc7d43a30cf75dd__section_uxd_tkc_pdc"/>
+
+## Available Role Templates
+
+> ### Note:  
+> This table only lists role templates that are not part of the predefined role collections. However, when creating your own custom role collections, you can also include role templates that are part of the predefined role collections.
+
+****
+
+
+<table>
+<tr>
+<th valign="top">
+
+SAP Cloud ALM Area
+
+</th>
+<th valign="top">
+
+SAP Cloud ALM Capability
+
+</th>
+<th valign="top">
+
+Name
+
+</th>
+<th valign="top">
+
+Description
+
+</th>
+</tr>
+<tr>
+<td valign="top">
+
+RISE with SAP
+
+</td>
+<td valign="top">
+
+*System View* 
+
+</td>
+<td valign="top">
+
+`rdp_dashboard_ccSystemViewer` 
+
+</td>
+<td valign="top">
+
+Access to the System View dashboard \(RISE with SAP\)
+
+</td>
+</tr>
+</table>
+
+**Related Information**  
+
+
+[Define a Role Collection](https://help.sap.com/docs/btp/sap-business-technology-platform/define-role-collection)
+
+[Add Roles to a Role Collection](https://help.sap.com/docs/btp/sap-business-technology-platform/add-roles-to-role-collection)
+

docs/01_required_setup/step-2-assign-roles-to-users-in-sap-cloud-alm-7304b17.md

@@ -8,6 +8,8 @@ After onboarding your users to your Identity Authentication tenant, you need to
 
 You can add users and assign roles to them directly in the SAP Cloud ALM *User Management* app \(recommended\) or as corresponding role collections in the SAP BTP cockpit.
 
+To assign role templates to users, first create a role collection and add the role template to it. After a daily sync job, the role collection you've created also appears under *Custom Roles* in the *User Management* app and can be assigned to other users from there.
+
 > ### Note:  
 > If you're working with role mapping to user groups in your identity provider, you need to assign role collections in the SAP BTP cockpit. In this case, you can't view or change roles in the *User Management* app. You also can't use the role request and assignment features in SAP Cloud ALM, so we don't recommend this method.
 
@@ -195,4 +197,8 @@ The roles in SAP Cloud ALM are available as role collections in your subaccount
 
 -   **[Role Collections](role-collections-e1915af.md "Role collections in SAP Cloud ALM are delivered predefined and ready to use.")**  
 Role collections in SAP Cloud ALM are delivered predefined and ready to use.
+-   **[Role Templates](role-templates-f7294b2.md "Besides predefined role collections, which are ready to use, some areas also offer
+		single role templates. Before you can use these role templates, you need to assign them to a
+		role collection.")**  
+Besides predefined role collections, which are ready to use, some areas also offer single role templates. Before you can use these role templates, you need to assign them to a role collection.
 

docs/01_required_setup/video-guided-setup-cd38b1f.md

@@ -2,7 +2,7 @@
 
 # Video-Guided Setup
 
-To learn how to set up SAP Cloud ALM for productive use, you can watch the following step-by-step how-to videos.
+To learn how to set up SAP Cloud ALM for productive use, you can watch the following step-by-step how-to videos \(English only\).
 
 For more detailed information, refer to the corresponding documentation under [Required Setup for SAP Cloud ALM](required-setup-for-sap-cloud-alm-80b2c30.md).
 

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

@@ -6,21 +6,28 @@ You can integrate and activate the SAP Document Management service for document
 
 If you want to upload [External Files](https://help.sap.com/docs/cloud-alm/applicationhelp/external-files) in the *Documents* app of SAP Cloud ALM, first establish a connection between your SAP Document Management service \(SAP BTP DMS\) and your SAP Cloud ALM tenant.
 
+> ### Caution:  
+> Choose your DMS instance carefully beforehand. It is not possible to change it afterward. Also, the automatic creation of a repository is a one-time action that can't be reversed.
+> 
+> Please use only this automatically created repository. It is currently not possible to use your external repository.
+> 
+> For more information, see [Repository Handling](https://help.sap.com/docs/cloud-alm/setup-administration/connecting-sap-document-management-service#repository-handling).
+
 > ### Note:  
-> Make sure you use both the [SAP 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) and the [SAP Document Management Service, Repository Option](https://help.sap.com/docs/document-management-service/sap-document-management-service/document-management-service-repository-option).
+> Make sure you have an entitlement for both the [SAP Document Management Service, Repository Option](https://help.sap.com/docs/document-management-service/sap-document-management-service/document-management-service-repository-option) and the [SAP 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 don't need to subscribe for the [SAP Document Management Service, Repository Option](https://help.sap.com/docs/document-management-service/sap-document-management-service/document-management-service-repository-option).
 
 
 
 <a name="loiob788f20e1d71444eb5568b3c2153087b__section_cxr_43g_jdc"/>
 
 ## 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 need to provide your own SAP Document Management service instance and establish a connection to SAP Cloud ALM. You can use an existing service instance for SAP Cloud ALM use. 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.
+    > Do not use your SAP Cloud ALM global account. Use your global account for SAP BTP DMS.
 
 -   You've done the initial setup for the SAP Document Management integration option and you've obtained all the necessary login data.
 
@@ -37,7 +44,24 @@ If you want to upload [External Files](https://help.sap.com/docs/cloud-alm/appli
 
 1.  Set up the HTTP destination.
 
-    In the SAP BTP subaccount, where your SAP Cloud ALM is hosted, create a destination targeted at your SAP BTP DMS instance.
+    In the SAP BTP subaccount, **where your SAP Cloud ALM is hosted**, create a destination targeted at your SAP BTP DMS instance.
+
+    -   You can download and use the following template to import a new SAP BTP destination: [https://help.sap.com/doc/sapcloudalmsolutiondocumentationdmsintegration](https://help.sap.com/doc/sapcloudalmsolutiondocumentationdmsintegration): It is a zipped TXT file that you need to unzip and import.
+
+        ![](images/BTP_Import_destination_e293406.png)
+
+        It already contains some prefilled values for the destination settings for your convenience.
+
+        After the import, you will see this screen:
+
+        ![](images/DMS_screen_after_import_4196358.png)
+
+        Please do not deselect the *Use default JDK truststore*:
+
+        ![](images/DMS_JDK_truststore_423daf9.png)
+
+    -   Afterward, proceed with the manual steps described below.
+
 
     > ### Note:  
     > If you have several SAP Cloud ALM tenants, you can onboard a separate SAP BTP DMS for each tenant. You can also reuse the same SAP BTP DMS for all your tenants. SAP Cloud ALM automatically creates a unique repository for each SAP Cloud ALM tenant to store the external files.
@@ -54,7 +78,7 @@ If you want to upload [External Files](https://help.sap.com/docs/cloud-alm/appli
 
     2.  Under *Destination Configuration*, fill in the required fields. Enter the following information:
 
-        -   *Name*:`CALM_SD_DMS_INTEGRATION`
+        -   *Name*: `CALM_SD_DMS_INTEGRATION`
 
         -   *Type*: HTTP
 
@@ -94,7 +118,7 @@ You can now start to use the [External Files](https://help.sap.com/docs/cloud-al
 During the initial communication between SAP Cloud ALM and the SAP Document Management service, the *Documents* app automatically creates a new repository in the SAP Document Management service.
 
 > ### Caution:  
-> Do **not** change this repository or any other repositories created by the *Documents* app. The property external ID of a repository is always identical with the tenant ID of the tenant that created it. With this information, the user can always trace which repository belongs to which tenant.
+> Do **not** change this repository or any other repositories created by the *Documents* app. As previously stated, the choice of a repository is irreversible. You might lose your documents if you decide to change the repository at a later point in time. The property external ID of a repository is always identical with the tenant ID of the tenant that created it. With this information, the user can always trace which repository belongs to which tenant.
 > 
 > Changes done in the repository directly aren't reflected in SAP Cloud ALM and they disrupt the integration.
 
@@ -106,10 +130,10 @@ The repository has the following characteristics, which you can't change:
 
 -   Name: SAP Cloud ALM for Implementation
 -   Description: Internal Repository for SAP Cloud ALM for Implementation
--   Encryption enabled
--   Virus scan enabled
--   Versioning enabled
--   Thumbnail disabled \(not possible with enabled encryption\)
+-   Encryption: enabled
+-   Virus scan: enabled
+-   Versioning: enabled
+-   Thumbnail: disabled \(not possible with enabled encryption\)
 
 Files in this repository are automatically managed as follows:
 

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

@@ -4,22 +4,17 @@
 
 # Enabling SAP Cloud ALM API
 
-To set up the connection between SAP Cloud ALM and your managed systems and/or services, you need to create a service binding from the SAP Cloud ALM API instance.
+To integrate certain products with SAP Cloud ALM, you need to create a service binding from the SAP Cloud ALM API instance.
 
 
 
 <a name="loio704b5dc854f549888a238f94015e1eac__section_wpy_rnj_jmb"/>
 
 ## Prerequisites
 
--   Your SAP Cloud ALM tenant was provisioned before October 16, 2023.
-
-    If your SAP Cloud ALM tenant was provisioned after this date, service credentials were generated automatically and you can skip these steps. For more information, refer to [Retrieving Service Credentials](retrieving-service-credentials-448f9f1.md).
-
--   Your user has the role *Global Account Administrator* in the global account that was created when you requested SAP Cloud ALM, and is a member of the subaccount containing your SAP Cloud ALM subscription.
-
-    If you don't have this role, the global account administrator can assign it to you by following the steps described in [Add Members to Your Global Account](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/LATEST/en-US/4a0491330a164f5a873fa630c7f45f06.html).
+Your user has the role *Global Account Administrator* in the global account that was created when you requested SAP Cloud ALM, and is a member of the subaccount containing your SAP Cloud ALM subscription.
 
+If you don't have this role, the global account administrator can assign it to you by following the steps described in [Add Members to Your Global Account](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/LATEST/en-US/4a0491330a164f5a873fa630c7f45f06.html).
 
 
 

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

@@ -4,7 +4,7 @@
 
 # Enabling SAP Cloud ALM API in Cloud Foundry
 
-To set up the connection between SAP Cloud ALM and your managed systems and/or services, you need to create a service key from the SAP Cloud ALM API instance.
+To integrate certain products with SAP Cloud ALM, you need to create a service key from the SAP Cloud ALM API instance.
 
 > ### Note:  
 > This document describes how to retrieve service credentials in the Cloud Foundry environment. This is no longer the recommended approach.
@@ -19,14 +19,12 @@ To set up the connection between SAP Cloud ALM and your managed systems and/or s
 
 ## Prerequisites
 
--   Your SAP Cloud ALM tenant was provisioned before October 16, 2023.
-
-    If your SAP Cloud ALM tenant was provisioned after this date, service credentials were generated automatically and you can skip these steps. For more information, refer to [Retrieving Service Credentials](retrieving-service-credentials-448f9f1.md).
-
 -   Your user has the role *Global Account Administrator* in the global account that was created when you requested SAP Cloud ALM, and is a member of the subaccount containing your SAP Cloud ALM subscription.
 
     If you don't have this role, the global account administrator can assign it to you by following the steps described in [Add Members to Your Global Account](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/LATEST/en-US/4a0491330a164f5a873fa630c7f45f06.html).
 
+-   Cloud Foundry is enabled in the subaccount containing your SAP Cloud ALM subscription.
+
 -   Your user has the role *Org Manager* in your Cloud Foundry environment.
 
     If you don't have this role, the org manager can assign it to you by following the steps described in [Add Org Members Using the Cockpit](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/LATEST/en-US/a4eeaf179ee646b99558f27c0bae7b3e.html).