Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter Twenty-oneEDGARView Integration (continued)

21.3 EDGAR Archive

21.3.1 EDGAR Archive Object

The EDGAR Archive object allows the loading, mapping and extraction of EDGAR data from Public Dissemination System (PDS) and return copy files.

The basic process involves opening a PDS or Return Copy file and then using the object handle to extract data.

PDS files will not contain all documents originally submitted to the SEC and may contain additional information not filed. Confidential information will be redacted, this includes the document type ‘COVER’. For filings containing XBRL, all the XBRL viewer information is included in the PDS. For a typical filing, this can significantly increase the document count.

In addition, there are Legato functions for referencing the EDGAR Archive.

21.3.2 Extended Error Information

Since the archive and return copy must be parsed from a source from the SEC and the data may be corrupt or of an incorrect format, there are sub codes returned and combined with the ERROR_SYNTAX formatted code.

1 – Syntax error in the formatting of the PDF container.

2 – Syntax error in the formatting of the container for ZIP, Excel, JPG or GIF files.

3 – Incorrect sequence (ie., expected <DOCUMENT> tag).

4 – Incorrect sequence (ie., end of document header group not found).

5 – Hit end of file before end of document.

6 – Expected document delimiter not found in return copy format.

7 – Invalid data within return copy document header.

In many cases, the extended error message may have additional details regarding the point of failure, such as the source line number and or condition.

21.3.3 Functions

Company:

EDGARFetchArchiveList — Enumerates all file paths for EDGAR archive files.

EDGARFetchFileNumberInfo — Looks up a company data using the file number and EDGAR Archive.

EDGARFetchFilingsByCIK — Retrieves archive index of filings by CIK.

EDGARFetchFilingsByFileNumber — Retrieves archive index of filings by SEC File Number.

Opening an Archive:

EDGARArchiveOpen — Opens an EDGAR Archive or Return Copy file.

EDGAR Archive Properties:

EDGARArchiveGetFileCount — Gets the total count of files in the archive.

EDGARArchiveGetProperty — Accesses a specific property by name or position.

EDGARArchiveGetObjectType — Returns the type of archive: PDS or Return Copy.

Documents:

EDGARArchiveGetDocDescription — Gets the EDGAR Document ‘Description’.

EDGARArchiveGetDocType — Gets the EDGAR Document ‘Type’.

EDGARArchiveGetDocFileType — Gets the underling file type.

EDGARArchiveGetDocFile — Extracts a file and writes to a specified location with default filename or with a specified filename.

EDGARArchiveGetDocName — Gets the name (filename) of the document as filed.

Page revised 2024-10-21