Skip to main content
OCLC Support

DeriveNewRecord

Find the syntax, use, parameters, return values, and an example for the DeriveNewRecord macro command in Connexion client.
Syntax BOOL = CS.DeriveNewRecord (bFixedField)
Use to Derive a new record from the current record.

Same as using the menu command Edit > Derive > New WorldCat Record.
Parameters For bFixedField, enter True if you want to transfer the fixed field to the new record, or enter False if not.

 Note: 

  • The command uses your settings in Tools > Options > Derive Record to determine the variable fields to transfer to the new record (default: 1XX through 8XX, where X is any number).
  • Although this parameter does not apply to authority records, you must enter a value for the macro to derive an authority record successfully. Enter either True or False. The client ignores the parameter for derived authority records.
Return values TRUE if the action is successful, or FALSE if not.
Example Sub Main()

     Dim CS As Object
     Set CS = GetObject(,“Connex.Client”)

     Dim bResult As Integer

     If CS.IsOnline = False Then
          CS.Logon ““, ““, ““
     End If

     CS.Search “WC”, “#1”

     If CS.DeriveNewRecord(True) = True Then
          MsgBox “Derive was successful”
     Else
          MsgBox “Derive failed”
     End If
End Sub

What this example does
  • Logs on to Connexion if not already logged on, using the default authorization and password you selected in Tools > Options > Authorizations tab.
  • Searches WorldCat for record number 1.
  • Derives a new record based on record number 1, transfers the fixed field to the new record, and if the action is successful, returns the message: Derive was successful. If not, returns the message: Derive failed.