Business objects ACE CANADA 7.70C User Manual

Page 1
ACE Canada
Release Notes
Version 7.70c May 2006
What’s included in this release?........... 2
Documentation ................................. 3
Installation notes .............................. 4
ACE Canada Job only: New input file
options ............................................ 5
Assignment correction ....................... 6
Contact information
Phone U.S. and Canada: 888-788-9004
Fax 608-788-2870 Web http://www.firstlogic.com/customer E-mail customer@firstlogic.com Mail 100 Harborview Plaza
Technical support is available weekdays 8 a.m. to 6 p.m. Central time.
Firstlogic Proprietary and Confidential
© 2006 Firstlogic, Inc. All rights reserved. This publication and accompanying software are protected by U.S. copyright law and international treaties. No part of this publication or accompanying software may be copied, transferred, or distributed to any person without the express written permission of Firstlogic, Inc.
elsewhere: +1-608-788-9000
La Crosse WI 54601
Page 2

What’s included in this release?

SERP certification This release continues the SERP recognition until 30 September 2007. Several

enhancements are available in parsing and assignment logic to handle more address formats and improve our SERP test scores.

New dual-address component

The following dual-address component is now available.
Output component Length Description
APD.Rec_Type (Job)
CACE_DUAL_REC_TYPE
(Library)
2 When a dual address is identified but not
assigned, ACE Canada will provide an address-type indication based on the way that the input data was parsed.
antee.
ACE Canada may indicate that a street, rural route, highway contract, general delivery, or PO box was parsed.
FFirm
G General Delivery
H High-rise apartment or office build-
ing
PPost Office Box
R Rural Route or highway contract
SStreet
blank Unassigned
This is not a guar-
New alias address­line component

New Country component

Address assignment correction

The following alias address-line component is now available.
Output component Length Description
APA.Prim_Range (Job)
CACE_APA_PRIM_RANGE (Library)
Up to 100 House number, house description, or post-
office box number. For example, for the address “123 Main Street,” the range is “123.”
The new Country component returns the fully-spelled country name. If ACE Canada encounters a foreign address, it will return the foreign country name and an error code E501
Output component Length Description
AP.Country (Job)
CACE_COUNTRY (Library)
Up to 100 The fully-spelled country name.
Updates to the address assignment logic correct an issue where Suffix and Directional fields returned corrected data when they should have returned parsed data. See “Assignment correction” on page 6.
2
ACE Canada Version 7.70c Release Notes
Page 3

Documentation

Complete documentation set

Access the latest documentation

A complete ACE Canada documentation set includes the following:
ACE Canada Job-File Reference (if you use ACE Canada job file) ACE Canada Library Reference (if you use ACE Canada Library) Quick Reference for Views and Job-File Products (if you use ACE Canada
job file)
Quick Reference for Library Products (if you use ACE Canada Library) System Administrator’s Guide Edjob User’s Guide Database Prep
You can access Firstlogic documentation in several places:
On your computer. Release notes, manuals, and other documents for each
Firstlogic product that you’ve installed are available in the Documentation folder. Choose Start > Programs > Firstlogic Applications > Documentation.
On the Firstlogic Customer Portal. Go to www.firstlogic.com/customer,
log on using your username and password, and then click the Documentation link to access all the latest Firstlogic documentation. You can view the PDFs online, save them to your computer, or order professionally printed documents that will be delivered to you. To order printed documents, see the following instructions.

Order printed documents

You can order professionally printed documents and have them delivered to you for a small charge. Your documents will be sent to you as soon as the next business day.
1. Go to www.firstlogic.com/customer, log on using your username and password, click the Documentation link, and then click the Printed Technical Documentation link.
If this is your first time accessing the Mimeo site, you’ll be prompted to open an account before you can log in. Follow the instructions on screen to open an account.
2. Log in to Mimeo.
3. To access Firstlogic documents, in the Folders area on the left side of the Mimeo web site, choose DocCenter Shared Folders > Firstlogic Inc.
DocCenter > Firstlogic’s Printable Materials > Technical Documentation.
4. Choose the documents that you want printed.
5. Follow the instructions on screen to place your order.
Documentation
3
Page 4

Installation notes

Installation advice To simplify installation, read the following tips before you begin:

