
Explaining Document Collaboration in SAP Integrated Product Development
Objective
After completing this lesson, you will be able to manage document collaboration within SAP Integrated Product Development.
Document Collaboration Overview

Creation and Update of Folders
The Change Coordinator (Collaboration creator) creates the folders within Collaboration and uploads the files to the Collaboration. After this is completed, the other members of the Collaboration will provide their input on the files.
Prerequisites
You must have proper authorization in the Collaboration (Administrator or Contributor). For more information on Collaboration Authorization, see Authorization Within a Collaboration.
Steps
Choose the My Collaborations SAP Fiori tile.

Open the Collaboration that you want to add a folder to. Once the Collaboration is opened, choose the Shared Documents tab, then select Folder from the Create dropdown, and enter a name for your new folder.

Choose Save.
To rename a folder, select the pencil icon (Rename), and then enter a new name for the folder.
Upload/Download and Update Files to Folders
Prerequisites
You must have proper authorization in the Collaboration (Administrator or Contributor). For more information on Collaboration Authorization, see Authorization Within a Collaboration.
Steps
In a collaboration, choose the Shared Documents tab.
To upload a file, choose Create, and then select Document.
Browse for the required file and then choose OK.

Track Document Changes in the Collaboration (History)
Steps
In a collaboration, choose the History tab. This section of the Collaboration allows you to sort, filter, and show the history of changes to folders and files.
Result

Files and Folders move within a Collaboration
You can move files and folders within a Collaboration by performing the following steps.
Steps
In a collaboration, choose the Shared Documents tab.
Select the required files and folders to move
Choose (Move) and then select Move or Copy.
Go to the folder where you want to place the files, and choose Move Here or Copy Here.
Result
If you used Move, the selected files and folders are moved out of their original location. If you used Copy, a copy of the selected files is added to the new location.

Search for Files and Folders Using the Filter Field
Steps
To search for files and folders, use the Search field.
The search is applied only to the file and displayed folder names. The content within the folders is not searched.
To return to the folder from where you started the search, choose the folder in the breadcrumbs.
To sort the list of files and folders, choose (Sort), and then select the required option. The files and folders are sorted by name, with the folder names before the file names.

Creation of Different Versions of a File
You can create different versions of a file and access any of them anytime by performing the following steps.
Steps
In a collaboration, choose the Shared Documents tab.
Select the file for which you want to create a new version.
Choose Manage Document, then choose to Check Out to download the file for editing.
Edit the file on your local system and then choose Manage Document→Check In to upload the new version.
If you want to cancel the creation of the new file version, choose Manage Document→Cancel Checkout.
Choose the required check-in option, enter a comment if necessary, and then choose OK.
To view the versions of a file, select the file, and then choose "I" (Show Properties).
Result: The properties are displayed. The Versions section displays information such as the file versions, who modified the file, the date of modification, comments, and the actions allowed on the file.
When you select a particular version of a file, you can download it.
To avoid duplicate versioning, no other collaboration participant is allowed to edit a file while you are editing it.

Opening Files in Shared Product Data
Use the following steps to open files or documents within the Shared Product Data tab. The Collaboration Participant would do this to access documents from the shared product data tab easily and to organize which documents are associated with which shared product data objects.
Prerequisites
The feature must be enabled in the collaboration type.
Steps
In a collaboration, choose the Shared Documents tab.
Select the file to open.
Choose Open in Shared Product Data.
The selected file opens within the Shared Product Data tab.

Opening Files in Visualization
The Upload to Visualization feature in Shared Documents allows users to create a Visualization of a single object by combining several assemblies and part (CAD) files of an object.
Prerequisites
1: Required settings are enabled. Please reach out to your administrator if you do not see the button.
2: The files uploaded must be in one of the supported CAD, DCC, or Drawing formats.
| Design File Type | File Format | Extension |
|---|---|---|
| 2D | Joint Photographic Experts Group | Jpg/jpeg |
| Portable Network Graphics | png | |
| Drawing Exchange Format | dxf | |
| Drawing | dwg | |
| 3D | Visual Design Stream | vds |
Steps
In Shared Documents, create a folder using the Create button.
Name the folder and choose Save.
Open the folder, then upload or drag and drop all the interlinked CAD files into this folder. Wait until the Upload of all the part files is completed. (This may take up to several minutes).
Navigate back to the parent folder in step 2.
Select the folder you have just created and upload the files.
Select the Upload to Visualization button. The Upload to visualization button remains disabled until a folder is selected.
Result: A pop-up dialog box appears.
Select the primary design file. (File which associates the assembly of all part files to a visualization; example - NameofObjectPartCATProduct).
Choose OK and wait for the page to refresh.
Choose the Design Model tab.
An image of the object (for which you uploaded the part files) is displayed just before the primary design file name.
Once the import is successful, click on the design model entry to open in Visualization.
Result

