Uploading Custom Questionnaires - help.sap.com · Uploading Custom Questionnaires ... Choose the Upload Questionnaire button. 3.

Upload Guide

SAP Product Stewardship Network 3.48

Document Version: 1.4 – 2017-08-27

PUBLIC

Uploading Custom Questionnaires Sustainability Assessment Scenario

2

PUBLIC

© 2017 SAP SE or an SAP affiliate company. All rights reserved.

Uploading Custom Questionnaires

Typographic Conventions

Typographic Conventions

Type Style Description

Example Words or characters quoted from the screen. These include field names, screen titles,

pushbuttons labels, menu names, menu paths, and menu options.

Textual cross-references to other documents.

Example Emphasized words or expressions.

EXAMPLE Technical names of system objects. These include report names, program names,

transaction codes, table names, and key concepts of a programming language when they

are surrounded by body text, for example, SELECT and INCLUDE.

Example Output on the screen. This includes file and directory names and their paths, messages,

names of variables and parameters, source text, and names of installation, upgrade and

database tools.

Example Exact user entry. These are words or characters that you enter in the system exactly as

they appear in the documentation.

<Example> Variable user entry. Angle brackets indicate that you replace these words and characters

with appropriate entries to make entries in the system.

EXAMPLE Keys on the keyboard, for example, F2 or ENTER .


Document History

PUBLIC

© 2017 SAP SE or an SAP affiliate company. All rights reserved. 3

Document History

Version Date Change

1.0 2014-07-16 Original document created

1.1 2015-04-16 Chapters 4.8 and 4.9 regarding multiple-percentage questions added

1.2 2016-01-27 Added explanation of nonscorable questions in chapter 4.11, added response

type in XML examples, and updated copyright information

1.3 2016-06-23 Added chapter 4.11

1.4 2017-08-27 Added chapter 4.12, expanded list of accepted uploaded document types in

chapters 4.11 and 4.13.

4

PUBLIC



Contents

Contents

1 Introduction ................................................................................................................................... 6

2 Prerequisites .................................................................................................................................. 7

3 Downloading Example Files from the System ........................................................................... 8 3.1 Procedure ............................................................................................................................................... 8

4 Preparing the XML File ................................................................................................................. 9 4.1 Single-Answer Question with No "Not Applicable" Option ................................................................ 9

4.1.1 Example ................................................................................................................................. 9 4.1.2 XML ........................................................................................................................................ 9 4.1.3 Result ................................................................................................................................... 10

4.2 Single-Answer Question with a "Not Applicable" Option .................................................................. 11 4.2.1 Example ................................................................................................................................ 11 4.2.2 XML ....................................................................................................................................... 12 4.2.3 Result .................................................................................................................................... 13

4.3 Single-Percentage Question with No "Not Applicable" Option ........................................................ 13 4.3.1 Example ................................................................................................................................ 13 4.3.2 XML .......................................................................................................................................14 4.3.3 Result ....................................................................................................................................14

4.4 Single-Percentage Question with a “Not Applicable” Option ........................................................... 15 4.5 Example ................................................................................................................................................. 15

4.5.1 XML ....................................................................................................................................... 15 4.5.2 Result ....................................................................................................................................16

4.6 Multiple-Percentage Question with No "Not Applicable" Option; Each Answer Can Be 0‒100% 17 4.6.1 Example ................................................................................................................................ 17 4.6.2 XML ....................................................................................................................................... 17 4.6.3 Result ....................................................................................................................................18

4.7 Multiple-Percentage Question with a “Not Applicable” Option; Each Answer Can Be 0‒100% ..19 4.7.1 Example ................................................................................................................................19 4.7.2 XML ...................................................................................................................................... 20 4.7.3 Result .................................................................................................................................... 21

4.8 Multiple-Percentage Question with No "Not Applicable" Option; Answers Add Up to 100%........ 21 4.8.1 Example ................................................................................................................................ 21 4.8.2 XML ...................................................................................................................................... 22 4.8.3 Result ................................................................................................................................... 22

4.9 Multiple-Percentage Question with a "Not Applicable" Option; Answers Add Up to 100% ......... 23 4.9.1 Example ............................................................................................................................... 23 4.9.2 XML ...................................................................................................................................... 24 4.9.3 Result ................................................................................................................................... 25

