docs/RELEASE_NOTES_NEXT/Cataloging/marc_export_replacement.txt

   1 marc_export script replacement
   2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
   3
   4 The `/openils/bin/marc_export` script is completely rewritten.  This
   5 new version accepts all of the same command line options as the old
   6 version as well as some new options.
   7
   8 The rewritten `marc_export` talks directly to your Evergreen database
   9 and is a great deal faster than the previous version.  Because the new
  10 script talks directly to the database, it needs to know how to
  11 connect.  To facilitate this, a new option, `--store`, was added that
  12 allows the user to specify one of three Evergreen storage backends to
  13 use when exporting records.  The valid choices are `reporter`,
  14 `cstore`, or `storage`.  The default of `reporter` should work in most
  15 cases, but if you do have a separate reporter database and you know
  16 you want to talk directly to your main production database, then you
  17 will probably want to choose either `cstore` or `storage`.
  18
  19 In addition to the `--store` option, a `--since` option is also added
  20 so that you can specify output of an update file of records changed,
  21 added, and/or deleted since the given date.  The `--since` option uses
  22 a fairly flexible date parser and can accept a wide range of date
  23 formats including ISO 8601, man common date formats such as M/D/Y
  24 (common in the US) or D/Mon/Y (with the first 3 characters or more of
  25 the month spelled out), as well as several less common date formats.
  26 Special date strings such as `yesterday`, `today`, `yesterday week`,
  27 and `today week` are also supported.  For more information see the
  28 VALID DATE FORMATS section of the `Date::Manip::Date` man page.
  29 Available online here:
  30
  31 http://search.cpan.org/~sbeck/Date-Manip-6.42/lib/Date/Manip/Date.pod#VALID_DATE_FORMATS
  32
  33 There is one final difference between the new script and the old
  34 `marc_export`.  The new script does not output progress as it
  35 executes.  Many of the statistics that the script reported are not
  36 readily available to the new script.  It was deemed better to just not
  37 output any progress rather than to output something different from the
  38 old program.  If your scripts parse the output from `marc_export`,
  39 they will need to modified not to expect any.