Skip to Content
Product Information

How to upload Test Cases into Test Steps Designer

With Focused Build – Test Steps, designing and executing manual tests with SAP Solution Manager is simplified and accelerated. Many features like content-driven test case design, guided test execution or in-depth reporting capabilities enable a testing experience which was not possible before in SAP Solution Manager.

In one of my previous blog posts I gave an overview on the most important capabilities & features of Focused Build – Test Steps. In this article I want to focus on how to upload existing Test Cases into SAP Solution Manager using Test Steps Designer.

When introducing Focused Build – Test Steps at a customer we usually find ourselves in a situation where plenty of time was already invested in describing manual test cases with tools like MS Excel. And of course you do not want to lose this content and start from scratch just because you implement a new tool for manual testing!

No need to be afraid: you can upload your existing test cases into SAP Solution Manager via the Upload Wizard of Test Steps Designer!

Please note: this article mainly describes the upload functionality with Focused Build SP2. At the end you will find a section with details on new features that come with Focused Build SP3.

You can find the upload function in the application Test Steps Designer in your Fiori Launchpad:

At the bottom on the left you will find the “Upload” button which will navigate you to the Upload Wizard:


Step 1: Select files you want to upload

In the first step you select files which you want to upload. Since these files need to follow a certain structure it is recommended to download the sample file (see right upper corner of the wizard). With that you can learn how the structure should look like.

Please note: the CSV file needs to be stored in UTF-8 encoding.


Step 2: Enter columns of your file(s) mapping to test case attributes

In the second step you map the columns in your CSV file to the test case / step attributes. Only mapped attributes will be considered during the upload.



Test Case Attribute Description and Prerequisites for Upload
Test Case Name This attribute is mandatory and defines the name of the test case.
Folder Here you can define the folder to which the test case should be added. Folders are structure elements in Test Steps Designer that help to organize your test cases. You need to maintain the available folders in customizing before (see customizing of FB Test Steps in transaction SPRO). In the CSV file you need to maintain the ID of the folder, not (!) the label.
Test Case Version Title Here you can maintain the title of the initial version that will be created automatically when the test case is uploaded.
Test Case Status Referring to the status customizing (see view cluster SMDDOCSTATUS in transaction SM34) you can maintain an initial status value here which will be set when the test case is created. You need to maintain the ID, not (!) the label of the status within the CSV file. Please note: you cannot choose a released status here.
Test Case Priority Referring to the priority customizing (see maintenance view V_SMDDOCPRIORITY in transaction SM30) you can maintain an initial priority value here which will be set when the test case is created. You need to maintain the ID, not (!) the label of the priority within the CSV file.
Test Case Owner Here you can define the owner of the test case either via Business Partner ID or User ID.
Test Case Notes Here you can maintain working notes for this test case. They will be displayed in the tab “Notes” within Test Steps Designer.
Test Case Duration This is the duration of the test case that describes how long it takes to execute it by a tester.
Strict Step Sequence (FB SP3) This setting defines how testers can execute the test case: either in strict sequence (step by step) or flexibly choosing their own sequence. Potential values are X (strict) or “empty” (not strict).
Testing Mode (FB SP3) Here you can define whether different testers will share their results when executing the same test case. Alternatively, each tester will have an own execution with individual results. See this blog article for further details. Potential values are 1 (shared results) or 2 (individual results).
SolDoc Path Occ ID (FB SP3) If you want to add the test case directly to a node in Solution Documentation, you can maintain the Occurence ID here. Please see the section below for further details how to do this.
Test Case Description Here you can maintain a (translatable) long text description for the test case.
Test Case Prerequisites Here you can maintain a (translatable) long text for prerequisites for the test case.
Test Case Exit Criteria Here you can maintain a (translatable) long text for exit criteria for the test case.
Step Number This is the number of the step in sequence (1,2,3,…). Only number values are allowed here.
Step Description Here you can maintain the (translatable) long text description of the step
Step Expected Result Here you can maintain the (translatable) long text expected results of the step
Step Test Instruction Here you can maintain the (translatable) long text instructions of the step
Step Evidence This defines whether the tester needs to add an evidence (e.g., a screenshot that proves a successful test execution). Potential values in your CSV file are X (evidence required) or <blank> (evidence not required).
Step Executable Here you can maintain an executable (e.g., transaction code, fiori app, etc.) that should be linked to the step. As prerequisite the executable needs to be maintained in the Solution Library within Solution Documentation. Furthermore, you need to maintain another column in your CSV file with the ID of the Logical Component Group (LCG).
Logical Component Group Here you need to maintain the ID of the LCG where the referring executable is located (see attribute Step Executable above).
Step Business Partner Here you can define the partner of the step either via Business Partner ID or User ID. Please note: this is usually not a single person since testers will be assigned later via the Test Package. You should rather use this attribute for groups / organizational units to describe the group of persons that is meant to execute this step.


