Technology Blogs by SAP
Learn how to extend and personalize SAP applications. Follow the SAP technology blog for insights into SAP BTP, ABAP, SAP Analytics Cloud, SAP HANA, and more.
cancel
Showing results for 
Search instead for 
Did you mean: 
bp9
Advisor
Advisor
Updated on: 01.06.22 

We at SAP Cloud ALM continue to innovate and roll out features that help you in faster implementation of your projects. Defining requirements correctly is critical to Project success. It is easy to upload the requirements in bulk and also mass update them in one go. And the cherry on the top is that we let you upload and update all task types such as Requirements, Template tasks, Project tasks, User stories, Subtasks and Defects together!

Let me explain,how you can easily mass upload and mass update your Requirements into SAP Cloud ALM. I will cover the following points:

  • Overview

  • Download Template

  • Template Structure

  • Preparing the data

  • Upload into the system


Overview:


This feature will help you to upload multiple requirements in one go. Using this feature, you can download requirements from one project or a third-party system and upload them into another project. The supported transaction types include requirement, project tasks, user stories, and sub-tasks which can be uploaded individually or even as a hierarchy. Let me explain to you briefly the steps to upload the tasks:

Download Template:


You need to first download a template with a specific format. Go to the Requirement UI in SAP Cloud ALM. In the Items list, click on the download icon and select "template".  After choosing the option, the Microsoft Excel file will be downloaded to your local desktop.


Download the template



Template Structure:


Let us understand the template structure in detail:


Template Structure




  1. You will find 9 worksheets that correspond to the item attributes. Please see the image above with sheets highlighted in red.

  2. The "Tasks" is the main sheet where you will provide data. The first row is the header row. Please see the image above with sheets highlighted in green.

  3. You can add a new column to the template known as "Predecessor Row" to define the relationship of Predecessor and Successor.

  4. Other sheets (Types, Sources, etc..) have the available texts that can be used for editing the individual task attributes.

  5. Please make sure that except title and description all other fields have predefined values which you see in the other sheets as explained in point 3.

  6. The description field supports HTML tags to get proper formatting.



Available text for the Type column



Preparing the data into the template:


After you download the template, you can edit it based on your requirement. You can update the existing items or create new items by following these tips:

Title:


Do not change the title of the items having source SAP Cloud ALM Setup, SAP Activate Methodology, SAP Central Business Configuration".If you change the title of the existing item, the system will not be able to recognize it and the items will not be updated.

 ID:


All the task types have system generated unique IDs. It ensures that you are updating the right tasks. You can see the Unique IDs in the application by either enabling the field in the list view through settings or download as spreadsheet to view them. You can copy and enter the ID in your excel file.


Enable ID column in the application



ID column in the template



Types, Sources and Status:


Type the text in the respective sections as mentioned in the corresponding sheet.

Requirement Status:


Only fill for the type Requirement and leave the column blank for other items.

Timebox:


Select the timebox from available text. You cannot upload custom timebox items via upload. However, the custom timebox items that were added in the Timebox section of the Project UI before downloading the template are available in the texts.


Customize Timebox



Deliverables:


You can select the deliverables from the available texts. You can also add, assign and upload a custom deliverable to the Microsoft Excel sheet.

Workstreams:


Select the workstream as mentioned in the workstreams sheet.

Assigned Roles:


You can add the assigned roles from the available text. You cannot add custom assigned roles via upload. If you create the custom role in the Project UI before downloading the template, they are available and can be assigned to the items. You can also leave the section empty and add the role later in the tool.


Create Custom Role



Description:


You can add the details about the item here.

External ID:


An External ID is a custom field that has the external ID attribute, meaning that it contains unique record identifiers from a system outside of SAP Cloud ALM.

Please note that for the purpose of mass updating the  manually created tasks, the system matches the title and goes to track the external ID field:

  • If a task with the same external ID is found from the system, it will be updated

  • If no task is found by this external ID, a new task will be created with such external ID



External ID



Parent Row:


Specify the row number of the parent item in the column "Parent Row".

References:


You can add References as shown below:


References



Tags:


You can add available tags and also create, assign and upload custom tags.

Adding New columns:


Here comes the surprise! You can also add following columns that are not yet available in the template but are already supported by the system.

Predecessor Row:


You can add a new column "Predecessor Row" to define the predecessor- successor relationship between the items. Specify the row number of the predecessor item in the newly made column.

Comments:


You can also add a new column, "comments" to add comments and upload them into SAP Cloud ALM.

Assignee:


You can also add a new column, "assignee" and add the assignee to the item.

