Converter

  • single-user program built in Visual Basic, to use only by a centralized server, denominated local server. It is mandatory only one installation by SciELO collection or instance.
  • Converter reads the files from markup and body folders, and the databases in title and issue folders, then generates a ISIS database in base folder of the corresponding journal issue.

Opening the program

_images/converter_menu.jpg

Checking the program version

To check the version of the program, see How to check the program version.

Changing the language of the program

To change the language of the program’s interface, see Change the language of the program.

Running the program

  1. Select Files.

    _images/converter_open_files.png
  2. Fill the fields:

    _images/converter_01.png
    • journal’s title: select the title of the journal.
    • year: FILL ONLY if it is AHEAD or REVIEW number
    • volume: fill it in with the volume
    • supplement of volume: fill it in with the supplement of volume, if it exists
    • number: fill it in with the number. If it is an ahead or review/provisional number, use ahead or review, respectively
    • supplement of number: fill it in with the supplement of number, if it exists
    • part: fill it in, if it exists. Recently it is used to press release, fill it in with pr.
    _images/converter_issue_selected.png
  1. Click on OK button.

  2. Converter uses these data to identify the issue’s, markup and body folders. If the data are correct, the program will list the markup files.

    _images/converter_files_selected.png
  3. Click on Convert button.

  4. Converter will convert the selected files.

    For each file, the program:

    • extracts the marked data
    • compares the issue’s data in the markup file and in the issue database, managed by Title Manager->Issues.

    If there is some conflicting data, the data are not converted to the database. It is a fatal error. The user must check and correct the data in the markup document (using Markup program) and/or in issue database (using Title Manager).

    If the issue’s data is correct, the files are converted to the database and the result will be shown on the screen.

    _images/converter_resultado.jpg

    Results:

    • successfully converted: [], in red.
    • converted, with errors: [X], in blue before its name. They have some markup errors, but not fatal enough to avoid conversion. For example, markup error, probably identified by Parser, but not corrected by the user.
    • not converted: at the inferior part, in green. It is usually related to issue’s data, such as ISSN, abbreviated title, volume and number, which do not match in the markup file and in the issue database.
  5. Clicking on each file in the result area and then on Result button, the user can see how the conversion run.

Successfully converted

_images/converter_view_report.png

Converted, but no fatal error: markup error

_images/converter_resultado2.jpg

Converted, but no fatal error: some bibliographic references not identified

Converter locates each bibliographic reference of the markup file in the body file, identifying the points where [Links] must be inserted at the article page, in the website.

_images/converter_resultado6.jpg

Clicking on [Links], a window is open to display a list of links to the referenced fulltext.

_images/converter_resultado6b.jpg

If there are bibliographic reference location errors, Converter will present the result bellow:

_images/converter_resultado5.jpg

Not converted, because of fatal errors

_images/converter_resultado3.jpg