You should give the contents of this software shipment to your system
administrator. Firstlogic recommends that our software be installed only by, or with the approval of, the system administrator.
You’ll find your software CDs in the Firstlogic binder or CD case(s).
Although you can install your applications and directories in any order, we
recommend that you install software first and then directories.
If you install on multiple operating systems, check the bottom of the CD label
for the appropriate operating system.

Install on Windows When you insert the Firstlogic CD, the installation program should start

automatically. If it doesn’t, follow these steps:
1. Access your Windows Start menu and choose Run.
2. In the Run window, type x:\setup (where x is the letter of your CD-ROM drive) and click OK. The installation program should start.
Install ACE Canada 7.70c in a directory called pw. Be sure to install all supporting directory files. Run ACE Canada directly from the appropriate subdirectory, for example, pw\cace or pw\cacelib.
For details, see the System Administrator’s Guide.

Install on UNIX To install, run the UNIX install_console. For more information, see the

System Administrator’s Guide.

Client shortcuts If you have ACE Canada installed on one computer, but you run it from another

computer using client shortcuts, you must refresh your client-side shortcuts by using the Firstlogic Universal Client installer.

Job users If you use the job-file product, update your job files using the version of

Edjob installed in your pw\adm directory. Here is the general form of the command line:
edjob [options] [path]pwcacjob.upd job_file.cac

Operating system versions

You should run ACE Canada on the same operating system that we test the software. See Firstlogic’s InfoSource for a chart that lists the operating systems and current versions that you should use. You can find the most recent issue on our Customer Portal web site at:
http://www.firstlogic.com/customer/bulletins
4
ACE Canada Version 7.70c Release Notes
Page 5

ACE Canada Job only: New input file options

In order to more consistently handle definition and format files from one Firstlogic product to the next, we have added two options to the Input File block:
Override Default Format File Override Default DEF File
These changes apply to Job only.
Use the new options to specify the format and definition file options that you want to use above all other settings. For example, let’s say that you typically use a template when creating your jobs, and you have the format and definition files already specified in the Auxiliary Files block. You can set these override options to use a different format or definition file without having to remove the default options in the Auxiliary Files block.
ACE Canada looks for the definition and format files in the following order:
the Override options listed in the Input File block the files with the same name in the same folder as the input file the files listed in the Auxiliary Files block
Entering paths in the Input File block are optional. You do not need to set these options in order to process the job.
New Job-file options
BEGIN Input File ============================================== Input File Name (path & file name)... =
Input Filter (to 512 chars).......... =
Override Default Format (path & file) = Override Default DEF (path & file)... =
Starting Record Number............... =
Ending Record Number................. =
END
Output file format. If you are copying the input format to your output file, and you have the format and definition files set in both the Input File and Auxiliary File blocks, the output format will use the new override setting specified in the Input File block.
ACE Canada Job only: New input file options
5
Page 6

Assignment correction

Previous versions of ACE Canada corrected data in the Suffix and Directional fields for unassigned addresses when it should have returned only parsed data. Version 7.70c correctly returns parsed Suffix and Directional data.
When you disable the Standardize Unassigned Addresses option, ACE Canada will not return corrected data in the Suffix and Directional fields. It will return the parsed, uncorrected data. Here are a few examples:
This affects only the parsed data, not the corrected (standardized) data. If you enable the Standardize Unassigned Addresses, the Canada engine will standardize even the unassigned addresses and correct the best components for these fields.
However, if you disable this option and an address is unassigned, the best components will remain the parsed (original) components that represent the input data.
Example 1 In this example, previous versions returns corrected and truncated data. Version
7.70c returns the data exactly as it was found on input regardless of length or
accuracy.
Input
123456 MAIN STREEEET SOUTHEAST
Previous version Version 7.70c
SUFFIX: ST (shortened format) LONG SUFFIX: STREET (corrected data) DIR: SO (truncated data) LONG DIR: SOUTHEAST
Example 2 In this example, previous versions returned the corrected, fully spelled suffix and
SUFFIX: STREEEET LONG SUFFIX: STREEEET DIR: SOUTHEAST LONG DIR: SOUTHEAST
directional. Version 7.70c returns the data exactly as it was found on input.
Input
123456 MAIN ST SW
Previous version Version 7.70c
LONG SUFFIX: STREET LONG DIR: SOUTHWEST
LONG SUFFIX: ST LONG DIR: SW
6
ACE Canada Version 7.70c Release Notes
Page 7
Assignment correction
7
Page 8
8
ACE Canada Version 7.70c Release Notes
Loading...