autodelivery user's guidecontent.pbinsight.com/downloads/support/adv_1.0.1_users_guide.pdf ·...

AutoDelivery User’s Guide

Version 1.0.1

June 2008

For Windows

© 2008 Pitney Bowes Software, Inc.

All rights reserved. Pitney Bowes Software is a registered trademark of Pitney Bowes Software, Inc. Group 1, the Group 1 logo, and AutoDelivery are trademarks of Pitney Bowes Software, Inc. Pitney Bowes and "Engineering the flow of communication" are trademarks of Pitney Bowes, Inc. All other marks are trademarks or registered trademarks of the respective owners.

Pitney Bowes Software, Inc. holds a non-exclusive license to publish and sell ZIP + 4® databases on optical and magnetic media. The following trademarks are owned by the United States Postal Service®: CASS, CASS Certified, DPV, eLOT, FASTforward, First-Class Mail, Intelligent Mail, LACSLink, NCOALink, PAVE, PLANET Code, Postal Service, POSTNET, Post Office, RDI, SuiteLink , United States Postal Service, Standard Mail, United States Post Office, USPS, ZIP Code, and ZIP + 4. This list is not exhaustive of the trademarks belonging to the Postal Service.

Pitney Bowes Software is a non-exclusive licensee of USPS® for NCOALink® processing.

Prices for Pitney Bowes Software's products, options and services are not established, controlled or approved by USPS® or United States Government. When utilizing RDI™ data to determine parcel-shipping costs, the business decision on which parcel delivery company to use is not made by the USPS® or United States Government.

AD# 12.07

PITNEY BOWES SOFTWARE, INC DOCUMENTATION DEPARTMENT4200 PARLIAMENT PL STE 600LANHAM MD 20706-1844

DADV101WPUSG

AutoDelivery User’s Guide 3

T A B L E O F C O N T E N T S

BEFORE YOU BEGIN

Purpose of This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Who Should Use This Guide?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Conventions Used in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6If You Need More Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Your Personal Contact Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7The Website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8eService. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Online Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Education . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Service Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

To Obtain Additional User's Guides. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Your Comments Are Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

CHAPTER 1. INTRODUCTION TO AUTODELIVERY

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12What Is AutoDelivery? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12System Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13What Was Installed with AutoDelivery? . . . . . . . . . . . . . . . . . . . . . . . . 14Registering and Activating AutoDelivery . . . . . . . . . . . . . . . . . . . . . . . 15

CHAPTER 2. WORKING WITH THE AUTODELIVERY CONFIGURATION INTERFACE

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Using the AutoDelivery Dashboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Navigating the Configuration Interface . . . . . . . . . . . . . . . . . . . . . . . . 20

Parts of the Configuration Interface. . . . . . . . . . . . . . . . . . . . . . . . 21Viewing Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Entering Your Support Username and Password . . . . . . . . . . . . . . . . 23Entering Information for Email Notifications. . . . . . . . . . . . . . . . . . . . 24Adding and Deleting Databases for Download. . . . . . . . . . . . . . . . . . . 26

Adding a Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Editing Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Deleting a Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Working with the View Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Setting the Log Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Configuring the Proxy Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Viewing the Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Changing the Download Time, Date, and Frequency Settings . . . . . . 38Running AutoDelivery Downloads in the Background. . . . . . . . . . . . . 38Turning Off AutoDelivery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

INDEX

4 Version 1.0.1/June 2008


B E F O R E Y O U B E G I N

This chapter discusses the purpose and use of this guide, how its conventions are presented, and how to obtain assistance from Group 1 Software, Inc.

Purpose of This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Who Should Use This Guide? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Conventions Used in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6If You Need More Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Your Personal Contact Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7The Website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8eService. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Online Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Education . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Service Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

To Obtain Additional User's Guides. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Your Comments Are Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10


Purpose of This Guide

Welcome to the AutoDelivery User’s Guide! This guide is intended to provide you with all the information you need to effectively use AutoDelivery, including conceptual information and instructions on configuring and running the software.

This guide has two main chapters:

• Chapter 1, "Introduction to AutoDelivery", provides general information about AutoDelivery, including a description of its features, a diagram of its architecture, and a summary of the files and folders included with the software.