4.10 Nested Question with Non-Percentage Answers and a "Not Applicable" Option.......................... 26 4.10.1 Example ............................................................................................................................... 26 4.10.2 XML ...................................................................................................................................... 26 4.10.3 Result ................................................................................................................................... 27


Contents

PUBLIC

© 2017 SAP SE or an SAP affiliate company. All rights reserved. 5

4.11 Nonscorable Question with Upload Response Option ..................................................................... 28 4.11.1 Example ................................................................................................................................ 28 4.11.2 XML ....................................................................................................................................... 28 4.11.3 Result .................................................................................................................................... 29

4.12 Nonscorable Question with Free-Text Response Option ................................................................. 29 4.12.1 Example ................................................................................................................................ 29 4.12.2 XML ...................................................................................................................................... 30 4.12.3 Result ................................................................................................................................... 30

4.13 Scorable Question with Nested Upload/Free-Text Response Options .......................................... 31 4.13.1 Example ................................................................................................................................ 31 4.13.2 XML ....................................................................................................................................... 31 4.13.3 Result .................................................................................................................................... 32

5 Remaining XML Elements .......................................................................................................... 33 5.1 Required Elements .............................................................................................................................. 33 5.2 XML Validation ..................................................................................................................................... 33 5.3 User Input Validation ........................................................................................................................... 34 5.4 Uploading the XML File ........................................................................................................................ 34 5.5 Version Management .......................................................................................................................... 34

6

PUBLIC

© 2017 SAP SE or an SAP affiliate company. All rights reserved..


Introduction

1 Introduction

This document explains how you can upload your own custom questionnaires to SAP Product Stewardship

Network by implementing key performance indicators (KPIs) in an eXtensible Markup Language (XML) file.


Prerequisites

PUBLIC

© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 7

2 Prerequisites

• You are using the Sustainability Assessment scenario.

• You have the user role of supplier contact in this scenario.

• You are a company administrator.

• You are using the enterprise edition.

8

PUBLIC



Downloading Example Files from the System

3 Downloading Example Files from the System

SAP Product Stewardship Network provides an XSD file (XML Schema Definition) and an example XML file to

facilitate the preparation and upload process for your custom questionnaires.

3.1 Procedure

To download the XML schema definition and the example XML file, proceed as follows:

1. Go to the Own Survey Content tab of the Content Library work center.

2. Choose the Upload Questionnaire button.

3. In the dialog box, choose the links to the XML schema definiion and example XML file to download them.


Preparing the XML File

PUBLIC


4 Preparing the XML File

The easiest way to prepare the XML file with your custom questionnaire is to copy the example XML file and edit

the copy. It is important that your questionnaire use question types that are supported by SAP Product

Stewardship Network. Every question has the same weight, and the highest score for a question cannot be higher

than 1. The supported question types include the following:

4.1 Single-Answer Question with No "Not Applicable" Option

Questions of this type are multiple-choice questions where every answer has a specific score. This question type

always counts towards the score, regardless of which answer is chosen, as there is no "not applicable" option.

4.1.1 Example

The following is an example of a single-answer question with no "not applicable" option:

Example

Does your business have a sustainability policy?

A. No 0 points

B. Yes, it was set up more than 5 years ago. 0.25 points

C. Yes, it was set up more than 3 years ago. 0.5 points

D. Yes, it was set up more than 1 year ago. 0.75 points

E. Yes, it is updated every year. 1 point

4.1.2 XML

<KeyPerformanceIndicator ID="KPI-01">

<Title>

<Text>Sustainability policy</Text>

</Title>

<Question>

<Text>Does your business have a sustainability policy?</Text>

</Question>

<Responses>

<Response Type='Choice' ScoreInfo="0.000" Label="A ">

10

PUBLIC




<Text>No.</Text>

</Response>

<Response Type='Choice' ScoreInfo="0.250" Label="B ">

<Text>Yes, it was set up more than 5 years ago.</Text>

</Response>

<Response Type='Choice' ScoreInfo="0.500" Label="C ">

<Text>Yes, it was set up more than 3 years ago.</Text>

</Response>

<Response Type='Choice' ScoreInfo="0.750" Label="D ">

