Connector Framework Server 12.11

# Add Titles to Documents

IDOL documents have a field named `DRETITLE` that can contain a title for the document. Front end applications might use the value of this field to present a title to users when displaying query results.

You should not rely on a connector to add a document title, because the connector might not be able to obtain this information. A suitable title for an e-mail message could be the subject of the e-mail, but this is not extracted until the e-mail is processed by CFS.

You can therefore use a Lua script to add a title to documents that do not have one, and, if necessary, ensure that all documents have suitable titles.

CFS includes a Lua script that adds titles to documents. The script is named `ExtractDreTitles.lua`, and is located in the `scripts` folder, in the CFS installation directory. You can use this script or modify it to suit your requirements.

The unmodified script ensures that all documents have a title. If a title has already been added to the document, that title is respected. If the document does not have a title, the script attempts to extract one from metadata fields that are added by KeyView and often contain titles. If none of these fields are present, the script adds a title by extracting the original file name from the field `DREORIGINALNAME`.

To add titles to documents using the `ExtractDreTitles` Lua script

1. Open the CFS configuration file.
2. Find the `[ImportTasks]` section of the configuration file, or create this section if it does not exist.

3. In the `[ImportTasks]` section, configure a `Post` import task to run the Lua script `scripts/ExtractDreTitles.Lua`.

   For example:

       [ImportTasks]
       Post0=Lua:scripts/ExtractDreTitles.lua

   TIP: You must use a `Post` task so that the script runs after KeyView filtering.

4. Save and close the configuration file.

© Copyright 2022 Micro Focus or one of its affiliates
Version 12.11 | Last updated February 2022

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL Connector Framework Server 12.11

Topic Title: Add Titles to Documents