Avery Labels ASP Plug-In
Installation Guide

Introduction

This i-fax.com Plug-In gives you the ability to create sheets of barcoded laser address labels that can be used to tag documents and link them automatically to data in your database when they are faxed or scanned. With i-fax.com, your customers will not require any special software or Plug-Ins.

The i-fax.com plug-in is available at Download Plug-In.

This installation manual was designed to provide software developers with an easy guide to installing the i-fax.com Plug-In on document creation systems.

If you have any questions that are not addressed by this manual or if you have suggestions on how i-fax.com Inc. could serve you better, we welcome your input at service@i-fax.com.

copyright © 2013 i-fax.com Inc. All rights reserved.

Table of Contents

• Table of Contents
• i-fax.com Architecture
• ASP Avery Labels Version of the i-fax.com Plug-In
• Installing the ASP Avery Labels Version of the i-fax.com Plug-In onto your Website
• Description of the ASP Avery Labels Version of the i-fax.com Plug-In
• The i-fax.com Barcode Generator
• Using the com.Ifax.Barcode.LabelsXXX class
• Using the Avery Labels Classes in ASP
• Placing the Avery Labels Barcode
• Your Website
• File Types
• File Formats
• File Transfer Options

i-fax.com Architecture

The i-fax.com Plug-In is split into two parts:

1. The Barcode Generator
   The Barcode Generator takes identifiers to be encoded in barcodes (31 character strings made up out of upper and lowercase letters, numbers, hyphens and spaces) and generates sheets of laser address labels with barcodes on them, which can then be peeled off and stuck to existing paper documents.

   i-fax.com also provides plug-ins in various languages for many document types as well as utilities for merging barcodes with existing PDF documents. Please visit http://www.i-fax.com/plugin.html for a full list of our plug-ins.

2. Your Website
   When an end user sends a barcoded document to the i-fax.com server (by fax or scanner), the barcode is interpreted by i-fax.com 's server. The i-fax.com server renames the document with the encoded identifier found in the barcode and sends the document to you by FTP file transfer or as an email.

ASP Avery Labels Version of the i-fax.com Plug-In

Installing the ASP Avery Labels Version of the i-fax.com Plug-In onto your Website

Place the assembly files com.Ifax.Barcode.Labels10.dll, com.Ifax.Barcode.Labels14.dll, com.Ifax.Barcode.Labels14a.dll, com.Ifax.Barcode.Labels20.dll in the with the rest of the assemblies, usually c:\winnt\microsoft.net\assemblies.

The i-fax.com Avery Label Plug-In may work in conjunction with your web application but it is not a web application. We recommend that you keep the i-fax.com classes in a directory outside your web directory tree if possible. Make sure that the .dll file has the correct ownership and permissions to be accessible by your application.

1. Register the .dll files with the following command:

   regasm /tlb c:\winnt\microsoft.net\assemblies\com.Ifax.Barcode.Labels10.dll

   regasm /tlb c:\winnt\microsoft.net\assemblies\com.Ifax.Barcode.Labels14.dll

   regasm /tlb c:\winnt\microsoft.net\assemblies\com.Ifax.Barcode.Labels14a.dll

   regasm /tlb c:\winnt\microsoft.net\assemblies\com.Ifax.Barcode.Labels20.dll

2. Add the .dll file to the global cache with the following command:

   gacutil /i c:\winnt\microsoft.net\assemblies\com.Ifax.Barcode.Labels10.dll

   gacutil /i c:\winnt\microsoft.net\assemblies\com.Ifax.Barcode.Labels14.dll

   gacutil /i c:\winnt\microsoft.net\assemblies\com.Ifax.Barcode.Labels14a.dll

   gacutil /i c:\winnt\microsoft.net\assemblies\com.Ifax.Barcode.Labels20.dll

Description of the ASP Avery Labels Version of the i-fax.com Plug-In

The i-fax.com ASP Avery Labels Plug-In is divided into four separate classes, each creating labels of a different format:

The i-fax.com Barcode Generator (ASP Avery Labels Version)

The i-fax.com barcode is available for many platforms and formats. In the Avery Labels version, your encoded unique identifiers are converted into a PDF document for printing to sheets of laser address labels, each label bearing an i-fax.com barcode. The Avery Labels version of the Barcode is intended for creating barcoded labels that can be stuck on existing paper documents.

For information on using i-fax.com barcodes with other document formats (Word, PDF, HTML, GIF, SVG and BMP), please visit http://www.i-fax.com/plugin.html.

Using the com.Ifax.Barcode.LabelsXXX Classes

There are two steps to creating sheets of barcoded laser address labels using the com.Ifax.Barcode.LabelsXXX classes. First you add all the barcodes you want to create using the addBarcode() method, then you generate the PDF containing all the sheets of generated barcodes by using the getPDF() method.

For each barcode you want to create, you call addBarcode() and pass the following parameters:

1. String format is a character, either "A", "N" or "H" which chooses how the transaction id is to be formatted when it is placed above the barcode on the output PDF. Use "N" if you want the transaction ID to be formatted like a number, with spaces added after every three numbers starting at the right. Use "H" if you want the transaction ID to be formatted like hexadecimal, with a space after every two characters, starting at the left. Use "A" if you want no formatting at all. Note that the formatting doesn't affect how the transaction id is interpreted, only how it is displayed above the barcode.

2. String id is the identifier to be encoded in barcode, a 31 character string made up out of upper and lowercase letters, numbers, hyphens and spaces.

3. String text1 to text6 are optional lines of text that appear under each barcode. The number of text lines is dependent on the size of the labels, the largest label (4" x 2", Labels10) supports six lines of text under the label, the smallest (4" x 1", Labels20) only supports one. See the table above to see how many lines of text are available for each label class.

void addBarcode(String type, String id, String text1[, String text2][, String text3][, String text4][, String text5][, String text6])

Once all the labels that you want to create have been added, you create the PDF document with the getPDF() method which takes no parameters and returns a String containing an entire PDF file.

Using the Avery Labels Classes in ASP

The files ifaxlabelsXXXexample.asp are fully functional demonstration of how to generate i-fax.com laser address labels in an ASP environment. There are three steps required; first, the classes must be instantiated with calls to CreateObject()
Set ifaxbarcoder = Server.CreateObject("com.Ifax.Barcode.LabelsXXX")

