Skip to main content
OCLC Support

Post to Web

Learn how to configure document delivery using Post to Web in Relais ILL.

Overview

  • Requests with a delivery method of post-to-web, are processed through Delivery Email.
  • For requests in this queue, Delivery Email sends an email to the requester with one or more links to the requested document.  
  • Multiple options are available when setting up Post to Web delivery including:
    • How many days the document is available to the requester.
    • How many times the document can be viewed by the requester.
    • Whether the cover page is included, if yes whether to include it as an attachment to the email (recommended) or merge it with the document.
  • Introduced in Relais 2014., is the option to require the patron to Login prior to accessing a Post to Web document and to accept a Terms of Use statement. Note, when configured this option is not used when delivering documents via Post to Web to other libraries.  

Configure delivery email - Post to Web

For customers using the Relais Hosted Service contact OCLC Support and provide the following information:

  • Specify the number of days the document is accessible to the requester. Once this number of days has passed Purge FTP deletes the document from the server automatically and the requester no longer has access. The number of days can be included in the email message sent to the requester.  
  • Specify the number of times the requester can access the document. The number of views allowed can be included in the email message sent to the requester. 
  • Specify whether to include a coverpage, if yes specify whether to merge the coverpage with the document.
     Caution: It is recommended that the coverpage NOT be merged with the document. When the option to merge is turned on errors and problems are frequently encountered when attempting to deliver electronic documents that incorporate security. In these cases it is often not possible to merge the coverpage with the document. By default the Merge Coverpage option is set to No.
  • Use Batch Processing (yes or no) - default is Yes
    • Set to Yes, Delivery Email sorts all Post to Web requests in the queue by email address and then sends only one e-mail with multiple links. 
    • Set to No, sends each document link in a separate e-mail message.
  • Specify the following for situations when the requester cannot access the Post to Web document, e.g., if the number of days has passed.  
    • A redirect url and the text to display 
    • An email address and the text to display (optional)

Configure the email template used to generate the Post to Web message

  1. Login to Library Registration.
  2. Retrieve your home library record.
  3. Click Message Format.
    Library Registration window
  4. Click Set System Default.
    Delivery Email Template (Electronic Delivery) window

     Note: It is possible to specify email template for a specific patron or library. If no specific template has been configured, then the System Default template is used.

  5. Enter the following and click Ok.
    Field Characters Description
    Skip Head and Footer Files   Select Yes or No. If Yes then text files found in the Relais root directory are used to as the header and footer for the email template. If No then these text files are ignored.
    Subject 100 Enter the Subject for the email. For example:

                    Electronic delivery for Request Number(s): &RequestNumber;

    The token &RequestNumber can be used. When the email is generated the token is replaced with the Relais Request Number. If Batch Processing is set to Yes and multiple documents/links are included in the email then the token is replaced with all relevant Relais Request Numbers.
    Request Info 500 Enter the text and tokens to be used in generating the request specific section of the email template. For example:

                    This message contains a link to the document you requested: &Title;, &ArticleAuthor;. &ArticleTitle;.
                    The document contains &DocumentPages; page(s), is &DocumentSize;, was posted on &DatePosted;
                    at &TimePosted12; and is available for download for &DaysAvailable; days and can be accessed one
                    (1) time.

                    &DocumentLink;

                    The coverpage for this document is attached to this email.

    This section is incorporated into the body of the message.
    Body 3000 Enter the text and tokens to used in generating the body of the message. Typically the Request Info as described above in included as a token in the Body. For example:

                    Hello

                    &RequestInfo;

                    If the link to open the document does not work from your mail program, please copy this URL into your
                    Web browser:


                    Contacts:
                    If you have any difficulties please either contact the ILL Office at yourlibrary_ill@emailprovider.com

 Note: HTML encoding can be used in the email template.

Require Login to access the document and to accept Terms of Use Configure Login and a Terms of Use statement

When this option is configured,

  • When the patron receives the Post to Web email
    Post to Web email
  • Then the patron clicks the link in the message:
  • The Login page appears
    Login page
  • The patron logs in and My Requests displays the request details for the Request number specified in the link
    My Requests screen
  • The patron clicks download under the Article Link and the Terms of Use statement displays in a pop-up box with the choices – I agree or Cancel
    Terms of Use pop-up box
  • The patron clicks I agree and the document displays in a new tab

Configure Login and Terms of Use statement

 Note: For customers using the Relais Hosted Service contact OCLC Support and provide the following information:

  • Require patrons to Login = Yes
  • The text for the Terms of Use statement.

If not using the Relais Hosted Service

Step 1

  • Login to Administer Settings.
  • Select the Application Settings tab.
  • Open the Delivery section, select Delivery Email.
  • Click on Edit Extended Settings.
  • In the Post to Web section enter the Download Login address. For example:  

    https://your_library_symbol.relais-host.com/user/login.html?LS=&LibrarySymbol;&group=&PortalGroup;&reqno=&RequestNumber;

    When Delivery Email creates the email to send to the patron, this link is used. The RequestNumber token is replaced with the actual request number.

Step 2

In the relaisweb.ini

  • Add  a new setting to the [Request Status Table Settings] section, TermsOfUseEnabled and set to Y(es)

Step 3

In the translation file for the Relais web forms, modify the text for the Terms of Use Statement. 

Require Login to access the document but do not display Terms of Use

When this is configured, once the requester receives the Post to Web email and clicks on the link in the email message.  

  • The Relais Login page appears
  • The patron logs in using the login and password
  • My Requests displays the request details for the Request Number specified in the link
  • The requester clicks on download under Article Link
  • The document displays

Configure Login only

 Note: For customers using the Relais Hosted Service contact OCLC Support and provide the following information:

  • Require patrons to Login = Yes

If not using the Relais Hosted Service

Step 1

  • Login to Administer Settings.
  • Select the Application Settings tab.
  • Open the Delivery section, select Delivery Email.
  • Click on Edit Extended Settings.
  • In the Post to Web section enter the Download Login address. For example:  

    https://your_library_symbol.relais-host.com/user/login.html?LS=&LibrarySymbol;&group=&PortalGroup;&reqno=&RequestNumber;

    When Delivery Email creates the email to send to the patron, this link is used. The RequestNumber token is replaced with the actual request number.