Step 3: Options for Upload

In the final step you define options for this upload. Afterwards you press the button “Start Upload” to trigger the upload as defined before.

Option Description
Set first row in file Here you set the number of the first row that contains the actual content of your test case. This must not be the header line that contains the column headings. In the sample file the correct value would be 2.
Set Header row in file (FB SP3) With FB SP3 the upload wizard supports an automatic column mapping based on the header line. In the sample file the correct value would be 1.
Set last row in file This is an optional parameter which can be used in case you want to restrict the upload to a certain row range within your CSV file.
Separator in CSV files Here you define which separator you use in your CSV file. This depends on your operating system / excel / file settings and can be either comma or semicolon.
Content Language Since the content of Test Steps test cases can be maintained in different languages you need to specify a content language for your upload. All long texts (e.g., description, prerequisites, expected results, etc.) will be maintained in that language when the test case is created.
Upload (into SolDoc) with Executables

If you want to upload a test case including steps that are mapped to executables, you need to activate this option. Afterwards you need to maintain the Solution / Branch context in which the executables are maintained. As a prerequisite you need to map the respective columns to the attributes Step Executable and Logical Component Group (see above).

With FB SP3 this option is also required in case you want to upload the test case directly into a node in Solution Documentation.

Solution/Branch Here you select the Solution / Branch context in which the executables are maintained.
Validate only You can activate this option in case you want to validate your file content without creating a test case.

And that’s it! You will get a status message after the upload is done that tells you about success or failure. If everything went well you will find your test case(s) immediately in Test Steps Designer by navigating to “All Test Cases” or the respective folder to which you uploaded them.


New Capabilities with Focused Build SP3

With FB SP3 the upload functionality has been further enhanced:

  • Direct Upload into Solution Documentation (details see below)
  • Further attributes (Strict Step Sequence, Testing Mode)
  • Completed Sample File (including all columns and samples for potential values)
  • Automated column mapping based on header line in file
  • Enhanced content checks to prevent failures during upload


Uploading a Test Case directly into Solution Documentation

With FB SP3 you can now upload Test Cases directly into SolDoc via the attribute attribute “SolDoc Path Occ ID”. In the CSV file you just maintain the Occurence ID of the node where you want to upload the test case. But how do you get this ID?

  1. Navigate to Solution Documentation (transaction SolDoc)
  2. Select the Solution/Branch/Node where you want to add your test case
  3. Switch to “List” view and make sure to filter only those nodes which are relevant for your test case upload
  4. Download the list as file to get all relevant Occurence IDs in column “Path (OCC_ID)”
  5. Take over the Occurence IDs into your upload file for Test Steps Designer

Please note: For the download function in Solution Documentation you need export authorizations via auth. object SM_SDOCADM.


With Test Steps Designer the migration of manual test cases into the Test Steps type can be done easily. The upload functionality offers most of the test case attributes and plenty of options that help you migrating test cases into SAP Solution Manager. If this is even not enough for your individual migration path you still can apply the Test Steps API (see class /SALM/CL_TM_TS_TD_API) within a custom report to create test cases based on whatever format.

For further reading you might be interested in this blog on how to migrate your test cases from Micro Focus ALM (HP QC / HP ALM) to Focused Build Test Steps.



11 Sep 2020: added hint regarding auth. object SM_SDOCADM for download from SolDoc.

