Upload Guide SAP Product Stewardship Network 3.48 Document Version: 1.4 – 2017-08-27 PUBLIC Uploading Custom Questionnaires Sustainability Assessment Scenario
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 .
Uploading Custom Questionnaires
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
© 2017 SAP SE or an SAP affiliate company. All rights reserved.
Uploading Custom Questionnaires
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
Uploading Custom Questionnaires
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..
Uploading Custom Questionnaires
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.
Uploading Custom Questionnaires
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
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
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.
Uploading Custom Questionnaires
Preparing the XML File
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 9
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
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Preparing the XML File
<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:
Uploading Custom Questionnaires
Preparing the XML File
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 11
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
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Preparing the XML File
<… ScoreInfo="0.000" …>: Question does count towards the score, but the score for this answer is 0.
4.2.2 XML
<KeyPerformanceIndicator ID="KPI-02">
<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>
<Response Type='Choice' ScoreInfo="0.000" Label="B ">
<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>
<AdditionalGuidance>
<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>
</AdditionalGuidance>
</KeyPerformanceIndicator>
Uploading Custom Questionnaires
Preparing the XML File
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 13
4.2.3 Result
On the user interface, the question appears as follows:
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
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Preparing the XML File
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
<KeyPerformanceIndicator ID="KPI-03">
<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>
<AdditionalGuidance>
<Text>Liquid fertilizers that contain water do not count into this
percentage.</Text>
</AdditionalGuidance>
</KeyPerformanceIndicator>
4.3.3 Result
On the user interface, the question appears as follows:
Uploading Custom Questionnaires
Preparing the XML File
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 15
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
<KeyPerformanceIndicator ID="KPI-03">
<Title>
<Text>Harvesting</Text>
</Title>
16
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Preparing the XML File
<Question>
<Text>What is the percentage of products in your product portfolio which are
responsibly lifted from your own fields?</Text>
</Question>
<Responses>
<Response Type='Choice' ScoreInfo="" Label="A ">
<Text>Not applicable. None of the products we sell are lifted from our own
fields.</Text>
</Response>
<Response Type='Choice' ScoreInfo="0.000" Label="B ">
<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>
<AdditionalGuidance>
<Text>This question can only be answered by farmers who own, and do not rent
land.</Text>
</AdditionalGuidance>
</KeyPerformanceIndicator>
4.5.2 Result
On the user interface, the question appears as follows:
If the answer is "B", the supplier must enter a percentage:
Uploading Custom Questionnaires
Preparing the XML File
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 17
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
<KeyPerformanceIndicator ID="KPI-05">
<Title>
<Text>Business processes</Text>
18
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Preparing the XML File
</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>
<Response Type='Percentage' ScoreInfo="0.333*%" Label="B3 ">
<Text>___% Other.</Text>
</Response>
</Responses>
<AdditionalGuidance>
<Text>This question has to be answered by a L2 manager or higher.</Text>
</AdditionalGuidance>
</KeyPerformanceIndicator>
4.6.3 Result
On the user interface, the question appears as follows:
Uploading Custom Questionnaires
Preparing the XML File
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 19
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
What is the percentage of business processes which are fully aligned with a certification program?
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:
___% Natural Resources Defense Council.
___% 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
The supplier could receive 0.5 points simply for choosing B. The other 0.5 points are multiplied by the
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
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.
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
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Preparing the XML File
4.7.2 XML
<KeyPerformanceIndicator ID="KPI-06">
<Title>
<Text>Business processes</Text>
</Title>
<Question>
<Text>What is the percentage of business processes which are fully aligned with a
certification program?</Text>
</Question>
<Responses>
<Response Type='Choice' ScoreInfo="" Label="A ">
<Text>Not applicable. We do not have any business processes that are aligned with a
certification program. </Text>
</Response>
<Response Type='Choice' ScoreInfo="0.000" Label="B ">
<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 ">
<Text>___% Natural Resources Defense Council.</Text>
</Response>
<Response Type='Percentage' ScoreInfo="0.333*%" Label="B2
">
<Text>___% Center for Sustainable Global Enterprise.</Text>
</Response>
<Response Type='Percentage' ScoreInfo="0.333*%" Label="B3
">
<Text>___% Other.</Text>
</Response>
</Responses>
</Response>
</Responses>
<AdditionalGuidance>
<Text>This question has to be answered by a L2 manager or higher.</Text>
</AdditionalGuidance>
Uploading Custom Questionnaires
Preparing the XML File
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 21
4.7.3 Result
On the user interface, the question appears as follows:
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
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Preparing the XML File
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.8.2 XML
<KeyPerformanceIndicator ID="KPI-05">
<Title>
<Text>Business processes</Text>
</Title>
<Question>
<Text>What is the percentage of business processes which are fully aligned with a
certification program?</Text>
</Question>
<Responses Group="true">
<Response Type='Percentage' ScoreInfo=" 1.0*%" Label="B1 ">
<Text>___% Natural Resources Defense Council.</Text>
</Response>
<Response Type='Percentage' ScoreInfo="1.0*%" Label="B2 ">
<Text>___% Center for Sustainable Global Enterprise.</Text>
</Response>
<Response Type='Percentage' ScoreInfo="1.0*%" Label="B3 ">
<Text>___% Other.</Text>
</Response>
</Responses>
<AdditionalGuidance>
<Text>This question has to be answered by a L2 manager or higher.</Text>
</AdditionalGuidance>
</KeyPerformanceIndicator>
4.8.3 Result
On the user interface, the question appears as follows:
Uploading Custom Questionnaires
Preparing the XML File
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 23
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
What is the percentage of business processes which are fully aligned with a certification program?
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:
___% Natural Resources Defense Council.
___% 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
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Preparing the XML File
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, 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
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.
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
<KeyPerformanceIndicator ID="KPI-06">
<Title>
<Text>Business processes</Text>
</Title>
<Question>
<Text>What is the percentage of business processes which are fully aligned with a
certification program?</Text>
</Question>
<Responses>
<Response Type='Choice' ScoreInfo="" Label="A ">
<Text>Not applicable. We do not have any business processes that are aligned with a
certification program. </Text>
</Response>
<Response Type='Choice' ScoreInfo="0.000" Label="B ">
<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 Type='Percentage' ScoreInfo="1.0*%" Label="B1 ">
<Text>___% Natural Resources Defense Council.</Text>
</Response>
<Response Type='Percentage' ScoreInfo="1.0*%" Label="B2 ">
<Text>___% Center for Sustainable Global Enterprise.</Text>
</Response>
Uploading Custom Questionnaires
Preparing the XML File
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 25
<Response Type='Percentage' ScoreInfo="1.0*%" Label="B3 ">
<Text>___% Other.</Text>
</Response>
</Responses>
</Response>
</Responses>
<AdditionalGuidance>
<Text>This question has to be answered by a L2 manager or higher.</Text>
</AdditionalGuidance>
4.9.3 Result
On the user interface, the question appears as follows:
If the answer is "B", the supplier must enter multiple percentages.
26
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Preparing the XML File
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
<KeyPerformanceIndicator ID="KPI-07">
<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="0.700" Label="B ">
<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>
Uploading Custom Questionnaires
Preparing the XML File
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 27
</Response>
<Response Type='Choice' ScoreInfo="0.200" Label="B2 ">
<Text>Name and amout of chemical</Text>
</Response>
<Response Type='Choice' ScoreInfo="0.300" Label="B3 ">
<Text>Name, amount and class of risk of chemical</Text>
</Response>
</Responses>
</Response>
</Responses>
<AdditionalGuidance>
<Text>This question has to be answered by an analytical chemist.</Text>
</AdditionalGuidance>
</KeyPerformanceIndicator>
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
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Preparing the XML File
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
<KeyPerformanceIndicator ID="KPI-09">
<Title>
<Text>Nonscorable Question: Upload</Text>
Uploading Custom Questionnaires
Preparing the XML File
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 29
</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>
</KeyPerformanceIndicator>
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
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Preparing the XML File
4.12.2 XML
<KeyPerformanceIndicator ID="KPI-08">
<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>
<AdditionalGuidance>
<Text>This question has to be answered by an analytical chemist.</Text>
</AdditionalGuidance>
</KeyPerformanceIndicator>
4.12.3 Result
Uploading Custom Questionnaires
Preparing the XML File
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 31
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
<KeyPerformanceIndicator ID="KPI-07">
<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
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Preparing the XML File
</Responses>
<AdditionalGuidance>
<Text>This question has to be answered by an analytical chemist.</Text>
</AdditionalGuidance>
</KeyPerformanceIndicator>
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.
Uploading Custom Questionnaires
Remaining XML Elements
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 33
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
© 2017 SAP SE or an SAP affiliate company. All rights reserved..
Uploading Custom Questionnaires
Remaining XML Elements
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
Uploading Custom Questionnaires
Remaining XML Elements
PUBLIC
© 2017 SAP SE or an SAP affiliate company. All rights reserved.. 35
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
© 2017 SAP SE or an SAP affiliate company. All rights reserved.
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.