Manage Reference Documents

About Reference Documents

Reference documents allow you to associate files or websites with a record in the Predix Essentials database. For example, while performing an inspection, you might take pictures of the piece of equipment that you are inspecting and save them on your local machine or company network. Then, while recording the inspection details in a General Inspection record in Predix Essentials, you can link those images, as reference documents, to the General Inspection record, so that when other users open the General Inspection record, they will be able to view the images.

Each time you associate a reference document file with a record, a Reference Document record will be created and linked to that record. You can link Reference Document records to any record belonging to a family for which the Has Reference Documents relationship has been defined via the Configuration Manager. The Predix Essentials system supports two different types of reference documents:

  • Internal Reference Documents: Reference document files that are stored in the Predix Essentials database.
  • External Reference Documents: Reference document files and websites that reside outside of the Predix Essentials database and are referenced in a Reference Document record. Internal reference documents can be accessed only by users who have permission to access the location in which they are stored. Other users would be able to view an external reference document that is stored in a public location, such as a network drive.

Reference document access is available via the Record Manager, but you can also access reference documents by performing a search.

Access Reference Documents

Procedure

  1. Access Record Manager, selecting the record whose reference documents you want to view.
  2. Select , and then select Reference Documents.

    In the drop-down menu, the number listed before the Reference Documents menu indicates the number of existing reference documents for that record. On selecting this menu, the list of available reference documents appears for that record.

Reference Documents Workflow

Note: Before manipulating Reference Documents, you must configure the Has Reference Documents relationship. Many of the baseline families in Predix Essentials already possess the Has Reference Documents relationship, but it will need to be added for any new or custom families.

This workflow provides the basic, high-level steps for using Reference Documents. The steps and links in this workflow do not necessarily reference every possible procedure.

  1. Add a Reference Document.
  2. Modify a Reference Document.
  3. Unlink a Reference Document from a Record.
  4. Access a File Associated with a Reference Document.
  5. Save a Copy of a Reference Document to a Different Location.

Add a Reference Document

About This Task

You can add a new reference document or link an existing reference document to a record. Complete one of the following sequences of steps.

Procedure

  • Create a Reference Document
    1. Access Record Manager.
    2. Select , and then select Reference Documents.
    3. Select .

      The Add Reference Document window appears.

    4. In the ID box, enter a name for the reference document.
    5. In the Description box, enter a brief description.
    6. In the Document Path box, select .

      The Edit Document Path window appears.

    7. If you want to store the reference document in the Predix Essentials database:
      1. Select Upload a Local File, then select , and then select a file to upload.
      2. Select Save.

      The document path is added to the datasheet.

      The following file formats are supported:

      • Microsoft PowerPoint (.ppt, pptx, .pptm, .pps, .ppsx, or .ppsm)
      • Microsoft Word (.doc, .docx, or .docm)
      • Text files (.txt, .rtf, or .odt)
      • Adobe Portable Document Format (.pdf)
      • Images (.jpg, .jpeg, .jpe, .gif, .png, .tif, .vsd, .vss, .vst .vdx, .vsx, or .bmp)
      • Email Messages (.msg)
      The following file protocols are supported:
      • HTTP (Hypertext Transfer Protocol)
      • HTTPS (HTTP over SSL)
    8. Select .
      The reference document is saved.
    Note: The link to the document appears in the Document Path box.
  • Link a Record to a Reference Document
    1. Access Record Manager.
    2. Select , and then select Reference Documents.
    3. Select .

      The Search window appears.

    4. If you want to search reference documents of all families, select .

      -or-

      If you know the name of the reference document that you want to link, enter the name in the search box, and then press Enter.

    5. Select the check box next to the reference document that you want to link, and then select OK.

      The reference document is linked to the record.

Modify a Reference Document

Procedure

  1. Access Reference Documents for the record that you want to modify.
  2. Select the row for the reference document you want to modify, and then select .

    The datasheet for the selected reference document appears.

  3. Modify the datasheet fields as desired.
  4. Select .

    The changes you made to the reference document record are saved.

Access the File Associated with a Reference Document

Procedure

  1. Access Reference Documents.
  2. In the Document Path box, select the link.
    If the file type is supported by a web browser, the file opens in a web browser . Otherwise, the file is downloaded on your machine.
    Note: Depending on the operating system of your mobile device, Accessing Reference Documents using the GE Digital APM mobile application will vary. For example, on a Window or an Android device, when you attempt to access a Reference Document for the first time, a dialog box appears, asking you to select the application in which you want to open the file. This selection will be saved as the default setting. Whereas, on an iOS device, each time you attempt to access a Reference document, the dialog box appears. When you attempt to download a file and the operating system of your mobile device does not recognize the file type, a message appears.

Save a Copy of a Reference Document to a Different Location

Procedure

  1. Access Reference Documents.
  2. Select the reference document that you want to open.

    The file is downloaded and ready to be accessed.

  3. Open the file, and then save it to your desired location.

Delete a Reference Document

Procedure

  1. Access Reference Documents for the record that you want to delete.
  2. Select , and then select Delete.

    The Alert dialog box appears, asking you to confirm the deletion.

  3. Select Yes.

    The record is deleted from the Predix Essentials database.

    Note: Only Super Users are granted the privileges of deleting the global records.