<Text>Yes, it was set up more than 1 year ago.</Text>

</Response>

<Response Type='Choice' ScoreInfo="1.000" Label="E ">

<Text>Yes, it is updated every year.</Text>

</Response>

</Responses>

<AdditionalGuidance>

<Text>As a company that is aware of CSR you should have a sustainability

policy that applies to all business processes you perform.</Text>

</AdditionalGuidance>

</KeyPerformanceIndicator>

4.1.3 Result

On the user interface, the question appears as follows:



PUBLIC


4.2 Single-Answer Question with a "Not Applicable" Option

Questions of this type are multiple-choice questions where every answer has a specific score except for one "not

applicable" answer. Answers of "not applicable" do not count towards the score.

4.2.1 Example

The following is an example of a single-answer question with a "not applicable" option:

Example

Does your company have any initiatives regarding the end of life disposal of batteries?

A. Not applicable. We don't sell products that use batteries. (Not applicable)

B. No, but we sell products that use batteries. (0 points)

C. Yes, we take part in a program to collect batteries from some of our stores. (0.5 points)

D. Yes, we take part in a program to collect batteries from all of our stores. (1 point)

If answer A is chosen, the question does not count towards the score. The other answers count towards the score

as normal. It is important to create an empty string in the ScoreInfo attribute for answer A.

Note

<… ScoreInfo="" ...>: Not applicable; question does not count towards the score.

12

PUBLIC




<… ScoreInfo="0.000" …>: Question does count towards the score, but the score for this answer is 0.

4.2.2 XML


<Title>

<Text>Batteries</Text>

</Title>

<Question>

<Text>Does your company have any initiatives regarding the end of life

disposal of batteries?</Text>

</Question>

<Responses>

<Response Type='Choice' ScoreInfo="" Label="A ">

<Text>Not applicable. We don't sell products that use

batteries.</Text>

</Response>


<Text>No, but we sell products that use batteries.</Text>

</Response>

<Response Type='Choice' ScoreInfo="0.500" Label="C ">

<Text>Yes, we take part in a program to collect batteries from

some of our stores.</Text>

</Response>

<Response Type='Choice' ScoreInfo="1.000" Label="D ">

<Text>Yes, we take part in a program to collect batteries from all

of our stores.</Text>

</Response>

</Responses>


<Text>If you sell any products that use batteries, you should participate

in a battery stewardship program to ensure that the batteries are

disposed correctly.</Text>





PUBLIC


4.2.3 Result


4.3 Single-Percentage Question with No "Not Applicable" Option

These question types require the supplier to enter one percentage as the answer to the question. All answers

count towards the score, as there is no "not applicable" option.

4.3.1 Example

The following is an example of a single-percentage question with no "not applicable" option:

Example

What is the percentage of plain water used in your watering system?

___%

To answer the question, the user must provide a percentage between 0% and 100%.

In the XML, the ScoreInfo attribute has to contain a percentage sign (%). If you want to apply a coefficient to the

input, the syntax is as follows:

Syntax

<… ScoreInfo=”[coefficient]*%” ..>

14

PUBLIC




The coefficient must be a number between 0 and 1.

The text element has to contain a percentage marker (___%), which consists of three underscores and a

percentage sign.

4.3.2 XML


<Title>

<Text>Water</Text>

</Title>

<Question>

<Text>What is the percentage of plain water used in your watering

system?</Text>

</Question>

<Responses>

<Response Type='Percentage' ScoreInfo="1.000*%" Label="A

"><Text>___%.</Text></Response>

</Responses>


<Text>Liquid fertilizers that contain water do not count into this

percentage.</Text>



4.3.3 Result




PUBLIC


4.4 Single-Percentage Question with a “Not Applicable” Option

These question types require the supplier to enter one percentage as the answer to the question. Answers of "not

applicable" do not count towards the score.

4.5 Example

The following is an example of a single-percentage question with a "not applicable" option:

Example

What is the percentage of products in your product portfolio which are responsibly lifted from your own

fields?

A. Not applicable. None of the products we sell are lifted from our own fields.

B. The following percentage of our products we have in our product portfolio is responsibly lifted from our

own fields.

___%

To answer this question, the supplier has the option to enter a percentage between 0% and 100% or to choose