Configuration of E-mail Notifications
Note
Mandatory Configuration for E-mails: This has been completed already, but e-mails will not be sent out to participants of the Collaboration. Each participant would need to add their email address, which will not be possible for this training.
Destination for E-mail Notifications
This is a mandatory destination used for sending e-mail notifications to registered users when they are added as participants in collaborations. It is also used for sending e-mail notifications to assignees of workflows and work items when added in collaborations and for subscribed event notifications for document changes.
Prerequisites
- You have the details for configuring SMTP e-mail for your scenario.
- Your mail server has the following characteristics:
- It supports the SMTP STARTTLS command on ports 587 or 465.
- It requires authentication.
Steps
You can either import or create the destination. To import the destination, save the following template as a file.
Type=MAIL
Name=bpmworkflowruntime_mail
mail.user=
mail.password=
mail.smtp.host=mail.example.com
mail.smtp.port=587
mail.transport.protocol=smtp
mail.smtp.starttls.enable=true
mail.smtp.starttls.required=true
mail.smtp.auth=true
mail.smtp.from=notification@example.com
mail.smtp.ssl.checkserveridentity=true
mail.epdc.participant.invite=true
Import the destination from the file, and set the values for user, password, host, port, and from address.
Use the following information when creating the destination.
Field Value Name bpmworkflowruntime_mail Type MAIL Description Used for sending mail to participants when they are added to collaborations. User Enter the user for logging in to the mail server. Password Enter the password for logging in to the mail server. Under the Additional Properties panel, the following properties must be maintained.
To create a property, choose New Property. In the drop-down field, enter the property name as mentioned in the following table, and then specify the value.
Property Value mail.transport.protocol smtp mail.smtp.auth true mail.smtp.starttls.enable true mail.smtp.starttls.required true mail.smtp.host Host name of your mail server mail.smtp.port Port on which your mail server listens for connections (typically 587, in rare cases 465) mail.smtp.from Enter the user entered in the destination, in the format user@domain.com. This address must belong to an existing mailbox.
mail.smtp.ssl.checkserveridentity (Optional) true or false; default is true if no value is provided. mail.epdc.participant.invite true Optional: you can integrate SAP Document Management Service (DMS) with SAP Integrated Product Development (IPD). This would allow you to select files from within DMS and upload/download them into IPD. For our purposes, this has not been configured. But below is some reference information for your understanding, but it will not be demonstrated in this training.
You can integrate Document Management (DMS) with the collaboration capability in SAP Integrated Product Development by following the steps listed here: https://help.sap.com/docs/SAP_S4HANA_ON-PREMISE/1317b7d3a93c4763a041b49532666fd7/22ce63e4075643978f3972f0d65630f9.html?version=2021.001
Reference Links
Example
Kindly refer to Business Configuration for more information on the business configuration for each capability: https://help.sap.com/docs/PLM_EPD/1bfdb8b2f0264b66a818a2a889ee8c31/27b8d3c9e83e4ae5b956deb70ce1f336.html
Summary
Let's Summarize What You've Learned:
- Configuration of e-mail notifications and integration with SAP Document Management System (DMS).
- Users with appropriate authorization create, rename, and organize folders within the Shared Documents tab of an SAP Collaboration.
- Files are uploaded, downloaded, and updated, with all changes comprehensively tracked in the History tab.
- Version control is managed through a structured check-out and check-in process, ensuring secure and sequential document modifications.
- How to view and navigate design model files to Visualization.
- Files can be linked to Shared Product Data or prepared for visualization in specialized design formats.
- Efficient navigation and content discovery are supported by search and sort functionalities for files and folders.