Please add the email address of the assignee in this column. If you write the name, the item shows that assignee is a former member!

Check the final prepared data that is now ready to be uploaded in the system!


Data prepared for the upload



Upload into SAP Cloud ALM:


Click the upload icon, select the prepared file and select Upload. A dialog appears that gives the details how many tasks will be created/ updated.


Note: If the external id was not given during item creation, the existing items cannot be updated and the system will create new item with same name!

How to see Project tasks, user stories and sub-tasks created by upload in Requirement tile:


You can view the project tasks, user stories and sub-tasks in the requirements tile! Adapt the filter and select Type filter.


Adapt Filter Type


Click the dropdown menu and select the type of items that you want to vie in the Items section:


You can now view the items in the Items section.

 

Benefits:


Mass upload and mass update are extremely powerful tools that will save you hours compared to manual updates. Leveraging these automated tools also reduces the risk for human error when used carefully, though it is highly recommended to run small tests before triggering large updates to ensure that your changes appear as expected before proceeding.

 



Next steps:


Hope you found this information useful. We are constantly innovating to give you a seamless implementation experience. For latest updates and notifications you can follow me by clicking bhagwati.purohit.

Please visit the Expert Portal for more information on SAP Cloud ALM for implementation. You can read more blog posts for project and task management here!

Please feel free to reach out to us if you are looking for more information. We would love to hear from you!

 

 





 

 

 

 

 

 

 

 

 
7 Comments
christian_martin
Explorer
0 Kudos
Hello Bhagwati,

Congratulations for this very useful blog !

However there is one point that I don't understand: 2 statements of your blog seem contradictory:

  • Statement 1: Do not change the title. If you change the title of the existing item, the system will not be able to recognize it. Instead of updating, a new item will be created.

  • Statement 2: Note: If the external id was not given during item creation, the existing items cannot be updated and the system will create new item with same name!


My interpretation of statement 1 is that if I do not change the title inside the template, then the existing item with same title will be recognized and updated.

For statement 2, I understand that if external ID is missing upon creation, any attempt of further update will fail, whatever the Title is...

So I'm confused. I tried several scenarios and it looks like only statement 2 is valid.

Please kindly advise.
bp9
Advisor
Advisor
0 Kudos

Hi Christian,

I am glad that you found the blog useful.

Statement 1 is not valid now. You are right. Thanks for pointing this out. The system will check the external ID and update the item accordingly. Without external ID, the system will create a new item. 

However, if you want to mass update items such as template tasks, the system matches the title to update them. It will show error if the title is changed. I have also edited the blogpost accordingly 🙂

Hope this helps!

 

Regards,

Bhagwati

 

JohnK
Product and Topic Expert
Product and Topic Expert
Dear ALM Community,

Subscribe today to receive the brand-new monthly newsletter for Application Lifecycle Management to conveniently stay informed about the latest news, achievements and opportunities related to SAP’s ALM offerings!

Subscribe link - https://www.sap.com/cmp/nl/alm-newsletter/index.html

Your ALM Team
knotstein
Explorer
0 Kudos
Hi Bhagwati

Thanks for the information in this blog. Just a question in relation to the mass upload of  requirements. To follow the logic to align requirements to standard scope items, How is this possible do this in a mass upload?

The background for the question is that we as SAP partners develop different add ones to the standard scope items for different industries. We have identified the correct scope items for the IS and know that all customers will aske for specific WRICEF elements at certain steps. To handle that, we have up front created the WRICEF elements as requirements and will store them in excel files to be uploaded to CALM for each project.

But if we cannot connect a requirement via the upload to correct scope item and step, we will loose control over the flow.

Do you have any quick fix for this?

  • Kjell -

bp9
Advisor
Advisor
0 Kudos
Hi Kjell,

Thanks for your question. You have a valid point here. We are also working to improve the end to end traceability. We have released system generated unique IDs for all task types today that will help in further improving the experience and ensuring that correct tasks are identified and updated.

I have forwarded your query to other team members. I can't propose any quick fix here but I can only assure that we are working on the solution.

Regards,

Bhagwati
knotstein
Explorer
0 Kudos
Thanks for your reply, Bhagwati.

I’ll hope that it soon will be a solution for this requirement as it is a vital part of our standardised project deliveries.

Anyhow, keep on with the good work. I’m happy to see the direction Cloud ALM is moving into. It’s a great tool.

-Kjell-
bp9
Advisor
Advisor
0 Kudos
Thanks for your positive and valuable feedback, Kjell.

Glad that you like the tool!

Regards,

Bhagwati