Chapter 5. Integration Testing

Table of Contents

5.1. Receiving Faxes
5.2. Printing from DFdiscover
5.3. Faxing from DFdiscover

The integration tests described in this chapter are recommended but not required. Their purpose is to demonstrate that incoming and outgoing faxing is operational, and that printing is correctly defined.

5.1. Receiving Faxes

The purpose of this test is to demonstrate that an incoming fax can be received by DFdiscover, that it is properly archived, and that it can be viewed in DFexplore.

To demonstrate incoming fax operation

  1. Fax a non-DFdiscover page from a plain paper machine

    The purpose of this test is not to demonstrate that a CRF can be recognized as a study CRF, and so a simple cover page of any type is preferred. Fax the page from a traditional fax machine to the number that DFdiscover will receive faxes on [IN01].

  2. Monitor the fax modem status lights (HylaFAX only)

    During fax reception, various lights on the modem will flash or be illuminated. On Multitech modems the OH (off-hook) light will be on during the fax reception and the RD (receive data) light will be flashing indicating that information is being received from the sending fax machine. When transmission is complete some of these lights will go out.

  3. Confirm fax archival

    Within 30 seconds (5 minutes for Protus fax service users) of the end of transmission, DFdiscover will create a new directory under the directory previously defined as the Archive Directory by Configure Incoming and Outgoing Processes. The directory name is 4-digits where the first two digits are the year within the century and the last two digits are the week within the year. The contents of the directory will be a single file with a 4-digit name, generally 0001. Confirm that the directory and file are present [IN02].

    Example 5.1. Confirmation of fax archival

    In this case, the first fax was received on November 14, 2015 (the 46th week of 15). The archive directory was defined as /opt/dfdiscover/archive.

    % cd /opt/dfdiscover/archive
    % ls
    1546
    % cd 1546
    % ls
    0001


  4. View the fax in DFexplore

    Fax pages that are not barcoded as DFdiscover CRFs will be routed to a holding directory for subsequent manual identification.

    Start DFexplore with the command:

    % /opt/dfdiscover/bin/DFexplore
    

    Authentication is required. Then click Image Router and confirm that the faxed page or pages are present [IN03].

  5. Print the page from DFexplore

    Choose Print from the Page menu. In the Print dialog, select the Printer to which you want to print the page and choose Print to print the current page.

    Confirm that the fax page prints successfully [IN04].

Completion of this section demonstrates that DFdiscover is able to receive faxes and process them.

5.2. Printing from DFdiscover

The purpose of this test is to demonstrate that the previous editing done in Define DFdiscover capable printer was successful.

Print a plain text file

  1. Identify a plain text file

    Any text file will work for this test. The file should not be too large - the purpose of the test is to print a text file, not print hundreds of pages of text. A good default file is /etc/passwd.

  2. Print the file

    From a shell prompt, issue the command:

    % /opt/dfdiscover/lib/DFprint_filter /etc/passwd
    

    possibly substituting /etc/passwd with the name of the file that you chose to print.

  3. Confirm that the text file printed properly [IN05].

5.3. Faxing from DFdiscover

The purpose of this test is to demonstrate proper operation of the previously defined outgoing daemon.

This test will require the fax number of a local paper fax machine to be used as the fax destination.

Fax a plain text file

  1. Identify a plain text file

    Any text file will work for this test. The file should not be too large - the purpose of the test is to fax a text file, not fax hundreds of pages of text. A good default file is /etc/passwd.

  2. Fax the file

    From a shell prompt, issue the command:

    % DFsendfax /etc/passwd faxnumber

    where faxnumber is the fax number of the local paper fax machine.

    Depending upon the Polling Interval previously specified in the outgoing daemon configuration, it may take up to 60 seconds for DFdiscover to pass the queued fax to HylaFAX or the Protus fax service.

  3. Confirm that the fax was sent successfully

    Wait for a few minutes and confirm that the sent fax has arrived at the destination [IN06].