the "not applicable" answer.

You can either use the entered percentage in the child answer as only source of the score (here: answer with label

B1) or provide a fraction of the score simply for answering B and another fraction that is multiplied by the

percentage entered in the child question.

Example

The supplier could receive 0.5 points simply for choosing B. The other 0.5 points are multiplied by the

percentage the supplier enters. If the supplier enters 75%, the score is calculated as follows:

0.5 + 0.5(0.75) = 0.875

To create such a scoring model, enter a number in the ScoreInfo attribute for answer B other than 0. The total of

the ScoreInfo attribute of the parent answer and the child answer must be 1.

In the following XML example, the supplier is only scored for the entered percentage, because the ScoreInfo

attribute of the parent answer is 0 and of the child answer is 1.

4.5.1 XML


<Title>

<Text>Harvesting</Text>

</Title>

16

PUBLIC




<Question>

<Text>What is the percentage of products in your product portfolio which are

responsibly lifted from your own fields?</Text>

</Question>

<Responses>


<Text>Not applicable. None of the products we sell are lifted from our own

fields.</Text>

</Response>


<Text>The following percentage of our products we have in our product portfolio is

responsibly lifted from our own fields.</Text>

<Responses>

<Response Type='Percentage' ScoreInfo="1.000*%"

Label="B1”/>

<Text>___%.</Text>

</Response>

</Responses>

</Response>

</Responses>


<Text>This question can only be answered by farmers who own, and do not rent

land.</Text>



4.5.2 Result


If the answer is "B", the supplier must enter a percentage:



PUBLIC


4.6 Multiple-Percentage Question with No "Not Applicable" Option; Each Answer Can Be 0‒100%

These question types require the supplier to enter multiple percentages as the answer to the question. Each

question can be answered with a value from 0% to 100%, but the answers do not need to add up to 100%. All

answers count towards the score, as there is no "not applicable" option.

This can be achieved by declaring the percentage responses as not grouped in the XML.

4.6.1 Example

Example

What is the percentage of business processes which are fully aligned with a certification program?

___% Natural Resources Defense Council.

___% Center for Sustainable Global Enterprise.

___% Other.

To answer this question, the supplier must provide three percentages between 0% and 100% after selecting the

corresponding answer.

If you use coefficients, they must be numbers between 0 and 1.

4.6.2 XML


<Title>

<Text>Business processes</Text>

18

PUBLIC




</Title>

<Question>

<Text>What is the percentage of business processes which are fully aligned with a

certification program?</Text>

</Question>

<Responses Group="false">

<Response Type='Percentage'ScoreInfo=" 0.333*%" Label="B1 ">

<Text>___% Natural Resources Defense Council.</Text>

</Response>

<Response Type='Percentage' ScoreInfo="0.333*%" Label="B2 ">

<Text>___% Center for Sustainable Global Enterprise.</Text>

</Response>


<Text>___% Other.</Text>

</Response>

</Responses>


<Text>This question has to be answered by a L2 manager or higher.</Text>



4.6.3 Result




PUBLIC


4.7 Multiple-Percentage Question with a “Not Applicable” Option; Each Answer Can Be 0‒100%

These question types require the supplier to enter multiple percentages as the answer to the question, or to

choose "not applicable". Each question can be answered with a value from 0% to 100%, but the answers do not

need to add up to 100%. Answers of "not applicable" do not count towards the score.

This can be achieved by declaring the percentage responses as not grouped in the XML.

4.7.1 Example

Example


A. Not applicable. We do not have any business processes that are aligned with a certification program.

B. The percentage of business processes in accordance with one or more of the following certification

programs is as follows:


___% Council for Sustainable Global Enterprise.

___% Other.

If the supplier chooses the parent answer "B", three percentages between 0% and 100% (child answers) have to

be provided.

If the supplier chooses "not applicable", no further action is necessary for this question.

You can either use the entered percentage in the child answer as only source of the score (here: answers with

label B1, B2, or B3) or provide a fraction of the score simply for answering B and another fraction that is multiplied

by the percentage entered in the child question.

Example


percentages the supplier enters. If the supplier enters for B1 15%, B2 25%, and B3 30%, and B1 is scored

