Getting Started
To create a new EZproxy Config file
- Select New File from the Actions menu in the navigation bar, or click the New button on Costanza's home page
- Enter a name for the new file. Unlike EZproxy itself, which uses plain text files, Costanza uses JSON formatted files to store data. Be sure to give the file a
.jsonfile extension. - If you'd like to start with the default configuration that ships with EZproxy, click the Use default EZproxy config checkbox
- Click the Create File button
Costanza can support as many files as you'd like; just give each a unique name when creating them.
To import an existing EZproxy configuration into Costanza:
- Select Import EZproxy files from the Actions menu in the navigation bar, or click the Import button on Costanza's home page
- Multiple files can be imported by simply dragging and dropping them into the grey import area. Alternatively, you can click the grey import are to bring up a standard file browse dialog, and select the files you wish to import.
- By default, Costanza will not overwrite any existing files that have the same name as the files being imported. If you wish to overwrite any previously created or imported files that have the same name, be sure to check the Allow existing files to be overwritten checkbox.
Notes:
- Because many EZproxy directives are position independent in the EZproxy config file, finding the correct beginning and ending of a stanza during the import process can be very difficult. Costanza will do its best to correctly identify all comments, directives and stanzas, but the imported files should be carefully reviewed
- Costanza does not currently attempt to identify and match imported stanzas to existing OCLC databases. Rather, it imports each stanza as a custom stanza. This is due in part to the previously mentioned difficulties in identifying the correct begin and end locations of stanzas. These custom stanzas can be replaced with the correct database entry during the edit process.
Costanza uses JSON formatted files to store EZproxy configuration information. A future version of Costanza will allow these JSON files to be imported directly, hopefully alleviating some of the issues associated with importing and parsing EZproxy's text based config files.