Replace Tag Text Description

Copyright 2006 Alpha-G Consulting, LLC

Delivery Method

This utility, like all Alpha-G Java utilities, is delivered (and kept up-to-date) via the Sun Java Web Start tool. Upon request, Alpha-G can supply a link to load a free utility for testing the Java Web Start delivery/deployment setup (the utility creates read-only logins for a Horizon DB). To be able to use any of the Alpha-G Java utilities, you must have Java Web Start installed and ready to go. See this link for instuctions on how to do that:

Getting set up to Run Replace Tag Text

Replace Tag Text Program Function

The Replace Tag Text utility program searches your Horizon database (versions 5.3 through 7.4) for instances of the specified target text (e.g.. computer file), in specified subfield (e.g. $h) of a specified tag (e.g.. 245), and replaces it with specified text (e.g.. electronic resource). It can also search for target data in a fixed-field of a given tag (when working with fixed field data, the target and replacement strings must be the same length). A Delete mode allows you to find a subfield containing a patricular pattern and delete it. When deleting subfields, you can optionally retain the final punctuation of the prior field (if any).

The text replacement operates on either bibliographic or authority records (although changing authority-controlled data via Replace Tag Text must be done with some extra care). Optionally, the utility can capture the key numbers of updated records so that these records may be reindexed using standard Horizon utilities. If desired, the utility can also retain the original, unmodified text to allow undoing the changes via SQL.

Replace Tag Text is a graphical user interface program and has fields to allow the user to specify the target and replacement strings of characters. In any given run of the program, you can specify different search and replacement tag, subfield, and text. Target and replacement strings can be as long or as short as desired and can include any characters you can enter on your keyboard.

Replace Tag Text does not recognize variations in spelling (except capitalization). That is, if the target text were Computer File, and a given record included an abbreviated form of this (as shown below), it would not be replaced:

Comp. File

however, if it were as shown here, it would be replaced (since the only difference is in capitalization):

computer file

In a similar way, the replacement is direct and exact: the capitalization of the target text will not be preserved by modifying the replacement text to conform to it. For example, if the target text were Computer File (as shown above), and the replacement text were electronic resource, the script will convert all capitalization variants of the target text directly to the exact replacement text, not some variant of the replacement which matches the capitalization pattern of the target variant.

For example, Replace Tag Text would replace this variant

Computer file

with:

electronic resource

(the replacement text)

not with:

Electronic resource

(modified replacement matching target's original capitalization)

Replace Tag Text's textual replacement does not affect any surrounding punctuation, delimiters, or other characters, but will only operates on the letters (and punctuation) of the target text itself. For example, if the target is surrounded by punctuation (as shown here), the surrounding punctuation is not affected (following the same example of target and replacement text used above):

$aTitle of the work$h[computer file]$kform of the work

becomes:

$aTitle of the work$h[electronic resource]$kform of the work

If the user sets the target text to include any punctuation, it is considered as part of the target and the script will replace it with the target. As the user Replace Tag Text has complete control over the contents of target and replacement, this characteristic of the script can be either ignored (because the target or replacement of interest includes no punctuation); or exploited, if you happened to need to deal with a target that included punctuation. The rule regarding surrounding punctuation and delimiters holds regardless of the target (nothing other than the specific characters included in the target is affected).

As an example, if the target were comp. file and the replacement electronic resource, the script would behave as shown here:

$aTitle of the work$h[comp. file]$kform of the work

becomes:

$aTitle of the work$h[electronic resource]$kform of the work

That is to say, the period that is part of the target comp. file is replaced because it is part of the target text itself. The surrounding brackets and so on are not affected.

Acceptance:

Alpha-G represents that Replace Tag Text works substantially as described here. If, upon initial testing, the customer believes it does not function as described, Alpha-G will refund the purchase price or fix the problem. The customer is responsible for testing the utility program and determining its suitability for use in the intended application. Use of the program certifies that the customer has read and agreed to Alpha-G's Terms and Conditions (including limitations of liability and waiving of the right to sue Alpha-G) as posted at:

http://www.alphagconsulting.com
(navigate to the Terms section via the menu)

If you cannot agree to these Terms and Conditions, do not purchase a license for the product.

Updates:

Alpha-G may make enhancements and adjustments to the program and documentation from time to time. Java Web Start automatically retrieves program changes the next time the program is run. Documentation is available on the utility's home page (which is accessible via the Java Web Start program manager). Although there are no plans to do so, Alpha-G may discontinue making improvements or enhancements to this program at some future point. Customized changes to the program can be provided at Alpha-G's programming rates (see http://www.alphagconsulting.com).

Licensing:

The program is licensed to be installed and used on a single computer system. It may not be resold or transmitted to any third party. The program and its documentation are copyrighted by Alpha-G Consulting, LLC and all rights are reserved to the copyright holder.