Configure document management

Important

This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.

Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2

This topic explains how to configure document management for the first time. You can use document management, also known as document handling, to attach notes, documents, or document references to records. You can also use Office Add-ins for Microsoft Dynamics AX to integrate with document management and create Microsoft Word and Microsoft Excel documents or document templates that use Microsoft Dynamics AX data.

The following illustration shows how to configure document management. The numbers correspond to the procedures later in this topic.

The configure document management process

1. Activate document management

Before you can attach documents to records or generate documents from a record, you must activate the document management functionality and then you must activate document management for specific tables.

To activate document management, follow these steps:

  1. Click File > Tools > Options.

  2. In the General area, expand the Miscellaneous FastTab.

  3. In the Document handling field group, select the Document handling active check box.

To activate document management for specific tables, follow these steps:

  1. Click Organization administration > Setup > Document management > Active document tables.

  2. Click New.

  3. Select the name of the table to activate document management for.

    Example

    To activate document management for sales orders, select the SalesTable table name.

  4. Repeat steps 2 and 3 for each table that you want to activate document management for.

2. Specify a document archive directory

When you attach a document to a record in Microsoft Dynamics AX, it is stored in a location that you specify. This location is called an archive directory. You can specify one archive directory for all the document types you set up, or you can specify a separate archive directory for each document type. If you don’t specify an archive directory for a document type, the document type uses the archive directory that you specify in this procedure. See “Create or import document types” later in this topic for more information about how to specify an archive directory for a document type.

Note

If you use Enterprise Portal for Microsoft Dynamics AX, there are additional requirements and restrictions about document archives. For more information, see Set up documents for viewing in Enterprise Portal.

To specify a location for the Microsoft Dynamics AX document archive directory, follow these steps:

  1. Click Organization administration > Setup > Document management > Document management parameters.

  2. In the General area, browse to the location of the archive directory.

    Warning

    If you already have an archive directory specified and you want to change it, you first must move the contents of the existing archive directory to the new archive directory. For more information, see Document management.

  3. Optional: Specify the maximum file size that is allowed for documents.

    Field

    Description

    Max. file size in database

    Enter the maximum file size, in megabytes, for a file that is saved to the Microsoft Dynamics AX database.

    Max. file size in file system

    Enter the maximum file size, in megabytes, for a file that is saved to the archive directory location.

3. Specify number sequences for documents

Before you can use document management, you must specify number sequences for documents. The files that you attach to records are renamed when they are stored in the archive directory. The file name of the attached files is determined by the number sequences that you set up for documents.

To specify number sequences for documents, follow these steps:

  1. Click Organization administration > Setup > Document management > Document management parameters.

  2. In the Number sequences area, select a number sequence code for each reference.

    If the number sequence code that you’re looking for is not listed, you must create a new number sequence code in the Number sequences list page. For more information, see Set up number sequences.

4. Specify file types

You can control which types of files, or documents that have specific file name extensions, that users can attach to Microsoft Dynamics AX records.

To specify file types, follow these steps:

  1. Click Organization administration > Setup > Document management > Document management parameters.

  2. In the File types area, review the default file types. Remove the file types that users should not be able to attach to records, and add any additional file types that users should be able to attach to records.

5. Optional: Configure integration with Office Add-ins

When you use document management, you can integrate with Office Add-ins to create Word documents and Excel workbooks that are linked dynamically to the tables in Microsoft Dynamics AX. For specific instructions about how to do this, see Install Office Add-ins and Set up integration with Microsoft Office Add-ins.

6. Create or import document types

Document types are required for document management and are used to categorize the documents that you attach to records. When you create an unattached document, one of these content types is assigned to it. If you have workflows set up, workflow uses the document type to route the document to the appropriate user or work-item queue.

The Note and File document types are available by default.

Create document types

