gm-import_incoming(1)

NAME
gm-import_incoming - a script to import a file into the INCOMING area of a GNUmed database.

SYNOPSIS
gm-import_incoming [-h|?] [--help] [--local-import] --file2import=FILE --data-type=TYPE --user=USER [--host=HOST] [--port=PORT]

DESCRIPTION
gm-import_incoming is a script for importing a file into the GNUmed database area where incoming files are stored which have not been linked to any patient. A type is associated with the data for easier recognition.

This script can be used to import for later processing fax images, lab data, referral letters, and similar data which electronically arrives on your system.

OPTIONS

--help, -h, -?
    Show a help screen.

--local-import
    At startup adjust the PYTHONPATH such that the GNUmed client is run from a local copy of the source tree (say, an unpacked tarball) rather than from a proper system-wide installation.

--file2import=FILE
    This is the file to be imported into GNUmed.

    Successfully imported files are renamed to FILE.imported within the directory in which FILE resides.

--data-type=TYPE
    A short moniker, say, a word or two, used to describe the data in FILE to the user when viewed inside GNUmed.

    The actual content of TYPE is only limited by the execution environment (locale, encoding, ...) of gm-import_incoming. GNUmed does not need to understand what TYPE means to the user.

--user=USER
    The PostgreSQL user to be used for connecting to the database.

    Note that this must currently be a GNUmed staff account. It will also work with the cluster superuser (usually "postgres") or the GNUmed database owner (typically "gm-dbo") but using these in production is strongly discouraged for data security reasons.

--host=HOST
    The hostname of the machine PostgreSQL is running on, if required.

    If this option is not used (or set to an empty string) it will default to connecting over UNIX domain sockets.

--port=PORT
    The port PostgreSQL is listening on. Default PostgreSQL installations listen on port 5432.

There are no options for database name or password.

The script uses the default database name of the GNUmed version the script is released with thereby assuring data does not get imported into an older database following an upgrade.

If a password is needed (that is, if TRUST, IDENT, or PEER authentication is not in use) it must be supplied by either setting the $PGPASSFILE environment variable or using a standard ~/.pgpass file.

ENVIRONMENT

PGPASSFILE

    http://www.postgresql.org/docs/devel/static/libpq-pgpass.html

FILES
~/.pgpass

    http://www.postgresql.org/docs/devel/static/libpq-pgpass.html

SEE ALSO

http://wiki.gnumed.de
    Detailed Wiki-style documentation

/usr/share/doc/gnumed/
    Local documentation

man -k gm-*
    List man pages on gm-* commands.