Editing Cgi/users/lookup/

{{dirs}}

These are scripts used by the autocomplete system in the workflow.

*'''[[EPrints_Directory_Structure/eprints3|eprints3]]/[[EPrints_Directory_Structure/eprints3/cgi|cgi]]/[[EPrints_Directory_Structure/eprints3/cgi/users|users]]/lookup'''
** '''event_by_name''' - Can only be linked from the event_name field. Looks up existing events with the same name and suggests them filling in other parts of the even data such as dates, location and type.
** '''file''' - This uses a file in [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/autocomplete|eprints3/archives/ARCHIVEID/cfg/autocomplete/]]. The name of the file is specified in the CGI param "file". The format of the file is a set of lines. Each line contains a lookup string, a tab, and a chunk of XML. This XML is a single autocomplete block.
** '''journal_by_issn''' - Lookup journal details (issn, name, publisher) from the issn field. Looks at only records already in the repository.
** '''journal_by_name''' - Lookup journal details (issn, name, publisher) from the journal title field. Looks at only records already in the repository.
** '''name''' - Lookup the name of creators (and their email), uses existing creators.
** '''simple_file''' - As with "file" above, but just contains a list of lookup values, one of which may be selected to populate the current field only.
** '''simple_sql''' - As with SQL (see below), but just uses the "value" field to populate the current field only.
** '''sql''' - Similar to file, but uses an SQL table to do the lookup. The table is specified by the CGI param "title" but will be prefixed with "ac_". So a title param of "badger" would lookup in table "ac_badger". This table must contain a column titled "value" containing lookup terms and a column titled "xml" containing an XML autocomplete block.
** '''title_duplicates''' - This works only on the "title" field and warns of duplicates, rather than offering completion.

The '''file''', '''simple_file''', '''sql''' and '''simple_sql''' scripts may take a second CGI parameter, "mode". This may be set to "phrase" or "prefix". "phrase" is the default, and searches for the partial string anywhere within the lookup value. If set to "prefix" then this only matches starting at the start of the lookup value. This is primarily useful for large SQL tables, if you've added an index to the "value" field. 

You can drop your own custom scripts into this directory, but you shouldn't if you do ''not'' want to lose your file with the next update: As usually it's advised to put it into <code>repoID/cgi</code>, <code>cfg/cgi</code> or even <code>site_lib/cgi</code>, depending on the intended scope respectively.