To create a document type, follow these steps:

  1. Click Organization administration > Setup > Document management > Document types.

  2. Click New, and then enter the following information about the document type.

    Field

    Description

    Class

    Select the action that occurs when a user creates an attachment of the selected document type:

    • Attach URL – Attach a reference to a document by using a URL.

    • Create a Microsoft Excel worksheet by using COM – Create an Excel worksheet and copy data from the selected transaction.

    • Create a Microsoft Word document by using COM – Create a Word document and copy data from the selected transaction.

    • Create application document – Create a Word document without opening Word.

    • Simple note – Create a simple note for the referenced transaction.

    • Template library – Create a template file by using Word or Excel, and then save the file to a template library. For example, you can create a budget template by using Excel. Each department in your organization then enters budget information in a copy of the template.

      Note

      Your system administrator must create the site or SharePoint document library for the template library.

    Group

    Select the group for the document type.

    Auto-save

    Select this check box to automatically save temporary files to the database after you use them.

    Typically, temporary files are stored in the Temp folder in Microsoft Windows. To save temporary files in the directory that is specified in the File location list, select Auto-save.

    Autodelete

    Select this check box to automatically delete temporary files after you use them.

    Typically, temporary files are stored in the Temp folder in Windows.

    Remove

    Select Document only to remove only the reference to the document file or select Document and physical file to remove both the reference and the physical file.

    Ask for confirmation

    Select this check box to require confirmation before the physical file is deleted.

    Category

    Select an Enterprise Portal document category to associate with the document type.

    Details for document categories are set up in the Enterprise Portal parameters form. For more information, see Attach documents, notes, or URLs to records.

    Archive directory

    The directory where document files of the selected document type are stored.

    If this field is empty, the default archive directory that is specified in the Document management parameters form is used as the archive directory.

    Note

    If you use Enterprise Portal, there are additional requirements and restrictions about document archives. For more information, see Set up documents for viewing in Enterprise Portal.

    Location

    Select the location where document files for this content type are stored. The following options are available:

    • Archive directory – Documents of this type are stored in the directory that is specified in the Archive directory field.

    • Database – Documents of this type are stored in the Microsoft Dynamics AX database.

    • Original location – Documents of this type are stored in the location that was used when the file was originally attached to the record.

    • SharePoint – Documents of this type are stored in a SharePoint document library.

    Note

    If documents are stored in a shared location instead of the database, verify that the correct access level is set for the shared location.

    Check table

    If this check box is selected, the selected document type is available only from the tables that are specified in the Options form.

    By default, the check box is cleared for the standard document types, Note and File.

    For more information, see Restrict a document type to a specific table.

Import document types

To import document types, follow these steps:

  1. Click Organization administration > Setup > Document management > Document types.

  2. Click Import.

  3. Browse to the location of the file that contains the exported document types.

  4. When prompted to delete tables before you import, click Yes to all, and then click OK.

  5. Click Yes to confirm.

6a. Optional: Configure document management for SharePoint

You can use SharePoint document libraries to store document attachments or document templates. For more information, see Configure and use Microsoft Dynamics AX document management with Microsoft SharePoint document libraries.

6b. If you use Enterprise Portal: Configure document categories

In Enterprise Portal, you can select the modules or product areas that display specific document categories and the kinds of external users who can open the documents.

To configure document categories in Enterprise Portal, see Set up documents for viewing in Enterprise Portal.

7. Specify content types

Content types are used to categorize documents that are not attached to records. Examples of unattached documents might be invoices, expense reports, or purchase orders. Workflow uses document content types to route documents to the correct user or work-item queue for processing. For more information, see Configuring the workflow system.

To create content types, follow these steps:

  1. Click Organization administration > Setup > Document management > Document content types.

  2. Click New, and then enter a name and a description for the content type.

For more information, see Document content types (form).

8. Optional: Specify document management settings for AIF

Before you can use Application Integration Framework (AIF) document services, you must specify document management settings for AIF. AIF document services are query-based services that you can use to exchange data with external systems by sending and receiving XML documents. These documents represent business entities, such as customers, vendors, or sales orders.

To specify document management settings for AIF, follow these steps:

  1. Click Organization administration > Setup > Document management > Document management parameters.

  2. Click AIF.

  3. Complete the following fields.

Field

Description

Document type:

Select the document type for notes in incoming electronic documents. For sales orders, this type must be Note.

Document file service

Select this check box if the web service document files should be submitted to workflow for routing to appropriate parties.

For more information, see AIF Document Services.

Next step

After you have configured document management, you can attach documents to records or create document templates for specific document types. For more information, see Create a note, Create a document template and associate it with a document type, or Create a reference to an existing document.

Optionally, if you set up the integration with Office Add-ins, you can create Word documents and Excel workbooks that are linked dynamically to the tables in Microsoft Dynamics AX. For more information, see Key tasks: Create and use a Word template by using the Office Add-ins or Key tasks: Create and share an Excel template by using the Office Add-ins.

Copy a note or document reference

See also

Document management in sales and marketing