Guides
Start typing to search…

The .go File

The .go file is an XML file that provides essential information about the submission package. Below is an example of a ScholarOne .go file, and a table containing descriptions for each element.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE GO SYSTEM "S1_GO.dtd">
<GO>
    <header>
        <clientkey>83a32662-a2ea-4ff1-bf27-851436f32150</clientkey>
        <journal_abbreviation>salesdemoplus</journal_abbreviation>
        <ip_address>127.127.127.1</ip_address>
        <user_identifier>7e4d9d8e-76ff-4aca-918a-186e89c377d9</user_identifier>
     </header>
     <package>
        <archiveFile>ARCHIVE_NAME-EXTERNAL_ID.zip</archiveFile>
        <metadata-file-name>ARCHIVE_NAME.xml</metadata-file-name>
        <file-name>
            <name>file1.ext1</name>
        </file-name>
        <file-name>
            <name>file2.ext2</name>
        </file-name>
        <file-name>
            <name>fileN.extN</name>
        </file-name>
     </package>
    <document-version version="original | revision | resubmission | replacement | final_files |
 first_look | invited | add-external-id" prev-id="external manuscript id of the previous submission"
 attempt-submit="Y"/>
    <document-replaces doc-id="643670695"/>
</GO>

.go XML File Element Descriptions

Element

Description

<clientkey>

This is the client key provided by ScholarOne. It is not the same as the AWS S3 keys.

<journal_abbreviation>

Journal abbreviation: Find this value appended to the end of the URL of the ScholarOne site to which you are submitting.

<ip_address> and <user_identifier>

When the "Ignore submit UAD on ingested manuscripts if no cookie supplied" configuration option is enabled, the Unusual Activity Detection (UAD) system will no longer flag submission events when an admin, acting as a proxy for the author, reviewer or editor, submits a manuscript, review or makes a decision on a manuscript, provided that no browser cookie is available. UAD checks will continue to work as expected if the event cookie(user_identifier)/IP address tags are passed in via the go.XML.

<archiveFile>

Name of your archive file (.zip) containing the JATS XML metadata and manuscript files.

<metadata-file-name>

Name of your JATS XML metadata file contained within the .zip file referenced above.

<file-name>

List of manuscript files included in the archive (excluding the JATS file referenced in metadata-file-name). Missing, extraneous, or incorrectly named files will cause ingestion failure.

<document-version>

All submission ingestions are either original, revision, resubmission, replacement, final_files, first_look or invited.
The add-external-id ingestion type is a specialized process used to assign an external ID to a manuscript that has been transferred into the system.
For revision, resubmission, final_files, first_look and replacement ingestion types, the prev-id attribute is required.
The optional attempt-submit attribute, if present and set to "Y", indicates that the manuscript should be automatically submitted upon successful ingestion. Applicable to all ingestion types, except Update External Id.

<document-replaces>

For final_files, first_look, invited and replacement ingestion types, the document-replaces element is required.
The doc-id attribute must contain the ScholarOne document ID of the existing manuscript draft being replaced.
This ID is not the common manuscript ID but a different identifier used by ScholarOne. You can obtain this value through ScholarOne HTML notifications.

S1_GO.dtd

The .go file must conform to the S1_GO.dtd Document Type Definition (DTD). Below is the DTD for the .go file:

<?xml version="1.0" encoding="UTF-8"?>
{/*S1 GO.dtd 1.0*/}
<!ELEMENT GO (header, package, document-version)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT header (clientkey, journal_abbreviation, ip_address?, user_identifier?)>
<!ELEMENT package (archiveFile, metadata-file-name, file-name+)>
<!ELEMENT clientkey (#PCDATA)>
<!ELEMENT file-name (name)>
<!ELEMENT archiveFile (#PCDATA)>
<!ELEMENT metadata-file-name (#PCDATA)>
<!ELEMENT journal_abbreviation (#PCDATA)>
<!ELEMENT document-version EMPTY>
<!ATTLIST document-version
    version (original | revision | resubmission | replacement | final_files | first_look | invited | add-external-id) #REQUIRED
    prev-id CDATA #REQUIRED
    attempt-submit CDATA #IMPLIED>
<!ELEMENT document-replaces EMPTY?>
<!ATTLIST document-version doc-id CDATA #REQUIRED>

Updated 5 months ago

What’s Next