with 0.1, and B2 and B3 with 0.2 the score is calculated as follows:

Score(B)+Score(B1)*B1+Score(B2)*B2+Score(B3)*B3=0.5 + 0.1*0.15+0.2*0.25+0.2*0.3 = 0.625



The total of the ScoreInfo attribute of the parent answer and the highest ScoreInfo attribute of the child

answer must be 1 (while the highest child answer must not be higher than the parent answer). The total of all child

answers does not matter in this case.

20

PUBLIC




4.7.2 XML


<Title>


</Title>

<Question>



</Question>

<Responses>


<Text>Not applicable. We do not have any business processes that are aligned with a

certification program. </Text>

</Response>


<Text>The percentage of business processes in accordance with one or more of the

following certification programs is as follows:

</Text>

<Responses Group="false">

<Response ScoreInfo="0.333*%" Label="B1 ">


</Response>

<Response Type='Percentage' ScoreInfo="0.333*%" Label="B2

">


</Response>

<Response Type='Percentage' ScoreInfo="0.333*%" Label="B3

">


</Response>

</Responses>

</Response>

</Responses>






PUBLIC


4.7.3 Result


If the answer is "B", the supplier must enter multiple percentages.

4.8 Multiple-Percentage Question with No "Not Applicable" Option; Answers Add Up to 100%

These question types require the supplier to enter multiple percentages as the answer to the question. Each

question can be answered with a value from 0% to 100%, and the answers need to add up to 100%. All answers

count towards the score, as there is no "not applicable" option.

This can be achieved by declaring the percentage responses as grouped in the XML.

4.8.1 Example

22

PUBLIC




Example



___% Center for Sustainable Global Enterprise.

___% Other.

To answer this question, the supplier must provide three percentages between 0% and 100% after selecting the

corresponding answer.

If you use coefficients, they must be numbers between 0 and 1.

4.8.2 XML


<Title>


</Title>

<Question>



</Question>

<Responses Group="true">

<Response Type='Percentage' ScoreInfo=" 1.0*%" Label="B1 ">


</Response>



</Response>



</Response>

</Responses>





4.8.3 Result




PUBLIC


4.9 Multiple-Percentage Question with a "Not Applicable" Option; Answers Add Up to 100%

These question types require the supplier to enter multiple percentages as the answer to the question, or to

choose "not applicable". Each question can be answered with a value from 0% to 100%, and the answers need to

add up to 100%. Answers of "not applicable" do not count towards the score.

This can be achieved by declaring the percentage responses as grouped in the XML.

4.9.1 Example

Example


A. Not applicable. We do not have any business processes that are aligned with a certification program.

B. The percentage of business processes in accordance with one or more of the following certification

programs is as follows:


___% Council for Sustainable Global Enterprise.

___% Other.

If the supplier chooses the parent answer "B", three percentages between 0% and 100% (child answers) have to

be provided.

If the supplier chooses "not applicable", no further action is necessary for this question.

You can either use the entered percentage in the child answer as only source of the score (here: answers with

label B1, B2, or B3) or provide a fraction of the score simply for answering B and another fraction that is multiplied

by the percentage entered in the child question.

24

PUBLIC




Example


percentage the supplier enters, whereby the sum of the percentages cannot exceed 100%. . If the

supplier enters for B1 15%, B2 25%, and B3 30%, and B1 is scored with 0.1, and B2 and B3 with 0.2 the

score is calculated as follows:

Score(B)+Score(B1)*B1+Score(B2)*B2+Score(B3)*B3=0.5 + 0.1*0.15+0.2*0.25+0.2*0.3 = 0.625



The total of the ScoreInfo attribute of the parent answer and the highest ScoreInfo attribute of the child

answer must be 1 (while the highest child answer must not be higher than the parent answer). The total of all child

answers does not matter in this case.

4.9.2 XML


<Title>


</Title>

<Question>



</Question>

<Responses>


<Text>Not applicable. We do not have any business processes that are aligned with a

certification program. </Text>

</Response>


<Text>The percentage of business processes in accordance with one or more of the

following certification programs is as follows:

</Text>

<Responses Group="true">



</Response>



</Response>



PUBLIC




</Response>

</Responses>

</Response>

</Responses>




4.9.3 Result