• Chapter 2, "Working with the AutoDelivery Configuration Interface", explains how to use the configuration interface to specify options for AutoDelivery. You will learn how to enter your support username and password, specify your email information, add and delete databases for download, and more.

Who Should Use This Guide?

This guide was developed for both new and experienced AutoDelivery users. It is recommended that you read Chapter 1 first and then proceed to Chapter 2.

NOTE: : This book assumes familiarity with the Windows platform.

Conventions Used in This Guide

This guide uses the following typefaces and symbols for presentation purposes:

Bold Indicates a button, check box, field, folder, keyboard key, list box, path, radio button, text box, toolbar, or user input.

Italics Indicates a book name, dialog box, menu, script variable, or window.

Script Indicates system information, such as scripts or screen data.

“Quoted” Indicates one of the following (1) text that appears on a screen, window, text, or dialog box, such as a message or list box option or (2) text that you are to type (you do not type the quotation marks).

AutoDelivery User’s Guide ‘ 7

NOTE: Indicates important information or warnings.

1. Indicates numbered steps in a process.

.. Indicates spaces (blanks) in parameter record images or example data.

This column is used for references to other sections or chapters containing related information.

Throughout this manual, the term “Windows” refers to either Microsoft Windows 2000, Windows XP, or Windows Server 2003 operating systems unless otherwise specified.

If You Need More Help

If you are unable to resolve a problem, a Group 1 Technical Support Representative can help guide you to a solution. When you call Group 1 Technical Support, please have the following information ready:

• A description of the task you were performing

• The resulting Execution Log (if available).

Reporting complete details to Technical Support will help you and the technical support representative quickly resolve the problem.

Group 1 Software technical support representatives work closely with you so that:

• Your questions on using AutoDelivery are answered quickly

• Any problems you may encounter while using AutoDelivery are resolved.

The Technical Support Hotline number for customers in the United States and Canada is 800-367-6950.

Your Personal Contact Profile

It is a good idea to verify your personal contact profile while you are on the phone with a Technical Support representative to ensure that he or she can keep in touch with you regarding your support request. Various types of contacts are maintained in our database. Each contact is assigned a personal contact ID, which can be referred to any time you call the Technical Support Department. Technical Support representatives can also provide you with the names listed in our database as primary contacts for your company.


NOTE: If you wish to update your personal contact record (name, phone number, email address, etc.), please use our eService option available from the Group 1 Support Site at http://www.g1.com/support. Once you are logged on, select the eService Knowledge Base option.

The Website

You can also find out about Group 1 products and services through the Group 1 Software website at http://www.g1.com. Registered users can obtain electronic copies of product documentation, join online discussion forums, download software and databases, find out about our training classes, or sign up for Group 1 Software List Services. From the home page, click Customer Login.

The Group 1 Technical Support website requires you to log in using your user ID and password to access the download pages. If you do not have a user ID and password, you can request them from https://www.g1.com/Support.

For your convenience, there is also an AutoDelivery forum where you can discuss the product. It can be accessed at http://www.pbsoftwareforum.com/index.php?board=95.0.

NOTE: Registered users are those who have a maintenance agreement with Group 1 Software. Contact Technical Support to obtain your user ID and password.

eService

eService, available through the Group 1 website, provides supported Group 1 customers with direct access to Service Requests and the Group 1 Solutions Knowledge Base. You can search for your own Service Requests, search the Group 1 Knowledge Base, and access a variety of other Technical Support services. You must be a registered user, with an ID and password, to access eService.

http://www.pbsoftwareforum.com/index.php?board=95.0

http://www.pbsoftwareforum.com/index.php?board=95.0

http://www.g1.com

http://www.g1.com/support

AutoDelivery User’s Guide ‘ 9

Online Documentation

Group 1's Support site is frequently updated with information about the products you use and new services that Customer Information Management offers. The Documentation page of the Support site at http://www.g1.com/Support/Docs provides customers with documents such as Product Certification Certificates, Release Announcements, Technical Notes, and much more.

