Using Dynamic Print Templates

Dynamic print templates allow you to specify an ActivID CMS attribute whose value indicates the print template to use for printing.

Use the format dynamic_<attribute> to enter a template value into the ActivID CMS server and assign it to a print job. The <attribute> can be any valid ActivID CMS attribute, including attributes from plugins such as PIV Personal Identity Verification (technical standard of "HSPD-12") or CIV Commercial Identity Verification. Any colons in the attribute names must be replaced with underscores.

Dynamic templates can be configured to download from the ActivID CMS server during the print operation, which means that these templates are not required to be present locally on the workstation(s) used for printing.

Configuring Dynamic Print Templates

  1. On the Configuration tab, select the Customization sub-tab.

  2. From the Select a Topic drop-down list, select Miscellaneous.

  3. Under Card Printing, in the Supported Printer Type drop-down list, select Fargo – Asure ID.

  4. In the AsureID template names field, set the dynamic print template(s) to be used (for example, to use the PIV Print Layout, enter dynamic_piv_PrintLayout).

    5. Important: Each dynamic template name must begin with dynamic_ followed by the attribute specifying the print template. If the attribute name contains any colons (:), they must be replaced with underscores (_).

  5. In the AsureID Print Service URL field, set the URL to https://127.0.0.1.

    6. Note: AsureID Service 5.6 is required when using a Chrome browser for printing. In this case, the AsureID Service URL should be set to https://127.0.0.1 instead of https://localhost.

  6. For the Use Server-Hosted Templates option, select Yes. This feature allows you to load the Asure ID Template file on the ActivID CMS server and have it downloaded to the print service automatically.

  7. Click Set. A confirmation message appears.

  1. On the Configuration tab, select the Customization sub-tab.

  2. From the Select a Topic drop-down list, select User Attributes.

  3. In the Attributes Printable During Issuance section, add the print template attribute to the list of attributes available:

    Example:

    Display Name:

    Print Template Name

    LDAP Attribute:

    piv:PrintLayout

    Type:

    Text

  4. Add any other attributes required in your template(s).

    5. Note: All attributes passed from ActivID CMS to the Asure ID local print service will have the colons (:) in their names replaced with underscores (_). For example, the ActivID CMS attribute entered as piv:PrintTemplate is passed as piv_PrintTemplate, and likewise civ:PrintablePhoto is passed as civ_PrintablePhoto.

  5. Click Set. A confirmation message appears.

  1. On the Configuration tab, select the Policies sub-tab.

  2. Select the Card Layout to which you want to add the template and then click Update.

  3. In the Card Printing Layouts section, select the conditions when it will print using the new dynamic print template.

  4. Click Update to save the changes.

  1. On the ActivID CMS server, go to the ActivID CMS installation folder (the default is: C:\Program Files\HID Global\Credential Management System).

  2. Go to aims.war\data\printing\layouts

    Important: The cms_portal directory, used in previous versions of ActivID CMS, no longer exists. With the migration to WildFly in ActivID CMS 6.0, that directory is now called aims.war.

  3. Create a new folder named: asureid.

  4. Copy all the templates that you plan to use into this new folder (C:\Program Files\HID Global\Credential Management System\aims.war\data\printing\layouts\asureid).

    5. Note: File names are case sensitive when being downloaded from the print services. The file will not download if its name does not exactly match the value of the attribute used.

Client Installation

  1. Uninstall any existing ActivID CMS Asure ID print service from the workstation using the following script:

    Copy 
    CMS_AsureID_Service_Uninstall.vbs
    2. Note: This script does not remove the generated root CA The Certificate Authority (CA) issues and manages security credentials and public keys for message encryption in a networks environment. or the SSL certificate from the Local Computer store. You can use the Certificate plugin for MMC to remove the “HID Global Generated CMS Print Service CA” and “localhost” certificate from the Local Computer store.

  2. Install the new ActivID CMS Asure ID print service on any workstation where printing is required.

Debug Logging for ActivID CMS Asure ID Print Service

To enable debug logging:

  1. Edit the AsureIDService.exe.config file located in the Asure ID folder.

  2. In the <level value="ERROR" /> line, replace ERROR with DEBUG.

  3. Save the file.

  4. Restart the ActivID CMS service.

To disable debug logging:

  1. Edit the AsureIDService.exe.config file located in the Asure ID folder.

  1. In the <level value="DEBUG" /> line, replace DEBUG with ERROR.

  2. Save the file.

  3. Restart the ActivID CMS service.

The error/debug log file (AsureIDService.Log) is located in: %PROGRAMDATA%\HID Global\CMS Print Service.