You must be Logged on to comment or reply to a post.

    Hello Tobias,


    thank you for this article!


    Do you know if it's possible to upload content for added columns in customizing ?


    The new columns don't appear in step 2: Test case attribute mapping.





    • Hi Pascal,

      in Focused Build SP1 and SP2 it is not possible to add custom columns / attributes. Both applications, Test Steps Designer and My Test Execution, do not support additional columns - even though you can add columns in customizing there is no backend implementation that would handle those columns.

      Best regards


  • Hi

    We have intensively used Test Suit Focused Build Test Designer and found one very important missing point – this is extremely difficult to relate Test Cases to Business Processes during the upload of thousands Test Cases.

    This should be a connection field similar to the “Element” field in the Work Package, which will point the Test Case to the relevant Business Process in the Solution Documentation or at least the Test Case Title will pick up the Process Name as an attribute.

    Also the Defect Management should assign Defects at the Test Case step level and not at the Test Case Header level.

    We will be more than happy to discuss widely sour additional requirements off the Blog




    • Hi Adi,

      thanks for your feedback. With Focused Build SP3 (released today) we enhanced the upload capabilities. You can now add the property "SolDoc Path Occ ID" to your CSV file and then upload the test case directly into Solution Documentation. In this field you need to maintain the "Occurence ID" of the path in SolDoc. I will update this blog article with further details and describe how to do this.

      Regarding defect assignment at step level: we are aware of this requirement and will try to include it in the future roadmap of Test Steps.


  • Is there a way to create custom reports for test steps? The execution reports and Test suite analytics in general do not provide the same level of granularity as the MicroFocus ALM solution. In order for Solution Manager to be considered a viable complete solution for all Manual and Automated Testing the reports/analytics must be improved to include the ability to report on status at the step level as well as defects at the test step level.

    • Thanks for your question & feedback. In Focused Build Test Suite Dashboard you will find a detailed reporting on step level (see my other blog post on Test Steps). Currently an assignment of defects to a specific step within a test case is not possible. If you want to create custom reports you can also use the Test Steps API via class /SALM/CL_TM_TS_TE_API.

      • I agree you can get to step level status by drilling into each test scenario. If I have 50 test scenarios each containing 100+ steps I need to easily see and extract overall status as well as total number of steps passed, failed, incomplete...just as I can easily extract this from MicroFocus ALM. I do not want to drill into each and every scenario to see the step status. Similarly with CBTA automated tests, the execution report shows the status of each step but I do not want to view this report for all 50 scenarios. I need to report on overall steps completed. I think this is a gap in the Test Suite reporting/analytics area.

    • Hi Karthik,

      this is not possible. But with Focused Build SP4 the separator is determined automatically, so no need to set it manually in the wizard anymore.

      Best regards

  • /
    • Hi Karthik,

      please have a look at the central note: 2624462 - Focused Build: Technical collective note for ST-OST 200 SP02

      It is recommended to regularly implement the latest version of the central note.

      Best regards

  • Hi Tobias

    Thanks for the documentation , i have a question , do you know if possible export a test plan management from a Solman and import that test plan management for another Solman?. without the focus build tool

    If you know how please tell me something .


    Thanks for you help


    Simon Madariaga

    • Hi Simon,

      export/import of Test Plans is not supported. However, you can export/import content of Solution Documentation including test cases and then create a similar test plan in the other SolMan based on the copy of the Solution content.

      Best regards

  • Hi Tobias!

    We would like to use customer fields for test steps result attribtes (e. g. Sales Order ID), because not a single tester will execute test activities but a group of testers.

    Is it possible to add these attribute fields in upload process of test cases into test steps designer?

    Many thanks in advance for your answer!

    Best regards,


    • Hi Bernhard,

      thanks for your question! Not so far - but we are aware of this requirement and will consider it for future SP planning...

      Best regards


  • Hello Tobias

    We are implementing S/4HANA with Model Company (MC4MNC). SSM 7.2 SPS 09, FB  04.

    The BIG question we have is how to get the test scripts that came with MC4MNC into FB Test Designer?

    They are all in Word templates.

    Look forward to any guidance.



    • Hello Marc,

      we are already aware of this requirement and will consider it for future SP planning of Focused Build. In case you require urgent help in this regard and cannot wait for a future SP release, please feel free to contact me directly: SAP Consulting offers custom specific solutions in this case.

      Best regards


  • Hello Tobias,

    Great post, thanks for it.

    I tried it and it works quite fine.

    But, I’m still having an issue.

    I’ve populated the field “Test Case Notes” in the upload file and it appears in the created test case.

    Though, when I’m creating a testplan-testpackage and select that particular test case, I can’t see this “Test Case Notes” anymore.

    Any idea what went wrong?


    Thanks in advance for your feedback.

    Kind regards,


    • Hi Philip,

      thanks for your feedback, great to see that you could use the upload functionality successfully!

      Regarding the notes field: Test Case Notes are only visible in "Test Steps Designer" during design time of the test case - not during execution time for the testers in "My Test Executions".

      You can leave, for instance, working notes in this field which might be required for further processing, by a different colleague etc. You should not save any data in this field which is relevant during test execution.

      I hope this helps.

      Best regards

      • Hello Tobias,

        I've created test cases, testplan, testpackage and assigned multiple testers to one testpackage.

        One of the assigned testers added during the test execution an attachment into the results part of the testcase.  See below picture. All of this is working fine. However, when one of the other assigned testers is willing to see these attachments, this tester doesn't see any attached documents. Any idea what is the reason for that? Missing authorisations? ...


        Looking forward to receive your input.


        Kind regards,




        Screenshot of testcase

        • Hi Philip,

          in this case please open an Incident on component SV-SMG-OST-FB-TWB. The responsible colleagues will take a closer look then and give advice.

          Best regards

  • Hi Tobias,

    After maintaining the Test Result Attributes in the backend, Is there a way to upload which ones apply to a particular test case using .csv file against each of the test steps; or we will have to manually select the Test Result attributes using the Test Steps Designer application every time we upload a test case?

    If there is an option to do so, which Attribute can be used in the .csv file to do this.

    Thank you,


    • Hi Mohammed,

      so far there is no option to cover result attributes during upload of test cases. You would have to manually maintain result attributes afterwards via Test Steps Designer.

      We are already aware of this requirement and will consider it for future SP planning of Focused Build.

      Best regards

  • Hi Tobias,

    Great blog!

    We are using Focused Build SP04 - and looks like there is no option to download the list of displayed nodes (to an excel file) which we plan to attach the test cases to - in order to get the attribute “SolDoc Path Occ ID” to use in the upload file. I also tried to do the same using the SAP demo system which is Focused Build SP06 version - and the option to download is also not there.

    Can you please advise?

    Best Regards,




  • Hi Tobais Sir,

    I am not able to see Focuses Build - Test Manger in the my Fiory launch pad..Could you please see below screen shot?. for that what role to be assigned to my User ID...please help me out...

    Note: I need to create manual test cases in to SAP Solution Manager 7.2 and where do I crate manual test cases in solution manager please help me out sir....

  • Hello Tobias,


    Upload the English CSV file but it is not converted to German (# in some character).


    Is it require translation hub connectivity or how can i upload the German test case in test designer?




    • Dear Naveen,

      please make sure to provide CSV file with UTF-8 encoding otherwise special language dependent characters might not be transferred as expected. In MS Excel during "save as..." you should find the option CSV (UTF-8).

      However, during upload so far you cannot provide multiple languages within a single file. That means you would always generate a new version in a particular language but not a single version with multiple languages. We are already aware of this issue and will provide an enhanced upload functionality in a future SP soon.

      In general you can translate test steps test cases using translation hub into multiple languages. Please refer to my blog article on automated translation for further details.

      I hope this helps.

      Best regards

      • Dear Tobias,


        Yes, we are using the CSV (UTF 8) file to upload in Test Designer.

        Any other setting to save the file?

        Also tried to download the example file in German but its shows only in English.


        Thank you!



        • Hi Naveen,

          I am not sure if I get your problem.

          The template file headings will always be in English.

          In the first step of the wizard you can select the content language. This will then create a new version of your test case with texts in the defined language based on what you uploaded with the file.

          In case you still perceive an issue I would suggest to open an incident at SAP Support Portal and enable a remote connection to your system. Please also describe in detail how to reproduce the error, best with some screenshots attached.


  • Hi Tobias,

    is there any possibility to enable an overlay? An overlay that indicates the test instructions step by step while executing the test in the test system? At the moment the testers need to switch between two windows of the test system and the solution manager system.

    Thanks for your help!

    Best regrads


    • Hi Marga,

      thanks for this question. Currently this is not possible. But we are already aware of this need and will discuss it internally. However, I cannot make any statement if or when a corresponding function would be available.

      Best regards

  • Hi Tobias,

    I have another question where I hope you can help.

    We want to upgrade SolMan and Focused Build in the next weeks. We assume that there is SPS 12 with FB 07 planned to be available soon, but we can`t find any release notes nor fixed dates. Do you recommend to plan first the upgrade to SPS11 FB 06 or directly to upgrade to SPS 12 FB 07? We are already testing on Solution Manager with FB, so we want to make sure to have a reliable system.

    Thanks for your suggestion!


    • Hi Marga,

      for official information please refer to SAP Note 2806573 - Solution Manager SPS/FPS release schedule. You will be guided through SAP Support Portal and should find details on the planned release to customer.

      Best regards