Note
• The header attributes must be Name and Code in the same order and case. You can refer to
the ISO code set for locations. The following is an example of the CSV file content.
Example
Name,Code
• The header attributes must be entered in English and are validated for correctness.
Argentina,AR Australia,AUS India,IN Sweden,SE.
• The supplier locations can be entered in any language of your choice, and are not validated for
correctness. It is left to your discretion to enter the locations correctly.
• You can only update a CSV file with a maximum file size of 20 MB.
• Do not enter any personal data in the CSV file. Data from the file is displayed as a suggestion
list when searching for suppliers in collaborations.
• To view the existing data, choose (Export).
Option 2
2. To add a new list of product and service categories, choose Add.
In the Add Supplier Location dialog, enter the following values:
Field
Name
Code
4. Save changes.
Editing or Deleting Supplier Location
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Supplier Data tab.
3. In the Supplier Locations section. Choose the supplier location.
Select a supplier location to enable Edit and Delete buttons:
• To edit the supplier location, choose Edit.
• To delete the supplier location, choose Delete.
4. Save changes.
[Link] Working with Reference Objects
Use the Configure Collaboration app to create, edit, or delete custom reference objects. The standard reference
objects that belong to the object types Collaboration, Specification, Requirements, Change Record, Product
Administration Guide
Business Configuration PUBLIC 241
Package Exchange (PPX), Configuration Management Baseline, Specification Management, Product Version,
and Formulation cannot be edited. Reference objects that are added as associated references to any of the
collaboration types cannot be edited or deleted.
Prerequisites
You must be assigned to the COLLABORATION_ADMIN group as mentioned in the Role Templates for
Collaboration [page 56].
Context
Reference objects are entities that are defined for a business object. There are two types of reference objects:
• Custom reference objects: Custom reference objects can be added as needed, based on your business
requirements by your collaboration administrator, using the Configure Collaboration app.
• Standard Reference Objects
The following table displays the preshipped reference objects and the values for their key and non-key
fields:
Reference Object Key Field Non-Key Field
COLLABORATION Key1: COLLABORATION_ID not applicable
Key2: DESCRIPTION
SPECIFICATION Key1: ID Non-Key1: Purpose
Key2: DESCRIPTION
REQUIREMENT Key1: EADOBJECTID Non-Key1: MODELVERSION
Key2: MODELOBJECTID Non-Key2: REQUIREMENTVERSION
Key3: NAME Non-Key3: MODELNAME
Key4: DIAGRAMREPOSITORYID
Key5: PRIORITY
Key6: DESCRIPTION
PPX Key1: ID Non-Key1: Valid From
Key2: DESCRIPTION
Key3: TYPE
Key4: SYSTEM
Administration Guide
242 PUBLIC Business Configuration
Reference Object Key Field Non-Key Field
CHANGE_RECORD Key1: Change Record Non-Key1: Valid From
Key2: Record Type
Key3: Record Status
Key4: Change Responsible
Key5: Expected Completion Date
CONFIG_MGMNT_BASELINE Key1: GUID (The value is hidden to the Non-Key1: Baseline Description
users)
Non-Key2: Controlled Object
Key2: Baseline ID
Non-Key3: Controlled Object Descrip-
Key3: Baseline Version tion
DESIGN_ITEM_VERSION Key1: Design Number Non-Key1: Minor Version ID
Key2: Design Item ID Non-Key2: Description
Key3: Major Version
Key4: Major Version ID
SPECIFICATION_MANAGEMENT Internal ID: UUID (The value is hidden Non-Key1: NAME (The value is hidden
to the users) to the users)
Key1: DISPLAY ID Non-Key2: STATUS (The value is hid-
den to the users)
Key2: VERSION
PRODUCT_VERSION Key1: ID Non-Key1: Description
Key2: Product ID
Key3: Version
Key4: Minor Version
FORMULATION Key1: Name -
Key2: ID
Key3: Primary Output Specification
Key4: Alternative
Key5: Version
SAP Ariba Sourcing
For the SAP Ariba sourcing use case, it is mandatory to create custom reference objects as shown in this
table:
Reference Object (case sensitive) Key Field Non-Key Field
ARIBA Key1: type not applicable
Administration Guide
Business Configuration PUBLIC 243
Reference Object (case sensitive) Key Field Non-Key Field
MATERIAL Key1: materialNumber not applicable
Creating a Reference Object
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Reference Objects tab, choose Create.
The page displays with the header data, keys, and non-keys tabs.
3. On the Header Data tab, to create a reference object enter the following values:
Field User Action Comments
Reference Object Enter an object type with a maximum The following special characters are
length of 30 characters. allowed: underscore (_), dash (-), or
space (" ").
Select Language The default language is English. -
Navigation URL Enter a URL that uses one of these For the URL to navigate to a custom
protocols: http, https, or ftp. reference object, note the following:
• The navigation URL is an optional
field.
• The navigation URL is case-sensi-
tive.
• Both keys and non-keys are valid
placeholders.
• Only predefined keys are allowed.
• The key value is used to reference
the associated value of the key.
• Example
[Link]
main>/?<param-
name1>={key1}&<param-
name2>={key2}&<param-
name3>={key3}&<param-
name4>={key4}&<param-
name5>={key5}&<param-
name6>={nonkey1}
4. To add keys, on the Keys tab, choose Add.
In the table that is displayed, enter the following values:
Administration Guide
244 PUBLIC Business Configuration
Column User Actions Comments
Fields You can enter up to 6 keys. It's mandatory to enter a key. A maxi-
mum of 6 keys are allowed.
For example: if the object type is
Document, you could enter these
keys:
• Key1 is DOKNR
• Key2 is DOKAR
• Key3 is DOKTL
• Key4 is DOKVR
The default language is English.
Value Enter any value for keys. Hypertext does not support place-
holders.
Select Language The default language is Eng- -
lish.
Data type Select text or hypertext as re- Default data type is text.
quired.
Hide Select this checkbox to hide Default is unhide – meaning it
any key is visible to the user in the My
Collaborations app under Reference
Objects.
Note
You can't hide keys in the col-
laboration header of the My
Collaborations app if they're in
use.
5. To configure preferences for the key value, choose .
The page displays with the Preferences and Selection Values tabs.
6. To configure your preferences for keys with a text Data Type, on the Preferences tab choose one of the
below options:
• To enable users to enter free text value for keys, choose Allow users to enter custom value.
• To enable users to select a single value for keys, choose Allow users to select only one value.
To make it easier for your users to select one value for reference object on the Reference Objects of the
My Collaborations app you can add values on the Selection Values tab.
Note
• You can delete the value that was added only if the particular reference object is not used in any
collaboration.
7. To configure your preferences for keys with a hypertext Data Type, enter the following values:
Administration Guide
Business Configuration PUBLIC 245
Field Comments
Link Add a link value. This is optional.
Enter a valid URL Enter a URL that uses one of these protocols: http, https,
or ftp.
Note
Ensure that both fields are either filled or left empty,
and partial entry into one field is not allowed.
Your users see the default hypertext value in the Reference Objects of the My Collaborations app.
8. To add non-keys, on the Non-Keys tab, choose Add.
In the table that is displayed, enter the following values:
Column User Actions Comments
Fields Enter any free text. Only 10 non-key fields are allowed.
• Non-keys are optional.
• Non-key fields have to be in se-
quence.
For example:
• Non-Key1 is created by
• Non-Key2 is modified by
• Non-Key3 is a description
The default language is English.
Value Enter any value. Hypertext does not support place-
holders.
Select Language The default language is Eng- -
lish.
Data type Select text or hypertext as re- Default data type is text.
quired.
Administration Guide
246 PUBLIC Business Configuration
Column User Actions Comments
Hide Select this checkbox to hide Default is unhide – meaning it
any non-key is visible to the user in the My
Collaborations app under Reference
Objects.
Note
You can't hide non-keys in the
collaboration header of the My
Collaborations app if they're in
use.
9. To configure your preferences for non-keys with a text Data Type, on the Preferences tab choose one of the
below options:
• To enable users to enter free text value for non-keys, choose Allow users to enter custom value.
• To enable users to select a single value for non-keys, choose Allow users to select only one value.
To make it easier for your users to select one value for reference object on the Reference Objects of the
My Collaborations app you can add values on the Selection Values tab.
Note
• You can delete the value that was added only if the particular reference object is not used in any
collaboration.
10. To configure your preferences for non-keys with a hypertext Data Type, enter the following values:
Field Comments
Link Add a link value. This is optional.
Enter a valid URL Enter a URL that uses one of these protocols: http, https,
or ftp.
Note
Ensure that both fields are either filled or left empty,
and partial entry into one field is not allowed.
Your users see the default hypertext value in the Reference Objects of the My Collaborations app.
11. Save changes.
Editing a Reference Object
You edit a reference object. The reference objects that are added as associated references to any of the
collaboration types cannot be edited.
Administration Guide
Business Configuration PUBLIC 247
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Reference Objects tab, choose in the navigation panel.
3. Choose Edit.
The page displays with the header data, keys, and non-keys tabs.
4. Edit the following values:
Field User Action Comments
Reference Object Enter an object type with a maximum The following special characters are
length of 30 characters. allowed: underscore (_) and en dash
(-).
Select Language Define a reference object only in Eng- The selected language is added to
lish. the Display Language list. For more in-
formation, see Filtering Texts by Lan-
Select the language that you want
guage [page 260].
to use for the translation. For the
information about the supported lan-
guages, see Overview [page 8].
The default language is English.
Your business users see the text in the
default language if you don't configure
a different preferred language.
Navigation URL Enter a URL that uses any of these • The navigation URL is not a man-
protocols: http or https or ftp datory field.
• The navigation URL is case sensi-
tive.
• Both keys and non-keys are valid
placeholders.
• The key value which is used to
reference associated value of the
key.
• Example
[Link]
main>/?<param-name1>={
key1}&<param-name2>={
key2}&<param-name3>={
key3}&<param-name4>={
key4}&<param-name5>={
key5}&<param-name6>={
nonkey1}
5. In the Keys section, edit the following values:
Administration Guide
248 PUBLIC Business Configuration
Column User Actions Comments
Fields (This is read only) It is mandatory to enter a key. A maxi-
mum of 6 keys are allowed.
The default language is Eng-
lish. For example: Object type is Docu-
ment, then:
Your business users see the
text in the default language if • Key1 is DOKNR
you don't configure a different • Key2 is DOKAR
preferred language. • Key3 is DOKTL
• Key4 is DOKVR
Value Enter any value for keys. Hypertext does not support place-
holders.
Select Language Select the language that you The selected language is added to
want to use for the transla- the Display Language list. For more in-
tion. For the information about formation, see Filtering Texts by Lan-
the supported languages, see guage [page 260].
Overview [page 8].
The default language is Eng-
lish.
Your business users see the
text in the default language if
you don't configure a different
preferred language.
The default language is Eng-
lish.
Data type Select text or hypertext as re- Default data type is text.
quired.
Hide Select this checkbox to hide Default is unhide – meaning it
any key is visible to the user in the My
Collaborations app under Reference
Objects.
6. In the Non-Keys section, edit the following values:
Administration Guide
Business Configuration PUBLIC 249
Column User Actions Comments
Fields (This is read only) Only 10 non-key fields are allowed
The default language is Eng- Non-key fields are optional.
lish.
Non-key fields have to be in sequence.
Your business users see the
For example:
text in the default language if
you don't configure a different • Non-Key1 is created by
preferred language. • Non-Key2 is modified by
• Non-Key3 is a description
The selected language is added to
the Display Language list. For more in-
formation, see Filtering Texts by Lan-
guage [page 260].
Value Enter any value for non- keys. Hypertext does not support place-
holders.
Select Language Select the language that you The selected language is added to
want to use for the transla- the Display Language list. For more in-
tion. For the information about formation, see Filtering Texts by Lan-
the supported languages, see guage [page 260].
Overview [page 8].
The default language is Eng-
lish.
Your business users see the
text in the default language if
you don't configure a different
preferred language.
The default language is Eng-
lish.
Data type Select text or hypertext as re- Default data type is text.
quired.
Hide Select this checkbox to hide Default is unhide – meaning it
any non- key is visible to the user in the My
Collaborations app under Reference
Objects.
7. Save your changes.
Deleting a Reference Object
You delete a reference object.
Administration Guide
250 PUBLIC Business Configuration