If the answer is "B", the supplier must enter multiple percentages.

26

PUBLIC




4.10 Nested Question with Non-Percentage Answers and a "Not Applicable" Option

Questions of this type include a "not applicable" option as well as an answer option that leads to an additional list

of answer options. Answers of "not applicable" do not count towards the score.

4.10.1 Example

Example

What is your strategy to manage critical chemicals in your products?

A. Not applicable. We do not use chemicals in our products.

B. We have a company-wide strategy and provide the following information on our product labels:

B1. Name of chemical

B2. Name and amount of chemical

B3. Name, amount and class or risk of chemical

This question can be answered by choosing a child answer ("B1", "B2", or "B3") after choosing a parent answer

("B"). When choosing a parent answer, the supplier must also choose a child answer.

4.10.2 XML


<Title>

<Text>Chemicals</Text>

</Title>

<Question>

<Text>What is your strategy to manage critical chemicals in your products?</Text>

</Question>

<Responses>


<Text>Not applicable. We do not use chemicals in our products. </Text>

</Response>


<Text>We have a company-wide strategy and provide the following information on our

product labels:</Text>

<Responses>

<Response Type='Choice' ScoreInfo="0.100" Label="B1 ">

<Text>Name of chemical</Text>



PUBLIC


</Response>


<Text>Name and amout of chemical</Text>

</Response>


<Text>Name, amount and class of risk of chemical</Text>

</Response>

</Responses>

</Response>

</Responses>


<Text>This question has to be answered by an analytical chemist.</Text>



4.10.3 Result

On the user interface, the questions appear as follows:

If the answer is "B", the supplier must choose a child answer:

28

PUBLIC




4.11 Nonscorable Question with Upload Response Option

Questions of this type are answered by uploading a document. Answers to these response options do not count

towards the score.

4.11.1 Example

The following is an example of a nonscorable question with only an upload response option.

Example

Do you have any success stories you would like to share?

Upload attachment

The question can be answered by uploading a document of up to 10 MB in XML, PDF, TXT, XLS, XLSX, DOC,

DOCX, PPT, or PPTX format.

4.11.2 XML


<Title>

<Text>Nonscorable Question: Upload</Text>



PUBLIC


</Title>

<Question>

<Text>Do you have any success stories you would like to share?

</Text>

</Question>

<Responses>

<Response Type='Upload' ScoreInfo="" Label="A">

<Text>Upload attachment</Text>

</Response>

</Responses>


4.11.3 Result

On the user interface the question appears as follows:

4.12 Nonscorable Question with Free-Text Response Option

Questions of this type can be answered with a free-text response. Answers to these response options do not

count towards the score.

4.12.1 Example

Example

Please describe your main challenges regarding water use.

The question can be answered by providing a free-text response.

30

PUBLIC




4.12.2 XML


<Title>

<Text>Nonscorable Question: Text</Text>

</Title>

<Question>

<Text>Please describe your main challenges regarding water use.</Text>

</Question>

<Responses>

<Response Type='Text' ScoreInfo="" Label="A"><Text>Main challenges regarding

water use.</Text></Response>

</Responses>





4.12.3 Result



PUBLIC


4.13 Scorable Question with Nested Upload/Free-Text Response Options

Questions of this type include free-text and upload response options. Answers to these response options count

towards the score.

4.13.1 Example

The following is a scorable question with a nested upload and free-text response option.

Example

What is your strategy to manage critical chemicals in your products?

A. Not applicable. We do not use chemicals in our products.

B. We have a company-wide strategy and provide the following information on our product labels:

B1. Please give more details.

B2. Upload Certificate

This question can be answered by providing a free-text response and uploading a document after choosing a

parent answer ("B"). The uploaded document can be up to 10 MB and in XML, PDF, TXT, XLS, XLSX, DOC, DOCX,

PPT, or PPTX format.

4.13.2 XML


<Title><Text>Chemicals</Text></Title>

<Question><Text>What is your strategy to manage critical chemicals in your

products?</Text></Question>

<Responses>

<Response Type='Choice' ScoreInfo="" Label="A "><Text>Not applicable. We do

not use chemicals in our products. </Text></Response>

<Response Type='Choice' ScoreInfo="1.00" Label="B "><Text>We have a