All pre-release and release announcements distributed to customers are documented in NewsCast (Customer Information Management's self-subscribing electronic newsletter). Please visit the List Services page of the Support Site at http://www.g1.com/Email for information on how to subscribe to NewsCast. You also have the option of self-subscribing to other List Services. These are detailed in the List Services section as well.

Education

Group 1 Software offers comprehensive training courses on all of its products, allowing you to maximize the usability of your software.

Group 1 offers access to its courses in three ways: public seminars, eLearning, and on-site training. You can choose the option that best fits your needs.

• For information about public seminars or eLearning classes, visit our website at http://www.g1.com/Education.

• For information about on-site training, contact the Group 1 Education Manager at (301) 918-6392.

Service Source

For detailed information on all of the customer services provided by Group 1’s technical post-sales departments, refer to our online Service Source guide. This provides guidelines and service descriptions to help you use Technical Services as effectively as possible.

Please visit the Service Source area of the Group 1 Support Site at http://www.g1.com/Support/Orientation.

To Obtain Additional User's Guides

To obtain electronic copies of our product manuals, go to the Group 1 website at www.g1.com and click on Customer Login in the upper right corner. Log in with your

http://www.g1.com

http://www.g1.com/Education

http://www.g1.com/Support/Docs

http://www.g1.com/Email

http://www.g1.com/Email

http://www.g1.com/Support/Orientation

http://www.g1.com/Support/Orientation


User ID and password. On the left side of the window under “Technical Services” click on Documentation to download copies (.pdf files) of available user guides.

NOTE: To view.pdf files, you must have Adobe Acrobat Reader version 5.0 (or later) installed on your PC. If you do not have Acrobat Reader, you can download it for free from http://www.adobe.com.

Your Comments Are Welcome

We appreciate and welcome your comments concerning this guide! If you have suggestions, please let us know. A Documentation Comment Form is available online at http://www.g1.com/Support/Forms/. You may also make product enhancement suggestions using the System Enhancement Form located at this address.

For your convenience, you may also submit change requests by clicking on the Report an Error button located at the bottom of each page of the PDF version of this guide. You will be redirected to a feedback form where you can enter your comments.

As another option, comments may be sent to the following address:

Group 1 Software Inc.Attn.: Documentation Manager4200 Parliament Pl Ste 600Lanham MD 20706-1844

With your help and suggestions, we can continue to provide quality software.

Thank you.

http://www.g1.com/Support/Forms/


C H A P T E R 1

Introduction to AutoDeliveryThis chapter provides general information about AutoDelivery, including a description of its features, a diagram of its architecture, and a summary of the files and folders included with the software.

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12What Is AutoDelivery? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12System Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13What Was Installed with AutoDelivery? . . . . . . . . . . . . . . . . . . . . . . . . 14Registering and Activating AutoDelivery . . . . . . . . . . . . . . . . . . . . . . . 15

Introduction to AutoDelivery1


Overview

This chapter serves as an introduction to AutoDelivery. It includes the following:

• A definition of AutoDelivery

• A description of the system architecture

• A listing and explanation of the files created upon installation.

What Is AutoDelivery?

AutoDelivery is an application that allows you to automate the delivery of your Group 1 product database files. Instead of having to access the Group 1 website every time a new database is available, you can simply configure AutoDelivery to check for updates periodically and download them when appropriate.

You may schedule AutoDelivery to perform these steps routinely through your Microsoft Windows® Task Scheduler. Though AutoDelivery can operate entirely behind the scenes, there are several options that you can configure to meet your site’s needs. For example, you may add or delete databases to be downloaded and provide information for email notifications of the success or failure of your downloads.

NOTE: Any time you upgrade one of AutoDelivery’s associated Group 1 products to a new version, you must also update AutoDelivery’s database configurations to reflect the new version number.

System Architecture 1


System Architecture

AutoDelivery operates on a client-server architecture. In this setup, the client communicates securely via HTTPS with a server-side web service and download server to retrieve the necessary database file(s). The following diagram illustrates this architecture.

Figure 1: AutoDelivery Architecture

NOTE: All communications over the Internet use HTTPS. Please make sure that port 443 is open.



What Was Installed with AutoDelivery?

For the purpose of this discussion, we assume that you have installed AutoDelivery in C:\Program Files\Group1\AutoDelivery\.

After you have completed your installation using the directions that accompanied the software, take a look at the Group 1 folder. If this is the first time you have installed a Group 1 product, you will find that this is the folder that the installation program creates to contain Group 1 applications and their associated files.

Table 1 describes some of the key items that can be found in this folder.

Most of the other files in your AutoDelivery folder pertain to the software GUI. None of these files should be altered in any way.

Table 1: AutoDelivery Folder Contents

File/Folder Description

g1.config File containing the general configuration settings for the application.

NOTE: This is updated by the application via the configuration commands and should not be edited by hand. Doing so may prevent the application from functioning properly.

log.txt The Execution Log, containing information on all AutoDelivery activity.

NOTE: This file may not exist until the first execution of AutoDelivery has occurred.

logging.config File containing the log-related configuration settings for the application.

NOTE: This is updated by the application via the configuration commands and should not be edited by hand. Doing so may prevent the application from functioning properly.

AutoDelivery.exe The executable user interface.

Registering and Activating AutoDelivery 1


Registering and Activating AutoDelivery

Upon installing AutoDelivery, you will be asked to register the product using a valid email address.

Figure 2: AutoDelivery Registration and Activation Dialog Box

After you enter your information and press [Register], an activation key will be mailed to you. To access all of the features of the AutoDelivery interface, select [Activate] and enter the key in the appropriate field.



You can also configure your proxy settings from this dialog box by selecting the Proxy Settings tab. The following will appear:

Figure 3: Proxy Settings Tab

See “Configuring the Proxy Settings” on page 37 for more more information on how to set up your proxy.


C H A P T E R 2

Working with the AutoDelivery Configuration Interface

This chapter explains how to use the configuration interface to specify options for AutoDelivery. You will learn how to enter your support username and password, specify your email information, add and delete databases for download, and more.

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Using the AutoDelivery Dashboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Navigating the Configuration Interface . . . . . . . . . . . . . . . . . . . . . . . . 20

Parts of the Configuration Interface. . . . . . . . . . . . . . . . . . . . . . . . 21Viewing Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Entering Your Support Username and Password . . . . . . . . . . . . . . . . 23Entering Information for Email Notifications. . . . . . . . . . . . . . . . . . . . 24Adding and Deleting Databases for Download. . . . . . . . . . . . . . . . . . . 26

Adding a Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Editing Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Deleting a Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Working with the View Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Setting the Log Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Configuring the Proxy Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Viewing the Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Changing the Download Time, Date, and Frequency Settings . . . . . . 38Running AutoDelivery Downloads in the Background. . . . . . . . . . . . . 38Turning Off AutoDelivery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Working with the AutoDelivery Configuration Interface2


Overview

During the installation process, you should have set Windows Scheduler to call AutoDelivery at a specified time each day. There is other information that you must provide in order for AutoDelivery to run properly, however. This is where the AutoDelivery dashboard comes into play.

The dashboard serves as a gateway to the configuration interface, where you can enter the required information (such as the databases you wish to check for and your support username and password). It also allows you to directly search for database updates at the push of a button. The dashboard is executed during the installation process, and you may access it at any other time to update your AutoDelivery settings.

This chapter will provide you with everything you need to know about the AutoDelivery dashboard and configuration interface. It covers the following topics:

• Using the AutoDelivery dashboard

• Navigating the configuration interface

• Entering your support username and password

• Entering information for email notifications

• Adding and deleting databases for download

• Setting the download URL and the log level

• Configuring the proxy settings

• Viewing the log

• Changing the download time, date, and frequency settings

• Running AutoDelivery downloads in the background

• Turning off AutoDelivery.

Using the AutoDelivery Dashboard 2


Using the AutoDelivery Dashboard

The AutoDelivery dashboard provides quick-access to the four main AutoDelivery functions.

Figure 1: The AutoDelivery Dashboard

• Check for updates — Click here to initiate a check for available downloads. This is disabled when a download is currently in progress. If you close the dashboard during a download, a message box will appear allowing you to either abort the download and close the interface or continue the download in the background. For more information, see “Running AutoDelivery Downloads in the Background” on page 38.

• Stop processing — Click here to stop a check that is in progress. This is only enabled if the download process has been started.

• Configuration — Click here to access the configuration interface. (For more information, see “Navigating the Configuration Interface” on page 20.)

• Help — Click here to access the product help system.

The progress bar below the row of icons displays information pertaining to the current download activity. It reports the progress of the following:

• Communications with the Group 1 web server

• Backing up of the download directory (optional)

• Downloading the file

• Unzipping the file (optional).

The progress bar will also indicate when an error has occurred. If this is the case, you can click the [...] button next to the bar to access the log, which contains detailed information on your download.



Navigating the Configuration Interface

The configuration interface consists of six main screens on which you will enter and view your information: Credentials, E-mail, Databases, Misc, Proxy, and Log.

Each screen has the same setup, containing the elements below (illustrated in Figure 2):

• Screen title and description — This is the leftmost pane, which provides the title of the selected option pane to the right as well as a brief description of its purpose.

• Option pane — This is the rightmost pane where the user will specify information to be used by AutoDelivery.

• Save/Close buttons — Located at the bottom of the option pane, the [Save] and [Close] buttons allow you to save your changes and close the configuration interface, respectively. If you attempt to close the interface with unsaved changes, you will receive a prompt asking if you want to save.

• Navigation buttons — At the bottom of the left pane, you will see a list of buttons for each screen: [Credentials], [E-mail], [Databases], [Misc], [Proxy], and [Log]. Clicking on any of these will allow you to navigate to that option pane.

• List of viewing options — The arrows located beneath the navigation buttons lead to a drop-down menu listing viewing options for the configuration interface. For more information on these options, see “Viewing Options” on page 22.

Navigating the Configuration Interface 2


Parts of the Configuration Interface

Figure 2: Parts of the Configuration Interface



Viewing Options

You have several options when it comes to the appearance of the buttons on the configuration interface. The arrows at the bottom of the left pane lead to a drop-down menu listing the following:

• Show More Buttons — Adds buttons back to the screen if they have been removed (this is initially grayed out).

• Show Fewer Buttons — Deletes buttons from the screen.

• Navigation Pane Options — Opens the Navigation Pane Options window.

Clearing a checkbox will remove that button from the screen. You may also change the order of the buttons by highlighting a button and then selecting [Move Up] or [Move Down] to the right. Click [OK] to save your changes or [Cancel] to return to the previous screen without saving.

• Add or Remove Buttons — Leads to a sub-menu where you may select a specific button to add or remove.

Entering Your Support Username and Password 2


Entering Your Support Username and Password

You must provide AutoDelivery with your support username and password in order to access the selected databases for download. If you do not provide this information, you will receive a credentials-related error when you try to run AutoDelivery.

The Credentials screen, which should be the first screen that you see upon opening the configuration interface, allows you to enter this information. You can also access this screen by clicking the [Credentials] button to the bottom left.

Figure 3: Credentials Screen



The following table describes each field on the Credentials screen.

Entering Information for Email Notifications

You can configure AutoDelivery to send you emails indicating the success or failure of every download attempt. For this, you must provide AutoDelivery with your SMTP server, the address that will be used to send the email, and the list of email recipients. The E-mail screen (shown in Figure 4) allows you to provide this information. This can be accessed by selecting the [E-mail] button at the bottom left of the screen.

When you are finished, you may test your configurations to make sure everything was entered correctly.

Table 1: Fields on the Credentials Screen

Field Name User Action Required

User ID Enter the support username that you received with AutoDelivery.

Password Enter the support password that you received with AutoDelivery.

Entering Information for Email Notifications 2


Figure 4: E-mail Screen



The following table describes each field on the E-mail screen. .

Adding and Deleting Databases for Download

Currently, AutoDelivery is configured to work with a number of product databases. The Databases screen (shown in Figure 5) allows you to add, delete, and edit database information. You also have several viewing options for this screen.

NOTE: You must enter and save your support username and password on the Credentials screen before you can add a database.

Table 2: Fields on the E-mail Screen

Field/Button Name User Action Required

Smtp Server Enter the SMTP server that is to be used to send AutoDelivery email notifications.

From Address Enter the email address from which you would like the notifications to be sent.

To Address Enter the email addresses (separated by commas) of the intended recipients of the notifications.

Send Test Mail Press this button to send a test message. If everything was entered correctly, all of the listed recipients will receive a test email, which they will be instructed to disregard.

Adding and Deleting Databases for Download 2


Figure 5: Databases Screen



Adding a Database

To add a database to the list of items that AutoDelivery will check for when it runs, click Add database on the left side of the screen. AutoDelivery will check your credentials (see “Entering Your Support Username and Password” on page 23) to determine which databases you have subscribed to. If your support information was entered correctly on the Credentials screen, the Add Database window will appear.

Figure 6: Add Database Screen

The following table describes each field on the Add Database screen. When you are finished entering information here, click [Add] to see your addition on the main Databases screen or [Cancel] to close the window without saving your changes.



Table 3: Fields on the Add Database Screen


Product Name Select the appropriate product name from the drop-down list.

Product Version Select the version of the product that you wish to add.

Operating System Select your operating system from the drop-down list.

Database Name Select the name of the database that you wish to add from the drop-down list.

Download Folder Enter the path for or browse to the folder where you would like to store the database downloads.

NOTE: The download folder that you specify should be dedicated only to the database file at hand (that is, it should not be used for anything else), because everything in this folder will be copied to the backup folder periodically.

Backup Folder Enter the path for or browse to the folder where you would like AutoDelivery to backup your database files. (Optional)



Editing Database Information

To edit information for a database that you have listed for download, highlight that database on the Databases screen and then click Edit Database. The Edit Database screen appears.

Figure 7: Edit Database Screen

This is essentially the same as the Add Database screen, but the fields will contain your previous specifications for the database. When you have finished making your changes to the fields, click [Done] to see the new database information on the main Databases screen or [Cancel] to exit the screen without saving.

NOTE: Any time you upgrade one of AutoDelivery’s associated Group 1 products to a new version, you must also update AutoDelivery’s database configurations to reflect the new version number.



Deleting a Database

To delete a database that you have listed for download, highlight that database on the Databases screen and then click Remove Database.

Working with the View Options

AutoDelivery allows you to view your database information in a variety of ways. There are two main views that you can select from: Standard View and Card View. These are available by selecting one of the radio buttons at the top of the screen.

You can also collapse (and then re-expand) these options by clicking the [-]/[+] button next to View Options.

Standard View

The Standard View is the default. This view is essentially a table with one database per row and with the database information provided in columns. You can click on the column names to sort the databases in alphabetical or reverse-alphabetical order based on the category at hand.



Figure 8: Standard View



Card View

The other view option is the Card View. In this view, all the information for an individual database is grouped together, with the categories — or cards — listed to the left and the actual specifications to the right.

Figure 9: Card View



Grouping Information by Category

For both the Standard and Card View, you can drag one of the column headers or cards to the box directly above the listing of databases to view information on only that category. The example below shows the Database Name information.

Figure 10: Dragging a Card

The [+]/[-] buttons next to each entry allow you to expand and collapse the rest of the information for each database.

Setting the Log Level 2


Setting the Log Level

The log level may be specified through the configuration interface. This is taken care of through the Misc screen.

Figure 11: Misc Screen



The following table describes each field on the Misc screen.

NOTE: All communications over the Internet use HTTPS. Please make sure that port 443 is open.

Table 4: Fields on the Misc Screen


Log Level Select the level of detail to be reported in the Execution Log. The following options are available on the drop-down list:

• Fatal — Logs errors from which the application is unlikely to recover.

• Error — Logs errors from which the application is likely to recover. These errors may indicate a more severe problem, however.

• Warn — Logs warning messages that the application may generate. These may indicate problems but often do not.

• Info — Logs informational messages about what the application is doing. These do not indicate problems.

• Debug — Logs detailed messages about what the application is doing. Generally, this setting is only used to troubleshoot issues.

• All — Logs all of the above messages.

The default is Info.

Auto-Extract Contents of Zip Database Files

Select this check box to automatically unzip database files that are of type .zip.

Set to Defaults Press this button to reset all the options on this screen to their default values.

Configuring the Proxy Settings 2


Configuring the Proxy Settings

To set up and use a proxy to access the Group 1 web and download servers, navigate to the Proxy screen.

Figure 12: Proxy Screen



The following table describes each field on the Proxy screen..

Viewing the Log

The log contains detailed information on your download history and current download progress. It is also helpful in troubleshooting problems. To view the log, you may either click [...] on the AutoDelivery dashboard or select [Log] on the configuration interface. You may need to resize your screen.

The level of information that the log reports is configured on the Misc screen. For more information, see “Setting the Log Level” on page 35.

Changing the Download Time, Date, and Frequency Settings

If you wish to change the download time, date, and frequency settings, you must do so through the Windows Scheduler. Refer to the Microsoft webpage (http://www.microsoft.com/) for more information on Windows Scheduler.

Running AutoDelivery Downloads in the Background

You can use the Windows Task Scheduler to run AutoDelivery in silent mode. The command for this is

AutoDelivery.exe –s

The dashboard can be displayed at any time by running AutoDelivery.exe.

Turning Off AutoDelivery

If you wish to turn off AutoDelivery, you must cancel the associated task in the Windows Scheduler.

Table 5: Fields on the Misc Screen


Use Proxy Select this check box to indicate that you wish to use a proxy.

HTTP Proxy Enter the HTTP proxy address.

User ID Enter the user ID.

Password Enter the password.

Test Proxy Click to test proxy configuration.

http://www.microsoft.com/


I N D E X

AActivating AutoDelivery, 15Add Database screen, 28Adding databases, 26, 28–29AutoDelivery

Architecture, 13Definition, 12Forum, 8Turning off, 38

AutoDelivery.exe, 14AutoDelivery dashboard, 19Auto-extract contents of zipped database files, 36

BBackground, running downloads in, 38Backup folder, 29

CCard View, 33Comments, sending to Group 1, 10Configuration interface

Navigation, 20Screen components, 21Viewing options, 22Working with, 17–38

Contact ID, 7Contact profile, 7Conventions used in this guide, 6Credentials screen, 23Customer Support. See Technical Support.

DDashboard, 19Database files

Unzipping, 36Databases screen, 26

Card View, 33Standard View, 31View options, 31–34

Definition of AutoDelivery, 12

Deleting a database, 26, 31Download folder, 29Dragging cards, 34

EEditing database information, 26, 30Email address

Recipients, 24, 26Sender, 24, 26

Email notifications, 24–26E-mail screen, 25Enhancements, requesting for this product, 10Error

Credentials related, 23eService, 8Execution Log, 14

FFiles created upon installation, 14Forum, 8

Gg1.config, 14

HHelp

getting, 7

IInstallation, 14, 18Introduction to AutoDelivery, 11–15, ??–16

IndexIX


LLog, viewing, 19, 38log.txt, 14logging.config, 14Log level, 35, 36

MMisc screen, 35–36

NNavigating the configuration interface, 20NewsCast, 9

OObtaining additional user’s guides, 9Online documentation, 9

PPassword, 23, 24Personal contact profile, 7Ports, 13, 36Product enhancements, requesting, 10Progress bar, 19Proxy screen, 37Proxy settings, 16Purpose of this guide, 6

RRegistering AutoDelivery, 15Running downloads in the background, 38

SService Source, 9Silent mode, 38SMTP server, 24, 26Standard View, 31

Support password, 23, 24Support username, 23, 24System architecture, 13

TTechnical Support, 7Test email, sending, 26Turning off AutoDelivery, 38

UUnattended mode, 38Unzipping database files, 36Username, 23, 24

VViewing the log, 38

WWebsite, Group 1, 7Who should use this guide, 6Windows Scheduler, 18, 38

ZZipped database files, 36

Feedback

Contact Preferences

May we contact you if we have questions about your comments?

Yes

No

Contact Information

Name:

Email:

Phone:

Best time to contact:

Comments

Enter you comments here:

Document Title:

Document Date:

Software Version:

Comment regarding page:

Pitney Bowes Group 1 Software4200 Parliament Pl Ste 600Lanham, MD 20706-1844www.g1.com

Main: +1 (301) 731-2300Sales: +1 (888) 413-6763Support: +1 (800) 367-6950

autodelivery user's guidecontent.pbinsight.com/downloads/support/adv_1.0.1_users_guide.pdf ·...

Documents