Introducing SAP Integrated Product Development Collaboration
Leveraging SAP Integrated Product Development for Development Collaboration
Collaborating with SAP Integrated Product Development for Supplier Collaboration
Collaborating with SAP Integrated Product Development for Document Collaboration
Collaborating with SAP Integrated Product Development for Specification Collaboration

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

A diagram outlining business process capabilities in SAP Integrated Product Development, with phases Define, Develop, Deliver, and product data management integration.

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

  1. Choose the My Collaborations SAP Fiori tile.

    Choose he My Collaborations tile.
  2. 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 Create > Folder and enter a name.
  3. 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

  1. In a collaboration, choose the Shared Documents tab.

  2. To upload a file, choose Create, and then select Document.

  3. Browse for the required file and then choose OK.

    Screenshot highlighting the preceding steps.

Track Document Changes in the Collaboration (History)

Steps

  1. 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

Sample history tab, highlighting the Search field and the File Log.

Files and Folders move within a Collaboration

You can move files and folders within a Collaboration by performing the following steps.

Steps

  1. In a collaboration, choose the Shared Documents tab.

  2. Select the required files and folders to move

  3. Choose (Move) and then select Move or Copy.

  4. 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.

Select the file and choose Move.

Search for Files and Folders Using the Filter Field

Steps

  1. 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.

  2. To return to the folder from where you started the search, choose the folder in the breadcrumbs.

  3. 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.

    In the Shared Documents tab, the Search field is highlighted.

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

  1. In a collaboration, choose the Shared Documents tab.

  2. Select the file for which you want to create a new version.

  3. Choose Manage Document, then choose to Check Out to download the file for editing.

  4. Edit the file on your local system and then choose Manage DocumentCheck In to upload the new version.

    If you want to cancel the creation of the new file version, choose Manage DocumentCancel Checkout.

  5. Choose the required check-in option, enter a comment if necessary, and then choose OK.

  6. 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.

  7. 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.Choose Manage Document > Checkout.

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

  1. In a collaboration, choose the Shared Documents tab.

  2. Select the file to open.

  3. Choose Open in Shared Product Data.

    The selected file opens within the Shared Product Data tab.

    Choose Open in Shared Product Data.

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 TypeFile FormatExtension
2DJoint Photographic Experts GroupJpg/jpeg
 Portable Network Graphicspng
 Drawing Exchange Formatdxf
 Drawingdwg
3DVisual Design Streamvds

Steps

  1. In Shared Documents, create a folder using the Create button.

  2. Name the folder and choose Save.

  3. 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).

  4. Navigate back to the parent folder in step 2.

  5. Select the folder you have just created and upload the files.

  6. 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.

  7. Select the primary design file. (File which associates the assembly of all part files to a visualization; example - NameofObjectPartCATProduct).

  8. Choose OK and wait for the page to refresh.

  9. 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.

  10. Once the import is successful, click on the design model entry to open in Visualization.

Result

In the Shared Documents folder, choose Upload to Visualization.

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

  1. 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.

  2. Use the following information when creating the destination.

    FieldValue
    Namebpmworkflowruntime_mail
    TypeMAIL
    DescriptionUsed for sending mail to participants when they are added to collaborations.
    UserEnter the user for logging in to the mail server.
    PasswordEnter the password for logging in to the mail server.
  3. 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.

    PropertyValue
    mail.transport.protocolsmtp
    mail.smtp.authtrue
    mail.smtp.starttls.enabletrue
    mail.smtp.starttls.requiredtrue
    mail.smtp.hostHost name of your mail server
    mail.smtp.portPort 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.invitetrue
  4. 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.