Use

You can use this function to directly integrate production-relevant documents that are stored in the SAP Document Management Service (DMS) in a PI sheet or manufacturing cockpit. The system can automatically determine and display the valid, released document version. If the documents can be read directly in an embedded frame in the PI sheet, they are archived in the batch record together with the PI sheet.

Prerequisites

You have stored your documents in DMS. To create a document in DMS from the SAP Easy Access screen, choose Logistics → Central Functions → Document Management → Document → Create .

To display a document in the PI sheet, the following requirements must be met:

Activities

Integrating DMS Documents in PI Sheets

To integrate a document from DMS in the PI sheet, proceed as follows:

If you want to display the document within the PI sheet and archive it together with the PI sheet, use an embedded frame. You can, however, also use a hyperlink to call up the document in a separate window.

Structure of the Document URL

The URL that you use to address a document in the PI sheet must adhere to the following convention:

SAPR3-DMS- < Document number > - < Document type >-< Document part > - < Document version > - < Workstation application of the original >

Example

You want to integrate a document with the following data in the PI sheet:

To integrate the document in an embedded frame, you define the following long text, for example, in your process instruction:

<iframe width=500 src="SAPR3-DMS-DOC1-PI-001-03-WWW" name="DOC1 scrolling=yes> The document cannot be displayed. </iframe>

To call up the document as a hyperlink, you define the following long text, for example, in your process instruction:

Note the <a href="SAPR3-DMS-DOC1-PI-001-03-WWW" scrolling=yes>master formula</a>.

Laying down the Document Version when Creating a Control Recipe

If you do not specify the document version in the URL, the system determines the valid version when calling up the PI sheet. This means that different documents may be displayed at different times in the PI sheet.

However, you can lay down the valid document version when you create a control recipe. To do so, proceed as follows:

Example

You have defined the following characteristics in the master recipe or process order:

Using text symbols, you refer to the characteristics assigned before in the long text of characteristic PPPI_INSTRUCTION:

... </iframe> <iframe width=500 height=300 src="SAPR3-DMS-&0010&-&0020&-&0030&-&0040&-&0050&" name="DMS document"> </iframe> ...

Dealing with Special Characters

If the document number, document type, document part, and so on contain one of the following special characters, this character must be replaced by the appropriate escape sequence in the URL:

Displaying Original Application Files with Additional Data

You can display additional files referenced in an original file in the PI sheet if the following requirements are met:

If you want to load an original application file to the PI sheet together with its additional files, add the extension " /* " (slash and asterisk) to the document URL. The complete URL is as follows:

SAPR3-DMS- < Document number > - < Document type >-< Document part > - < Document version > - < Workstation application of the original > /*

References Between Original Application Files

You can use an URL that is structured according to the convention " SAPR3-... " to refer to other documents within an original application file. The reference is replaced in the PI sheet. If you load the original application file together with its additional files, you must, however, add the prefix " ../ " (two periods and slash) and insert a blank character immediately after the URL.

Example

<p>Note the<a href="../SAPR3-DMS-DOC5-PI-001-02-www ">guidelines</a>.</p>

Demand-Driven Loading of Documents

Documents that are called up via a hyperlink in the PI sheet need not be loaded immediately when the PI sheet is started. To make sure that these documents are only loaded when the hyperlink is executed, note the following when defining the hyperlink:

You can only use this option, however, if the document URL does not contain any escape sequences.