Write to a GeoJSON File

The Write to a GeoJSON File output connector can be used to write event records, adapted as GeoJSON, to a GeoJSON file.

Learn more about GeoJSON data record formatting

Usage notes

Keep the following in mind when working with the Write to a GeoJSON file output connector:

• This output connector pairs the GeoJSON outbound adapter with the file outbound transport.
• The registered server folder can be specified using either an absolute path or UNC path.
• If a UNC path is used, the Windows service account running GeoEvent Server needs read and write permissions to the folder.
• As a best practice, use absolute paths, for example, C:\GeoEvent\output, for the Folder parameter.
• The Subfolder parameter allows a subfolder relative to the registered server folder to be specified.
• If you restart the output, GeoEvent Server creates a new file in the registered system folder path.
• Depending on the rate and volume of processed event records, it is recommended that you increase the File Rollover Size (KB) parameter beyond the default value of 1 to avoid creating a cascade of JSON files that Windows cannot keep up with.
• It is recommended to set File Header and File Footer parameters to default values when writing GeoJSON objects to a file. This organizes the collection of GeoJSON objects as a FeatureCollection.

  Learn more about the GeoJSON specification

• Network latency can impact the ability of GeoEvent Server to write high volumes of data to a file over a UNC path.

Parameters

The parameters for the Write to a GeoJSON File output connector are described below:

Parameter	Description
Name	A descriptive name for the output connector used for reference in GeoEvent Manager.
Folder	The registered system folder under which files are created and written to.
Filename Prefix	Specifies the name of the output file GeoEvent Server creates and writes to. Appended to the file name is the date/time when the file was first created. The default is output. For example, a file name prefix of output created on March 19, 2019 at 2:30:05 p.m. would result in a file named output2019-03-19_14-30-05.out.
Subfolder	The name of a subfolder (or subdirectory) relative to the registered system folder under which files are created and written to. Leave this parameter blank if no subfolder exists. For example, specifying a registered system folder as C:\GeoEventand a subfolder as output results in GeoEvent Servercreating the file at C:\GeoEvent\output assuming the file path exists and is accessible by the Windows service account running ArcGIS GeoEvent Server.
File Extension	The file extension used when creating files. The default is JSON.
File Rollover Method	Specifies the method used to determine when GeoEvent Serverstops writing to a current file and starts writing to a new file. The options are By Size and By Time. The default is By Time. By Size—GeoEvent Server stops writing to the current file and creates a new file when a specified file size threshold is met. By Time—GeoEvent Server stops writing to the current file and creates a new file when a specified age threshold is met.
File Rollover Size (KB) (Conditional)	Specifies the maximum size, in kilobytes (KB), a file can reach before GeoEvent Server stops writing to it. Once the maximum file size has been reached, GeoEvent Server creates a new file to start writing to. The default is 1kilobyte. This parameter is shown when File Rollover Method is set to By Size and is hidden when it's set to By Time.
File Rollover Frequency (Conditional)	Specifies the frequency in which GeoEvent Server stops writing to the current file and instead creates a new file to start writing to. The available age-based rollover options are Hourly, Daily, and Monthly. The default is Hourly. Hourly—GeoEvent Server stops writing to the current file and starts writing to a new file each hour. Daily—GeoEvent Server stops writing to the current file and starts writing to a new file each day. Monthly—GeoEvent Server stops writing to the current file and starts writing to a new file each month. This parameter is shown when File Rollover Method is set to By Time and is hidden when it's set to By Size.
File Cleanup Age (minutes)	Specifies the age, in minutes, from which existing files are managed in accordance with the File Cleanup Method parameter. The default is 4320 minutes. For example: Every three days (4,320 minutes) files are either deleted or archived.
File Cleanup Method	The method used for managing existing files that have reached the File Cleanup Age (minutes) value. The file cleanup options are Delete and Archive. The default is Delete. Delete—Files that have reached the age specified by the File Cleanup Age (minutes)parameter are deleted. Archive—Files that have reached the age specified by the File Cleanup Age (minutes) parameter are archived.
Archive Folder (Conditional)	The registered system folder under which files that have reached the File Cleanup Age (minutes) value are archived. This parameter is shown when File Cleanup Method is set to Archive and is hidden when it's set to Delete.
Archive Subfolder (Conditional)	The subfolder relative to the Archive Foldervalue under which files that have reached the File Cleanup Age (minutes) value are archived. Leave this parameter unspecified if there is no subfolder for archiving files. There is no default for this parameter. This parameter is shown when File Cleanup Method is set to Archive and is hidden when it's set to Delete.
Formatted JSON	Specifies whether the GeoJSON is formatted (prettified). The default for this parameter is No. Yes—The GeoJSON is formatted (prettified). No—The GeoJSON is not formatted.
File Header	The characters that are inserted at the start of every GeoJSON file. GeoEvent Server can use any normal ASCII character, or combination of characters, as a file header. The default is {"type": "FeatureCollection", "features": [.
File Footer	The characters that are inserted at the end of every GeoJSON file. GeoEvent Server can use any normal ASCII character, or combination of characters, as a file footer. The default is a right bracket and right brace.
Event Separator	The character is used to separate each event record in the GeoJSON file. GeoEvent Server can use any normal ASCII character as an event separator. The default is a comma.