company-wide strategy and provide the following information on our product

labels:</Text>

<Responses>

<Response Type='Text' ScoreInfo="" Label="C1"><Text>Please

give more details.</Text></Response>

<Response Type='Upload' ScoreInfo=""

Label="C2"><Text>Upload certificate.</Text></Response>

</Responses>

</Response>

32

PUBLIC




</Responses>





4.13.3 Result

On the user interface the question appears as follows:

If the answer is "B", the supplier must provide a free-text response and upload a document.


Remaining XML Elements

PUBLIC


5 Remaining XML Elements

5.1 Required Elements

In the header section, the name, version, and timestamp of creation are required elements. After the header

section, there is an introduction section that requires a <Text> element containing an introduction text for the

questionnaire (limited to 5000 characters). The supplier can open this introduction text by choosing the

Information link in the top left corner.

In addition to the question and answers of each KPI, an Additional Guidance link is required. You can include this

link by embedding a <Text> element into an <AdditionalGuidance> element, which is embedded in each KPI.

The supplier can open this text by choosing the Additional Guidance link underneath each KPI.

5.2 XML Validation

To ensure that the system interprets your XML file correctly, you should validate it against the XSD file, which

describes the structure of the expected XML file. You can do this with several online tools or by uploading the draft

XML files to SAP Product Stewardship Network. If the XML file is not compliant with the XSD file, the system

displays a message indicating the source of the error, such as the one shown below.

Example

In this example, the <Text> element in the <AdditionalInformation> element was omitted. The XSD file

requires the <Text> element at this point.

34

PUBLIC




Note

The system does not allow you to use certain questions if an answer has a top score of 0.9, for example.

You must ensure that the user can always achieve the full score of 1 for each question.

5.3 User Input Validation

When a supplier answers a questionnaire, the system shows errors for the following:

• Entering a percentage less than 0% or greater than 100%

• Entering percentages in child answers that exceed 100% in total

• Not choosing an answer at all

Leaving a percentage field blank rather than entering 0%

5.4 Uploading the XML File

Once you have created the XML file, you can upload it to SAP Product Stewardship Network. To do so, proceed as

follows:

1. Go to the Own Survey Content tab of the Content Library work center.

2. Choose the Upload Questionnaire button.

3. Browse for the XML file you created, and choose the file.

4. When the data transfer is complete, choose Upload.

5. Close the dialog box to view the results.

6. Click the name of your questionnaire to view it.

If you are satisfied with the system's interpretation of your XML, you can use your own questionnaire in surveys

you send to your suppliers. Otherwise, you can delete the questionnaire, modify your XML, and upload the file

again.

5.5 Version Management

After you have uploaded a custom questionnaire to SAP Product Stewardship Network, you cannot upload same

version again. Instead, you must edit the version number (<Version>) and date of creation (<Created>) in the

<header> section to create a new version. The version number is visible in the application and serves as

identification for users and for information purposes. The date of creation is the actual element that is used by the

application to detect the most current version.

When you edit the questionnaire and upload a newer version, the application automatically detects that the old

and the new questionnaire belong together by recognizing the <Name> element within the <ContentCategory>

element. In this case, the new questionnaire replaces the old one. However, if you have already used a version of a

questionnaire, you cannot delete this version. Surveys that have already been sent out and answered do not



PUBLIC


change when you upload a new version. Therefore, if you want your suppliers to use the updated questionnaire,

you have to create a new survey.

www.sap.com/contactsap


No part of this publication may be reproduced or transmitted in any

form or for any purpose without the express permission of SAP SE

or an SAP affiliate company.

SAP and other SAP products and services mentioned herein as well

as their respective logos are trademarks or registered trademarks of

SAP SE (or an SAP affiliate company) in Germany and other

countries. All other product and service names mentioned are the

trademarks of their respective companies. Please see http://www.

sap.com/corporate-en/legal/copyright/index.epx#trademark for

additional trademark information and notices.

http://www.sap.com/corporate-en/legal/copyright/index.epx#trademark

http://www.sap.com/corporate-en/legal/copyright/index.epx#trademark

Documents

Uploading Custom Questionnaires - help.sap.com · Uploading Custom Questionnaires ... Choose the Upload Questionnaire button. 3.