speedcopy
speedcopy
START
,
END
,
FROM

The speedcopy statement copies multiple adjacent fields from a record in one database to a record in another.

Parameters

This statement has three parameters:

start – is the first field to be replaced in the current database. The field name must be surrounded with quotes, for example: `"City"`, not `City`.

end – is the last field to be replaced in the current database. This field must be to the right of the start field in the data sheet. The field name must be surrounded with quotes, for example: `"Zip"`, not `Zip`.

from – is the field in the second database that corresponds to the start field in the current database. The field name must be surrounded with quotes, for example: `"City"`, not `City`.

Description

This statement is designed to be used in combination with a lookup( function. First you lookup, then you copy. The speedcopy will copy additional data from the record that was located by the lookup( function. The speedcopy statement is much easier to write than multiple lookups.

For this example, assume that you have two databases, one named Customer and another named Organizer. Both have fields name Address, City, State and Zip. The example below will quickly look up a customer from the Customer database and copy their address into the Organizer database (which is the currently active database).

    Address=lookup( "Customers",Company,Company,Address,"",0)
    if Address <> ""
        speedcopy "City","State","Zip"
    endif

Here is the same procedure but written without using the speedcopy statement.

    Address=lookup("Customers",Company,Company,Address,"",0)
    City=lookup("Customers",Company,Company,City,"",0)
    State=lookup("Customers",Company,Company,State,"",0)
    Zip=lookup("Customers",Company,Company,Zip,"",0)

Note: Starting with Panorama X, there is another way to do this using the lookupmoredata( function.

    Address=lookup("Customers",Company,Company,Address,"",0)
    City=lookupmoredata(City,"")
    State=lookupmoredata(State,"")
    Zip=lookupmoredata(Zip,"")

Unlike using speedcopy, the lookupmoredata( technique doesn’t require that the fields be in the same order in the two databases. If they are in the same order, it’s probably simpler to use speedcopy.

See Also

- fieldvalue( -- grabs the contents of a field in the current record of a database. You can grab data from the current database, or from another database.
- formulavalue( -- calculates the result of a formula based on data in the current record of any open database. This is similar to the fieldvalue( function, but allows any formula to be used, rather than just a single field.
- globaldictionarybuild -- builds a global dictionary by scanning a database.
- join -- joins data from another database into the current database.
- joinonerecord -- joins matching data from another database into the current record.
- lastlookupdatabase( -- returns the name of the database referenced in the most recent lookup.
- lookup( -- searches a database for a value, then returns other information from the same record. For example, the *lookup(* function can look up a phone number given a customer name, or look up a price given a part number.
- lookupall( -- builds a text array containing one item for every record in the target database where the data in the keyField matches the keyData. Each item in the text array contains the value extracted from the dataField for that record. If the data field is a numeric or date field, it is converted to text using the default patterns for that field.
- lookupalldouble( -- is similar to the lookupall( function, but it returns two fields from the target database instead of just one.
- lookupalloctet( -- is similar to the lookupall( function, but it returns eight fields from the target database instead of just one.
- lookupallquadruple( -- is similar to the lookupall( function, but it returns four fields from the target database instead of just one.
- lookupallquintuplet( -- is similar to the lookupall( function, but it returns five fields from the target database instead of just one.
- lookupallseptuplet( -- is similar to the lookupall( function, but it returns seven fields from the target database instead of just one.
- lookupallsextet( -- is similar to the lookupall( function, but it returns six fields from the target database instead of just one.
- lookupalltriple( -- is similar to the lookupall( function, but it returns three fields from the target database instead of just one.
- lookuplast( -- searches the selected records in a database for a value, then returns other information from the same record. For example, the *lookuplast(* function can look up a phone number given a customer name, or look up a price given a part number. Unlike the lookup( function which searches from the top of the database, the *lookuplast(* function searches backwards from the bottom.
- lookuplastselected( -- searches the selected records in a database for a value, then returns other information from the same record. For example, the *lookuplastselected(* function can look up a phone number given a customer name, or look up a price given a part number. Unlike the lookupselected( function which searches from the top of the database, the *lookuplastselected(* function searches backwards from the bottom.
- lookupmoredata( -- looks up an additional data field based on the previous lookup.
- lookupmoreformula( -- looks up additional data based on a previous lookup.
- lookupselected( -- searches the selected records in a database for a value, then returns other information from the same record. For example, the *lookupselected(* function can look up a phone number given a customer name, or look up a price given a part number.
- related( -- searches a database for a record in a related database that matches the current record in the current database based a relational specification (based on one or more key fields or formulas in each database), then uses a formula to return other information from the same record. This is similar to the lookup( function, but instead of using an individual field for the key, a relation is used (see Relational Database Management).
- relatedarray( -- builds an Text Array by scanning a database and creating an array element for every record that matches a relational specification (based on one or more key fields or formulas). This is similar to the arraybuild( function, but instead of using an individual field for the key, a relation is used (see Relational Database Management).
- relatedrecordid( -- returns the record id of a record in a related database that matches the current record in the current database based on a relational specification.
- Relational Workshop -- tool that assists in composing relational lookup(, superlookup(, lookupall( and arraybuild( functions.
- serverlookup( -- searches a shared database for a value, then returns other information from the same record. Similar to the lookup( function, but the search is performed on the server instead in the local computer's memory.
- superlookup( -- searches a database for a record that matches a query formula, then uses a second formula to return other information from the same record. This is similar to the lookup( function, but instead of using an individual field for the key and data, any valid true/false (Boolean) formula can be used.
- table( -- searches a database for a value, then returns other information from the same record. Unlike the lookup( function, the *table(* function does not require an exact match. If it does not find an exact match the *table(* function will use the closest match. For example, the *table(* function can look up a tax rate given an income amount, or look up a shipping price given a zip code and weight.

History

Version | Status | Notes
10.0 | Updated | Carried over from Panorama 6.0, but works differently internally so that it no longer has the possibility of corrupting the data if the database fields don't match up exactly.