Next, barcodes must be added to the label document (repeat this until you've added all the labels you want)
ifaxbarcoder.addBarcode transid, "A", textline

Finally, the barcoded document must be generated. You can stream it directly to the browser with
response.write(ifaxbarcoder.getPDF())

Placing the Avery Labels Barcode

The laser address labels produced should be stuck on your documents carefully.

Placement of the label must follow these rules:

1. The label must be at the top of the page, with a margin of empty space on three sides (approximately ¾ above, right and left).

2. The label should appear above all logos and graphics on the page.

Your Website

When an end user sends a barcoded document to the i-fax.com server (by fax or scanner), the barcode is interpreted by i-fax.com's server. The i-fax.com server renames the document with the encoded identifier found in the barcode and sends the document to your website by FTP file transfer or as an email.

File Types

i-fax.com will deliver files to your server by FTP or Email. Every file sent from the i-fax.com server will follow this naming convention:

File Formats

The following file types are produced by the i-fax.com server:

1. The first page of the document is provided in a miniature version in JPEG format (240 x 345 pixels). The "thumbnail" allows your application to display a small version of the document (e.g. as a search result).

2. When you sign-up for the i-fax.com service you will be given the option of selecting one or more image formats for your documents. i-fax.com supports 3 image formats. The format you choose will depend on your application:

3. 1. Adobe PDF
      The i-fax.com server can produce a multi-page PDF file containing the document. The document is compressed in Group IV format to conserve storage space.

   2. TIFF
      The i-fax.com server can produce a multi-page Group IV TIFF file containing the document.

   3. JPEG
      The i-fax.com server will produce a series of JPEG file, each containing a page of the document.

4. If you have elected to receive files from i-fax.com using FTP (File Transfer Protocol), i-fax.com will send a file with a .udt extension to indicate that your document has been sent. This file will not appear on your server until the JPEG thumbnail and the document images in PDF, TIFF and/or JPEG have been delivered. Note: Your application should not start processing an FTP transfer until the .udt file is detected on your server.

   The .udt file contains information about the files received by i-fax.com .

   Field Name	Description
   CallerID	The caller id of the fax machine that the document was faxed from. If the document was not faxed or there was no caller id then the field is set to "Unknown".
   TransID	The unique identifier encoded in the barcode on the document. This is the same unique id used in the returned file names.
   Pages	The count of pages processed for the document.
   Orientation	"0" if the document was scanned or faxed with the barcode right side up, or "1" if the barcode was upside down. When a document is faxed or scanned in upside down, the i-fax.com server rotates them before sending them on for ease of handling.
   To	If the document was efiled instead of faxed, the "To:" line of the email is put here
   From	If the document was efiled instead of faxed, the "From:" line of the email is put here
   Subject	If the document was efiled instead of faxed, the "Subject:" line of the email is put here
   Senddate	If the document was efiled instead of faxed, the "Date:" line of the email header is put here

   A two-page document encoded with a "unique identifier" of 639787744 that is faxed upside down would have the following in the .udt file:
    
   CallerID=Unknown
TransID=63978744
Pages=2
Orientation=1

   Note:
   You will find examples of the Adobe PDF, TIFF, JPEG and .udt files with the files you receive when you Download the Plug-In.

File Transfer Options

i-fax.com can deliver files to your server in one of two formats:

1. FTP
   i-fax.com will transfer a group of files to the FTP server you specify when you sign-up for the i-fax.com service. You will be asked to provide a directory on your site that is accessible to an FTP transfer.

   It is recommended that you design your application to poll this directory looking for files with the .udt extension. i-fax.com always sends a .udt file when a transaction has been fully transferred.

   A number of strategies can be used to initiate the polling process. The strategy you chose will depend on the tools available to you on the web server you are using for your website:

2. 1. On Unix or Linux servers, you can schedule a job in the crontab that will capture transactions in your FTP directory and incorporate them with your web database. (This will not be possible in most hosted web environments.)

   2. On a Windows NT^®/2000 server, you can schedule a task in the Task Scheduler that will capture transactions in your FTP directory and incorporate them with your web database. (This will not be possible in most hosted web environments.)

   3. You can imbed a CGI script in a web page that is executed when the page is accessed. The CGI script can be designed to detect the arrival of a .udt file in the FTP directory and process the incoming document. The CGI script can be placed within a page that runs when users wish to access a document or in a page that is run frequently.

    

3. Email
   i-fax.com will email a group of files to the email address you specify when you sign-up for the i-fax.com service.

   Each email sent by the i-fax.com server will contain all of the files pertaining to a specific document. In the event that an end user sends multiple documents in one fax or scan (each document having a unique i-fax.com Barcode), the i-fax.com server will transmit each document and its associated files in a separate email.

   Emails sent by the i-fax.com server will contain the relevant files for a given document as attachments. Each email will contain the following entry in the "subject" line:

   Document for transaction #{unique identifier from i-fax.com Barcode}

   A number of strategies can be used to incorporate documents that have arrived by email. These include programs such as Procmail (for Unix and Linux environments) and Microsoft Exchange (for Windows NT^®/2000).

HOME | DEMO | ROI | PLUG-IN | TOOLS | TERMS OF SERVICE | OUR TECHNOLOGY | PRICING | FAQ'S | PRIVACY | CONTACT
ABOUT US

© 2013 i-fax.com Inc. All rights reserved. i-fax and the i-fax logo are trademarks of i-fax.com Inc. HP is a trademark of the Hewlett-Packard Company. All other brand or product names are trade marks or registered trade marks of their respective owners.