File: gmStaff.html

package info (click to toggle)
gnumed-client 1.8.21%2Bdfsg-1
links: PTS, VCS
area: main
in suites: forky, sid, trixie
size: 37,764 kB
sloc: python: 126,692; javascript: 6,113; sh: 1,195; xml: 36; makefile: 33
file content (1169 lines) | stat: -rw-r--r-- 56,069 bytes
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1" />
<meta name="generator" content="pdoc 0.10.0" />
<title>Gnumed.business.gmStaff API documentation</title>
<meta name="description" content="GNUmed staff objects." />
<link rel="preload stylesheet" as="style" href="https://cdnjs.cloudflare.com/ajax/libs/10up-sanitize.css/11.0.1/sanitize.min.css" integrity="sha256-PK9q560IAAa6WVRRh76LtCaI8pjTJ2z11v0miyNNjrs=" crossorigin>
<link rel="preload stylesheet" as="style" href="https://cdnjs.cloudflare.com/ajax/libs/10up-sanitize.css/11.0.1/typography.min.css" integrity="sha256-7l/o7C8jubJiy74VsKTidCy1yBkRtiUGbVkYBylBqUg=" crossorigin>
<link rel="stylesheet preload" as="style" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.1.1/styles/github.min.css" crossorigin>
<style>:root{--highlight-color:#fe9}.flex{display:flex !important}body{line-height:1.5em}#content{padding:20px}#sidebar{padding:30px;overflow:hidden}#sidebar > *:last-child{margin-bottom:2cm}.http-server-breadcrumbs{font-size:130%;margin:0 0 15px 0}#footer{font-size:.75em;padding:5px 30px;border-top:1px solid #ddd;text-align:right}#footer p{margin:0 0 0 1em;display:inline-block}#footer p:last-child{margin-right:30px}h1,h2,h3,h4,h5{font-weight:300}h1{font-size:2.5em;line-height:1.1em}h2{font-size:1.75em;margin:1em 0 .50em 0}h3{font-size:1.4em;margin:25px 0 10px 0}h4{margin:0;font-size:105%}h1:target,h2:target,h3:target,h4:target,h5:target,h6:target{background:var(--highlight-color);padding:.2em 0}a{color:#058;text-decoration:none;transition:color .3s ease-in-out}a:hover{color:#e82}.title code{font-weight:bold}h2[id^="header-"]{margin-top:2em}.ident{color:#900}pre code{background:#f8f8f8;font-size:.8em;line-height:1.4em}code{background:#f2f2f1;padding:1px 4px;overflow-wrap:break-word}h1 code{background:transparent}pre{background:#f8f8f8;border:0;border-top:1px solid #ccc;border-bottom:1px solid #ccc;margin:1em 0;padding:1ex}#http-server-module-list{display:flex;flex-flow:column}#http-server-module-list div{display:flex}#http-server-module-list dt{min-width:10%}#http-server-module-list p{margin-top:0}.toc ul,#index{list-style-type:none;margin:0;padding:0}#index code{background:transparent}#index h3{border-bottom:1px solid #ddd}#index ul{padding:0}#index h4{margin-top:.6em;font-weight:bold}@media (min-width:200ex){#index .two-column{column-count:2}}@media (min-width:300ex){#index .two-column{column-count:3}}dl{margin-bottom:2em}dl dl:last-child{margin-bottom:4em}dd{margin:0 0 1em 3em}#header-classes + dl > dd{margin-bottom:3em}dd dd{margin-left:2em}dd p{margin:10px 0}.name{background:#eee;font-weight:bold;font-size:.85em;padding:5px 10px;display:inline-block;min-width:40%}.name:hover{background:#e0e0e0}dt:target .name{background:var(--highlight-color)}.name > span:first-child{white-space:nowrap}.name.class > span:nth-child(2){margin-left:.4em}.inherited{color:#999;border-left:5px solid #eee;padding-left:1em}.inheritance em{font-style:normal;font-weight:bold}.desc h2{font-weight:400;font-size:1.25em}.desc h3{font-size:1em}.desc dt code{background:inherit}.source summary,.git-link-div{color:#666;text-align:right;font-weight:400;font-size:.8em;text-transform:uppercase}.source summary > *{white-space:nowrap;cursor:pointer}.git-link{color:inherit;margin-left:1em}.source pre{max-height:500px;overflow:auto;margin:0}.source pre code{font-size:12px;overflow:visible}.hlist{list-style:none}.hlist li{display:inline}.hlist li:after{content:',\2002'}.hlist li:last-child:after{content:none}.hlist .hlist{display:inline;padding-left:1em}img{max-width:100%}td{padding:0 .5em}.admonition{padding:.1em .5em;margin-bottom:1em}.admonition-title{font-weight:bold}.admonition.note,.admonition.info,.admonition.important{background:#aef}.admonition.todo,.admonition.versionadded,.admonition.tip,.admonition.hint{background:#dfd}.admonition.warning,.admonition.versionchanged,.admonition.deprecated{background:#fd4}.admonition.error,.admonition.danger,.admonition.caution{background:lightpink}</style>
<style media="screen and (min-width: 700px)">@media screen and (min-width:700px){#sidebar{width:30%;height:100vh;overflow:auto;position:sticky;top:0}#content{width:70%;max-width:100ch;padding:3em 4em;border-left:1px solid #ddd}pre code{font-size:1em}.item .name{font-size:1em}main{display:flex;flex-direction:row-reverse;justify-content:flex-end}.toc ul ul,#index ul{padding-left:1.5em}.toc > ul > li{margin-top:.5em}}</style>
<style media="print">@media print{#sidebar h1{page-break-before:always}.source{display:none}}@media print{*{background:transparent !important;color:#000 !important;box-shadow:none !important;text-shadow:none !important}a[href]:after{content:" (" attr(href) ")";font-size:90%}a[href][title]:after{content:none}abbr[title]:after{content:" (" attr(title) ")"}.ir a:after,a[href^="javascript:"]:after,a[href^="#"]:after{content:""}pre,blockquote{border:1px solid #999;page-break-inside:avoid}thead{display:table-header-group}tr,img{page-break-inside:avoid}img{max-width:100% !important}@page{margin:0.5cm}p,h2,h3{orphans:3;widows:3}h1,h2,h3,h4,h5,h6{page-break-after:avoid}}</style>
<script defer src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.1.1/highlight.min.js" integrity="sha256-Uv3H6lx7dJmRfRvH8TH6kJD1TSK1aFcwgx+mdg3epi8=" crossorigin></script>
<script>window.addEventListener('DOMContentLoaded', () => hljs.initHighlighting())</script>
</head>
<body>
<main>
<article id="content">
<header>
<h1 class="title">Module <code>Gnumed.business.gmStaff</code></h1>
</header>
<section id="section-intro">
<p>GNUmed staff objects.</p>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python"># -*- coding: utf-8 -*-
&#34;&#34;&#34;GNUmed staff objects.&#34;&#34;&#34;
#============================================================
__author__ = &#34;K.Hilbert &lt;Karsten.Hilbert@gmx.net&gt;&#34;
__license__ = &#34;GPL&#34;

# std lib
import sys
import logging

# GNUmed
if __name__ == &#39;__main__&#39;:
        sys.path.insert(0, &#39;../../&#39;)
        _ = lambda x:x
from Gnumed.pycommon import gmBusinessDBObject
from Gnumed.pycommon import gmPG2
from Gnumed.pycommon import gmNull
from Gnumed.pycommon import gmBorg
from Gnumed.pycommon import gmLog2
from Gnumed.pycommon import gmCfgDB
from Gnumed.pycommon import gmTools


_log = logging.getLogger(&#39;gm.staff&#39;)

_map_gm_role2pg_group = {
        &#39;public access&#39;: &#39;gm-public&#39;,
        &#39;non-clinical access&#39;: &#39;gm-staff&#39;,
        &#39;full clinical access&#39;: &#39;gm-doctors&#39;
}

#============================================================
_SQL_get_staff_fields = &#39;SELECT *, _(role) AS l10n_role FROM dem.v_staff WHERE %s&#39;

class cStaff(gmBusinessDBObject.cBusinessDBObject):
        _cmd_fetch_payload = _SQL_get_staff_fields % &#34;pk_staff = %s&#34;
        _cmds_store_payload = [
                &#34;&#34;&#34;UPDATE dem.staff SET
                                short_alias = %(short_alias)s,
                                comment = gm.nullify_empty_string(%(comment)s),
                                is_active = %(is_active)s,
                                db_user = %(db_user)s,
                                public_key = %(public_key)s
                        WHERE
                                pk = %(pk_staff)s
                                        AND
                                xmin = %(xmin_staff)s
                        RETURNING
                                xmin AS xmin_staff&#34;&#34;&#34;
        ]
        _updatable_fields = [&#39;short_alias&#39;, &#39;comment&#39;, &#39;is_active&#39;, &#39;db_user&#39;, &#39;public_key&#39;]

        #--------------------------------------------------------
        def __init__(self, aPK_obj=None, row=None):
                # by default get staff corresponding to CURRENT_USER
                if (aPK_obj is None) and (row is None):
                        cmd = _SQL_get_staff_fields % &#34;db_user = CURRENT_USER&#34;
                        try:
                                rows = gmPG2.run_ro_queries(queries = [{&#39;cmd&#39;: cmd}])
                        except Exception:
                                _log.exception(&#39;cannot instantiate staff instance&#39;)
                                gmLog2.log_stack_trace()
                                raise ValueError(&#39;cannot instantiate staff instance for database account CURRENT_USER&#39;)
                        if len(rows) == 0:
                                raise ValueError(&#39;no staff record for database account CURRENT_USER&#39;)
                        row = {
                                &#39;pk_field&#39;: &#39;pk_staff&#39;,
                                &#39;data&#39;: rows[0]
                        }
                        gmBusinessDBObject.cBusinessDBObject.__init__(self, row = row)
                else:
                        gmBusinessDBObject.cBusinessDBObject.__init__(self, aPK_obj = aPK_obj, row = row)

                # are we SELF ?
                self.__is_current_user = (gmPG2.get_current_user() == self._payload[&#39;db_user&#39;])

                self.__inbox = None

        #--------------------------------------------------------
        def __setitem__(self, attribute, value):
                if attribute == &#39;db_user&#39;:
                        if self.__is_current_user:
                                _log.debug(&#39;will not modify database account association of CURRENT_USER staff member&#39;)
                                return

                gmBusinessDBObject.cBusinessDBObject.__setitem__(self, attribute, value)

        #--------------------------------------------------------
        def _get_db_lang(self):
                rows = gmPG2.run_ro_queries (
                        queries = [{
                                &#39;cmd&#39;: &#39;select i18n.get_curr_lang(%(usr)s)&#39;,
                                &#39;args&#39;: {&#39;usr&#39;: self._payload[&#39;db_user&#39;]}
                        }]
                )
                return rows[0][0]

        def _set_db_lang(self, language):
                if not gmPG2.set_user_language(language = language):
                        raise ValueError (
                                &#39;Cannot set database language to [%s] for user [%s].&#39; % (language, self._payload[&#39;db_user&#39;])
                        )
                return

        database_language = property(_get_db_lang, _set_db_lang)

        #--------------------------------------------------------
        def _get_inbox(self):
                if self.__inbox is None:
                        from Gnumed.business import gmProviderInbox
                        self.__inbox = gmProviderInbox.cProviderInbox(provider_id = self._payload[&#39;pk_staff&#39;])
                return self.__inbox

        inbox = property(_get_inbox)

        #--------------------------------------------------------
        def _get_identity(self):
                from Gnumed.business.gmPerson import cPerson
                return cPerson(self._payload[&#39;pk_identity&#39;])

        identity = property(_get_identity)

        #--------------------------------------------------------
        def set_role(self, conn=None, role=None):
                if role.strip() == self._payload[&#39;role&#39;]:
                        return True

                cmd = &#39;SELECT gm.add_user_to_permission_group(%(usr)s::name, %(grp)s::name)&#39;
                args = {
                        &#39;usr&#39;: self._payload[&#39;db_user&#39;],
                        &#39;grp&#39;: _map_gm_role2pg_group[role.strip()]
                }
                rows = gmPG2.run_rw_queries (
                        link_obj = conn,
                        queries = [{&#39;cmd&#39;: cmd, &#39;args&#39;: args}],
                        return_data = True,
                        end_tx = True
                )
                if not rows[0][0]:
                        return False

                self.refetch_payload()
                return True

        role = property(lambda x:x, set_role)

        #--------------------------------------------------------
        def _get_public_key_file(self):
                if not self._payload[&#39;public_key&#39;]:
                        return None

                pk_fname = gmTools.get_unique_filename()
                with open(pk_fname, mode = &#39;wt&#39;, encoding = &#39;utf8&#39;) as pk_f:
                        pk_f.write(self._payload[&#39;public_key&#39;])
                return pk_fname

        def _set_public_key_file(self, pk_fname):
                with open(pk_fname, mode = &#39;r&#39;, encoding = &#39;utf8&#39;) as pk_f:
                        self[&#39;public_key&#39;] = pk_f.read()
                self.save()

        public_key_file = property(_get_public_key_file, _set_public_key_file)

#============================================================
def get_staff_list(active_only=False):
        if active_only:
                cmd = _SQL_get_staff_fields % &#39;is_active ORDER BY can_login DESC, short_alias ASC&#39;
        else:
                cmd = _SQL_get_staff_fields % &#39;TRUE ORDER BY can_login DESC, is_active DESC, short_alias ASC&#39;
        rows = gmPG2.run_ro_queries(queries = [{&#39;cmd&#39;: cmd}])
        staff_list = []
        for row in rows:
                obj_row = {
                        &#39;data&#39;: row,
                        &#39;pk_field&#39;: &#39;pk_staff&#39;
                }
                staff_list.append(cStaff(row=obj_row))
        return staff_list

#------------------------------------------------------------
def create_staff(conn=None, db_account=None, password=None, identity=None, short_alias=None):
        args = {
                &#39;pg_usr&#39;: db_account,
                &#39;pwd&#39;: password,
                &#39;person_id&#39;: identity,
                &#39;sig&#39;: short_alias
        }

        queries = [
                {&#39;cmd&#39;: &#39;SELECT gm.create_user(%(pg_usr)s, %(pwd)s)&#39;, &#39;args&#39;: args},
                {&#39;cmd&#39;: &#34;&#34;&#34;
                        INSERT INTO dem.staff
                                (fk_identity, db_user, short_alias)
                        VALUES (
                                %(person_id)s,
                                %(pg_usr)s,
                                %(sig)s
                        )&#34;&#34;&#34;,
                 &#39;args&#39;: args
                }
        ]

        created = False
        try:
                gmPG2.run_rw_queries(link_obj = conn, queries = queries, end_tx = True)
                created = True
        except gmPG2.dbapi.IntegrityError as e:
                if e.pgcode != gmPG2.PG_error_codes.UNIQUE_VIOLATION:
                        raise

        if created:
                return True, None

        msg = _(
                &#39;Cannot add GNUmed user.\n&#39;
                &#39;\n&#39;
                &#39;The database account [%s] is already listed as a\n&#39;
                &#39;GNUmed user. There can only be one GNUmed user\n&#39;
                &#39;for each database account.\n&#39;
        ) % db_account
        return False, msg

#------------------------------------------------------------
def delete_staff(conn=None, pk_staff=None):
        deleted = False
        queries = [{&#39;cmd&#39;: &#39;DELETE FROM dem.staff WHERE pk = %(pk)s&#39;, &#39;args&#39;: {&#39;pk&#39;: pk_staff}}]
        try:
                gmPG2.run_rw_queries(link_obj = conn, queries = queries, end_tx = True)
                deleted = True
        except gmPG2.dbapi.IntegrityError as e:
                if e.pgcode != gmPG2.PG_error_codes.FOREIGN_KEY_VIOLATION:              # 23503  foreign_key_violation
                        raise

        if deleted:
                return True, None

        deactivate_staff(conn = conn, pk_staff = pk_staff)
        msg = _(
                &#39;Cannot delete GNUmed staff member because the\n&#39;
                &#39;database still contains data linked to it.\n&#39;
                &#39;\n&#39;
                &#39;The account was deactivated instead.&#39;
        )
        return False, msg

#------------------------------------------------------------
def activate_staff(conn=None, pk_staff=None):
        # 1) activate staff entry
        staff = cStaff(aPK_obj = pk_staff)
        staff[&#39;is_active&#39;] = True
        staff.save_payload(conn=conn)                           # FIXME: error handling
        # 2) enable database account login
        gmPG2.run_rw_queries (
                link_obj = conn,
                # password does not matter because PG account must already exist
                queries = [{&#39;cmd&#39;: &#39;select gm.create_user(%s, %s)&#39;, &#39;args&#39;: [staff[&#39;db_user&#39;], &#39;flying wombat&#39;]}],
                end_tx = True
        )
        return True

#------------------------------------------------------------
def deactivate_staff(conn=None, pk_staff=None):

        # 1) inactivate staff entry
        staff = cStaff(aPK_obj = pk_staff)
        staff[&#39;is_active&#39;] = False
        staff.save_payload(conn = conn)                         # FIXME: error handling
        # 2) disable database account login
        gmPG2.run_rw_queries (
                link_obj = conn,
                queries = [{&#39;cmd&#39;: &#39;select gm.disable_user(%s)&#39;, &#39;args&#39;: [staff[&#39;db_user&#39;]]}],
                end_tx = True
        )
        return True

#------------------------------------------------------------
def get_public_keys_of_passphrase_trustees(as_files:bool=False) -&gt; list[str]:
        &#34;&#34;&#34;Retrieve the public keys of passphrase trustees.

        Returns:
                List of keys or list of keyfile names, depending on &#39;as_files&#39;.
        &#34;&#34;&#34;
        pub_keys = gmCfgDB.get4site (
                option = &#39;horstspace.export.public_keys_of_passphrase_trustees&#39;,
                default = []
        )
        if not as_files or not pub_keys:
                return pub_keys

        fnames = []
        for pub_key in pub_keys:
                pubk_fname = gmTools.get_unique_filename()
                with open(pubk_fname, mode = &#39;wt&#39;, encoding = &#39;utf8&#39;) as pubk_f:
                        pubk_f.write(pub_key)
                fnames.append(pubk_fname)
        return fnames

#============================================================
#============================================================
def set_current_provider_to_logged_on_user():
        gmCurrentProvider(provider = cStaff())

#============================================================
class gmCurrentProvider(gmBorg.cBorg):
        &#34;&#34;&#34;Staff member Borg to hold currently logged on provider.

        There may be many instances of this but they all share state.
        &#34;&#34;&#34;
        def __init__(self, provider=None):
                &#34;&#34;&#34;Change or get currently logged on provider.

                provider:
                * None: get copy of current instance
                * cStaff instance: change logged on provider (role)
                &#34;&#34;&#34;
                # make sure we do have a provider pointer
                try:
                        self.provider
                except AttributeError:
                        self.provider = gmNull.cNull()

                # user wants copy of currently logged on provider
                if provider is None:
                        return None

                # must be cStaff instance, then
                if not isinstance(provider, cStaff):
                        raise ValueError(&#39;cannot set logged on provider to [%s], must be either None or cStaff instance&#39; % str(provider))

                # first invocation
                if isinstance(self.provider, gmNull.cNull):
                        self.provider = provider
                        return None

                # same ID, no change needed
                if self.provider[&#39;pk_staff&#39;] == provider[&#39;pk_staff&#39;]:
                        return None

                # user wants different provider
                raise ValueError(&#39;provider change [%s] -&gt; [%s] not yet supported&#39; % (self.provider[&#39;pk_staff&#39;], provider[&#39;pk_staff&#39;]))

        #--------------------------------------------------------
        def get_staff(self):
                return self.provider

        #--------------------------------------------------------
        # __getitem__ handling
        #--------------------------------------------------------
        def __getitem__(self, aVar):
                &#34;&#34;&#34;Return any attribute if known how to retrieve it by proxy.
                &#34;&#34;&#34;
                return self.provider[aVar]

        #--------------------------------------------------------
        # __s/getattr__ handling
        #--------------------------------------------------------
        def __getattr__(self, attribute):
                if attribute == &#39;provider&#39;:                     # so we can __init__ ourselves
                        raise AttributeError
                if not isinstance(self.provider, gmNull.cNull):
                        return getattr(self.provider, attribute)
#               raise AttributeError

#============================================================
# main/testing
#============================================================
if __name__ == &#39;__main__&#39;:

        if len(sys.argv) == 1:
                sys.exit()

        if sys.argv[1] != &#39;test&#39;:
                sys.exit()

        from Gnumed.pycommon import gmI18N
        from Gnumed.pycommon import gmDateTime

        gmI18N.activate_locale()
        gmI18N.install_domain()
        gmDateTime.init()

        #--------------------------------------------------------
        def test_staff():
                print(get_staff_list())
                #staff = cStaff()
                #print(staff)
                #print(staff.inbox)
                #print(staff.inbox.messages)
                #print(staff.public_key_file)

        #--------------------------------------------------------
        def test_current_provider():
                staff = cStaff()
                provider = gmCurrentProvider(provider = staff)
                print(provider)
                #print(provider.inbox)
                #print(provider.inbox.messages)
                print(provider.database_language)
                #tmp = provider.database_language
                #provider.database_language = None
                #print(provider.database_language)
                #provider.database_language = tmp
                #print(provider.database_language)
                print(provider.public_key_file)

        #--------------------------------------------------------
        def test_set_pubkey():
                staff = cStaff(aPK_obj = 1)
                print(staff)
                staff.public_key_file = sys.argv[2]
                print(staff.public_key_file)

        #--------------------------------------------------------
        def test_trustee_pkeys():
                print(&#34;passphrase trustees&#39; public keys:&#34;)
                print(&#39;keys:&#39;, get_public_keys_of_passphrase_trustees(as_files = False))
                print(&#39;key files:&#39;, get_public_keys_of_passphrase_trustees(as_files = True))

        #--------------------------------------------------------
        gmPG2.request_login_params(setup_pool = True, force_tui = True)

        test_staff()
        #test_current_provider()
        #test_trustee_pkeys()
        #test_set_pubkey()

#============================================================</code></pre>
</details>
</section>
<section>
</section>
<section>
</section>
<section>
<h2 class="section-title" id="header-functions">Functions</h2>
<dl>
<dt id="Gnumed.business.gmStaff.activate_staff"><code class="name flex">
<span>def <span class="ident">activate_staff</span></span>(<span>conn=None, pk_staff=None)</span>
</code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def activate_staff(conn=None, pk_staff=None):
        # 1) activate staff entry
        staff = cStaff(aPK_obj = pk_staff)
        staff[&#39;is_active&#39;] = True
        staff.save_payload(conn=conn)                           # FIXME: error handling
        # 2) enable database account login
        gmPG2.run_rw_queries (
                link_obj = conn,
                # password does not matter because PG account must already exist
                queries = [{&#39;cmd&#39;: &#39;select gm.create_user(%s, %s)&#39;, &#39;args&#39;: [staff[&#39;db_user&#39;], &#39;flying wombat&#39;]}],
                end_tx = True
        )
        return True</code></pre>
</details>
</dd>
<dt id="Gnumed.business.gmStaff.create_staff"><code class="name flex">
<span>def <span class="ident">create_staff</span></span>(<span>conn=None, db_account=None, password=None, identity=None, short_alias=None)</span>
</code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def create_staff(conn=None, db_account=None, password=None, identity=None, short_alias=None):
        args = {
                &#39;pg_usr&#39;: db_account,
                &#39;pwd&#39;: password,
                &#39;person_id&#39;: identity,
                &#39;sig&#39;: short_alias
        }

        queries = [
                {&#39;cmd&#39;: &#39;SELECT gm.create_user(%(pg_usr)s, %(pwd)s)&#39;, &#39;args&#39;: args},
                {&#39;cmd&#39;: &#34;&#34;&#34;
                        INSERT INTO dem.staff
                                (fk_identity, db_user, short_alias)
                        VALUES (
                                %(person_id)s,
                                %(pg_usr)s,
                                %(sig)s
                        )&#34;&#34;&#34;,
                 &#39;args&#39;: args
                }
        ]

        created = False
        try:
                gmPG2.run_rw_queries(link_obj = conn, queries = queries, end_tx = True)
                created = True
        except gmPG2.dbapi.IntegrityError as e:
                if e.pgcode != gmPG2.PG_error_codes.UNIQUE_VIOLATION:
                        raise

        if created:
                return True, None

        msg = _(
                &#39;Cannot add GNUmed user.\n&#39;
                &#39;\n&#39;
                &#39;The database account [%s] is already listed as a\n&#39;
                &#39;GNUmed user. There can only be one GNUmed user\n&#39;
                &#39;for each database account.\n&#39;
        ) % db_account
        return False, msg</code></pre>
</details>
</dd>
<dt id="Gnumed.business.gmStaff.deactivate_staff"><code class="name flex">
<span>def <span class="ident">deactivate_staff</span></span>(<span>conn=None, pk_staff=None)</span>
</code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def deactivate_staff(conn=None, pk_staff=None):

        # 1) inactivate staff entry
        staff = cStaff(aPK_obj = pk_staff)
        staff[&#39;is_active&#39;] = False
        staff.save_payload(conn = conn)                         # FIXME: error handling
        # 2) disable database account login
        gmPG2.run_rw_queries (
                link_obj = conn,
                queries = [{&#39;cmd&#39;: &#39;select gm.disable_user(%s)&#39;, &#39;args&#39;: [staff[&#39;db_user&#39;]]}],
                end_tx = True
        )
        return True</code></pre>
</details>
</dd>
<dt id="Gnumed.business.gmStaff.delete_staff"><code class="name flex">
<span>def <span class="ident">delete_staff</span></span>(<span>conn=None, pk_staff=None)</span>
</code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def delete_staff(conn=None, pk_staff=None):
        deleted = False
        queries = [{&#39;cmd&#39;: &#39;DELETE FROM dem.staff WHERE pk = %(pk)s&#39;, &#39;args&#39;: {&#39;pk&#39;: pk_staff}}]
        try:
                gmPG2.run_rw_queries(link_obj = conn, queries = queries, end_tx = True)
                deleted = True
        except gmPG2.dbapi.IntegrityError as e:
                if e.pgcode != gmPG2.PG_error_codes.FOREIGN_KEY_VIOLATION:              # 23503  foreign_key_violation
                        raise

        if deleted:
                return True, None

        deactivate_staff(conn = conn, pk_staff = pk_staff)
        msg = _(
                &#39;Cannot delete GNUmed staff member because the\n&#39;
                &#39;database still contains data linked to it.\n&#39;
                &#39;\n&#39;
                &#39;The account was deactivated instead.&#39;
        )
        return False, msg</code></pre>
</details>
</dd>
<dt id="Gnumed.business.gmStaff.get_public_keys_of_passphrase_trustees"><code class="name flex">
<span>def <span class="ident">get_public_keys_of_passphrase_trustees</span></span>(<span>as_files: bool = False) ‑> list[str]</span>
</code></dt>
<dd>
<div class="desc"><p>Retrieve the public keys of passphrase trustees.</p>
<h2 id="returns">Returns</h2>
<p>List of keys or list of keyfile names, depending on 'as_files'.</p></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def get_public_keys_of_passphrase_trustees(as_files:bool=False) -&gt; list[str]:
        &#34;&#34;&#34;Retrieve the public keys of passphrase trustees.

        Returns:
                List of keys or list of keyfile names, depending on &#39;as_files&#39;.
        &#34;&#34;&#34;
        pub_keys = gmCfgDB.get4site (
                option = &#39;horstspace.export.public_keys_of_passphrase_trustees&#39;,
                default = []
        )
        if not as_files or not pub_keys:
                return pub_keys

        fnames = []
        for pub_key in pub_keys:
                pubk_fname = gmTools.get_unique_filename()
                with open(pubk_fname, mode = &#39;wt&#39;, encoding = &#39;utf8&#39;) as pubk_f:
                        pubk_f.write(pub_key)
                fnames.append(pubk_fname)
        return fnames</code></pre>
</details>
</dd>
<dt id="Gnumed.business.gmStaff.get_staff_list"><code class="name flex">
<span>def <span class="ident">get_staff_list</span></span>(<span>active_only=False)</span>
</code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def get_staff_list(active_only=False):
        if active_only:
                cmd = _SQL_get_staff_fields % &#39;is_active ORDER BY can_login DESC, short_alias ASC&#39;
        else:
                cmd = _SQL_get_staff_fields % &#39;TRUE ORDER BY can_login DESC, is_active DESC, short_alias ASC&#39;
        rows = gmPG2.run_ro_queries(queries = [{&#39;cmd&#39;: cmd}])
        staff_list = []
        for row in rows:
                obj_row = {
                        &#39;data&#39;: row,
                        &#39;pk_field&#39;: &#39;pk_staff&#39;
                }
                staff_list.append(cStaff(row=obj_row))
        return staff_list</code></pre>
</details>
</dd>
<dt id="Gnumed.business.gmStaff.set_current_provider_to_logged_on_user"><code class="name flex">
<span>def <span class="ident">set_current_provider_to_logged_on_user</span></span>(<span>)</span>
</code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def set_current_provider_to_logged_on_user():
        gmCurrentProvider(provider = cStaff())</code></pre>
</details>
</dd>
</dl>
</section>
<section>
<h2 class="section-title" id="header-classes">Classes</h2>
<dl>
<dt id="Gnumed.business.gmStaff.cStaff"><code class="flex name class">
<span>class <span class="ident">cStaff</span></span>
<span>(</span><span>aPK_obj=None, row=None)</span>
</code></dt>
<dd>
<div class="desc"><p>Represents business objects in the database.</p>
<h2 id="rules">Rules</h2>
<ul>
<li>instances ARE ASSUMED TO EXIST in the database</li>
<li>PK construction (aPK_obj): DOES verify its existence on instantiation (fetching data fails)</li>
<li>Row construction (row): allowed by using a dict of pairs of field name: field value (PERFORMANCE improvement)</li>
<li>does NOT verify FK target existence</li>
<li>does NOT create new entries in the database</li>
<li>does NOT lazy-fetch fields on access</li>
</ul>
<p>Class scope SQL commands and variables:</p>
<p>_cmd_fetch_payload:</p>
<ul>
<li>must return exactly one row</li>
<li>WHERE clause argument values are expected in
self.pk_obj (taken from <strong>init</strong>(aPK_obj))</li>
<li>must return xmin of all rows that _cmds_store_payload
will be updating, so views must support the xmin columns
of their underlying tables</li>
</ul>
<p>_cmds_store_payload:</p>
<ul>
<li>one or multiple "update &hellip; set &hellip; where xmin_<em> = &hellip; and pk</em> = &hellip;"
statements which actually update the database from the data in self._payload,</li>
<li>the last query must refetch at least the XMIN values needed to detect
concurrent updates, their field names had better be the same as
in _cmd_fetch_payload,</li>
<li>the last query CAN return other fields which is particularly
useful when those other fields are computed in the backend
and may thus change upon save but will not have been set by
the client code explicitly - this is only really of concern
if the saved subclass is to be reused after saving rather
than re-instantiated</li>
<li>when subclasses tend to live a while after save_payload() was
called and they support computed fields (say, _(some_column)
you need to return <em>all</em> columns (see cEncounter)</li>
</ul>
<p>_updatable_fields:</p>
<ul>
<li>a list of fields available for update via object['field']</li>
</ul>
<p>Call <strong>init</strong> from child classes like so:</p>
<pre><code>    super().__init__(aPK_obj = aPK_obj, row = row, link_obj = link_obj)
</code></pre>
<h2 id="args">Args</h2>
<dl>
<dt><strong><code>aPK_obj</code></strong></dt>
<dd>retrieve data from backend</dd>
</dl>
<ul>
<li>an scalar value
the ._cmd_fetch_payload WHERE condition must be a simple column: "&hellip; WHERE pk_col = %s"</li>
<li>a dictionary of values
the ._cmd_fetch_payload WHERE condition must consume the
dictionary and produce a unique row</li>
</ul>
<dl>
<dt><strong><code>row</code></strong></dt>
<dd>must hold the fields</dd>
</dl>
<ul>
<li>data: list of column values for the row selected by ._cmd_fetch_payload (as returned by cursor.fetchone() in the DB-API)</li>
<li>pk_field: the name of the primary key column
OR</li>
<li>pk_obj: a dictionary suitable for being passed to cursor.execute
and holding the primary key values, used for composite PKs</li>
<li>for example:<pre><code>row = {
        'data': rows[0],
        'pk_field': 'pk_XXX (the PK column name)',
        'pk_obj': {'pk_col1': pk_col1_val, 'pk_col2': pk_col2_val}
}

rows = gmPG2.run_ro_queries(queries = [{'cmd': cmd, 'args': args}])
objects = [ cChildClass(row = {'data': r, 'pk_field': 'the PK column name'}) for r in rows ]
</code></pre>
</li>
</ul></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">class cStaff(gmBusinessDBObject.cBusinessDBObject):
        _cmd_fetch_payload = _SQL_get_staff_fields % &#34;pk_staff = %s&#34;
        _cmds_store_payload = [
                &#34;&#34;&#34;UPDATE dem.staff SET
                                short_alias = %(short_alias)s,
                                comment = gm.nullify_empty_string(%(comment)s),
                                is_active = %(is_active)s,
                                db_user = %(db_user)s,
                                public_key = %(public_key)s
                        WHERE
                                pk = %(pk_staff)s
                                        AND
                                xmin = %(xmin_staff)s
                        RETURNING
                                xmin AS xmin_staff&#34;&#34;&#34;
        ]
        _updatable_fields = [&#39;short_alias&#39;, &#39;comment&#39;, &#39;is_active&#39;, &#39;db_user&#39;, &#39;public_key&#39;]

        #--------------------------------------------------------
        def __init__(self, aPK_obj=None, row=None):
                # by default get staff corresponding to CURRENT_USER
                if (aPK_obj is None) and (row is None):
                        cmd = _SQL_get_staff_fields % &#34;db_user = CURRENT_USER&#34;
                        try:
                                rows = gmPG2.run_ro_queries(queries = [{&#39;cmd&#39;: cmd}])
                        except Exception:
                                _log.exception(&#39;cannot instantiate staff instance&#39;)
                                gmLog2.log_stack_trace()
                                raise ValueError(&#39;cannot instantiate staff instance for database account CURRENT_USER&#39;)
                        if len(rows) == 0:
                                raise ValueError(&#39;no staff record for database account CURRENT_USER&#39;)
                        row = {
                                &#39;pk_field&#39;: &#39;pk_staff&#39;,
                                &#39;data&#39;: rows[0]
                        }
                        gmBusinessDBObject.cBusinessDBObject.__init__(self, row = row)
                else:
                        gmBusinessDBObject.cBusinessDBObject.__init__(self, aPK_obj = aPK_obj, row = row)

                # are we SELF ?
                self.__is_current_user = (gmPG2.get_current_user() == self._payload[&#39;db_user&#39;])

                self.__inbox = None

        #--------------------------------------------------------
        def __setitem__(self, attribute, value):
                if attribute == &#39;db_user&#39;:
                        if self.__is_current_user:
                                _log.debug(&#39;will not modify database account association of CURRENT_USER staff member&#39;)
                                return

                gmBusinessDBObject.cBusinessDBObject.__setitem__(self, attribute, value)

        #--------------------------------------------------------
        def _get_db_lang(self):
                rows = gmPG2.run_ro_queries (
                        queries = [{
                                &#39;cmd&#39;: &#39;select i18n.get_curr_lang(%(usr)s)&#39;,
                                &#39;args&#39;: {&#39;usr&#39;: self._payload[&#39;db_user&#39;]}
                        }]
                )
                return rows[0][0]

        def _set_db_lang(self, language):
                if not gmPG2.set_user_language(language = language):
                        raise ValueError (
                                &#39;Cannot set database language to [%s] for user [%s].&#39; % (language, self._payload[&#39;db_user&#39;])
                        )
                return

        database_language = property(_get_db_lang, _set_db_lang)

        #--------------------------------------------------------
        def _get_inbox(self):
                if self.__inbox is None:
                        from Gnumed.business import gmProviderInbox
                        self.__inbox = gmProviderInbox.cProviderInbox(provider_id = self._payload[&#39;pk_staff&#39;])
                return self.__inbox

        inbox = property(_get_inbox)

        #--------------------------------------------------------
        def _get_identity(self):
                from Gnumed.business.gmPerson import cPerson
                return cPerson(self._payload[&#39;pk_identity&#39;])

        identity = property(_get_identity)

        #--------------------------------------------------------
        def set_role(self, conn=None, role=None):
                if role.strip() == self._payload[&#39;role&#39;]:
                        return True

                cmd = &#39;SELECT gm.add_user_to_permission_group(%(usr)s::name, %(grp)s::name)&#39;
                args = {
                        &#39;usr&#39;: self._payload[&#39;db_user&#39;],
                        &#39;grp&#39;: _map_gm_role2pg_group[role.strip()]
                }
                rows = gmPG2.run_rw_queries (
                        link_obj = conn,
                        queries = [{&#39;cmd&#39;: cmd, &#39;args&#39;: args}],
                        return_data = True,
                        end_tx = True
                )
                if not rows[0][0]:
                        return False

                self.refetch_payload()
                return True

        role = property(lambda x:x, set_role)

        #--------------------------------------------------------
        def _get_public_key_file(self):
                if not self._payload[&#39;public_key&#39;]:
                        return None

                pk_fname = gmTools.get_unique_filename()
                with open(pk_fname, mode = &#39;wt&#39;, encoding = &#39;utf8&#39;) as pk_f:
                        pk_f.write(self._payload[&#39;public_key&#39;])
                return pk_fname

        def _set_public_key_file(self, pk_fname):
                with open(pk_fname, mode = &#39;r&#39;, encoding = &#39;utf8&#39;) as pk_f:
                        self[&#39;public_key&#39;] = pk_f.read()
                self.save()

        public_key_file = property(_get_public_key_file, _set_public_key_file)</code></pre>
</details>
<h3>Ancestors</h3>
<ul class="hlist">
<li><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject">cBusinessDBObject</a></li>
</ul>
<h3>Instance variables</h3>
<dl>
<dt id="Gnumed.business.gmStaff.cStaff.database_language"><code class="name">var <span class="ident">database_language</span></code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def _get_db_lang(self):
        rows = gmPG2.run_ro_queries (
                queries = [{
                        &#39;cmd&#39;: &#39;select i18n.get_curr_lang(%(usr)s)&#39;,
                        &#39;args&#39;: {&#39;usr&#39;: self._payload[&#39;db_user&#39;]}
                }]
        )
        return rows[0][0]</code></pre>
</details>
</dd>
<dt id="Gnumed.business.gmStaff.cStaff.identity"><code class="name">var <span class="ident">identity</span></code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def _get_identity(self):
        from Gnumed.business.gmPerson import cPerson
        return cPerson(self._payload[&#39;pk_identity&#39;])</code></pre>
</details>
</dd>
<dt id="Gnumed.business.gmStaff.cStaff.inbox"><code class="name">var <span class="ident">inbox</span></code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def _get_inbox(self):
        if self.__inbox is None:
                from Gnumed.business import gmProviderInbox
                self.__inbox = gmProviderInbox.cProviderInbox(provider_id = self._payload[&#39;pk_staff&#39;])
        return self.__inbox</code></pre>
</details>
</dd>
<dt id="Gnumed.business.gmStaff.cStaff.public_key_file"><code class="name">var <span class="ident">public_key_file</span></code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def _get_public_key_file(self):
        if not self._payload[&#39;public_key&#39;]:
                return None

        pk_fname = gmTools.get_unique_filename()
        with open(pk_fname, mode = &#39;wt&#39;, encoding = &#39;utf8&#39;) as pk_f:
                pk_f.write(self._payload[&#39;public_key&#39;])
        return pk_fname</code></pre>
</details>
</dd>
<dt id="Gnumed.business.gmStaff.cStaff.role"><code class="name">var <span class="ident">role</span></code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">role = property(lambda x:x, set_role)</code></pre>
</details>
</dd>
</dl>
<h3>Methods</h3>
<dl>
<dt id="Gnumed.business.gmStaff.cStaff.set_role"><code class="name flex">
<span>def <span class="ident">set_role</span></span>(<span>self, conn=None, role=None)</span>
</code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def set_role(self, conn=None, role=None):
        if role.strip() == self._payload[&#39;role&#39;]:
                return True

        cmd = &#39;SELECT gm.add_user_to_permission_group(%(usr)s::name, %(grp)s::name)&#39;
        args = {
                &#39;usr&#39;: self._payload[&#39;db_user&#39;],
                &#39;grp&#39;: _map_gm_role2pg_group[role.strip()]
        }
        rows = gmPG2.run_rw_queries (
                link_obj = conn,
                queries = [{&#39;cmd&#39;: cmd, &#39;args&#39;: args}],
                return_data = True,
                end_tx = True
        )
        if not rows[0][0]:
                return False

        self.refetch_payload()
        return True</code></pre>
</details>
</dd>
</dl>
<h3>Inherited members</h3>
<ul class="hlist">
<li><code><b><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject">cBusinessDBObject</a></b></code>:
<ul class="hlist">
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.fields_as_dict" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.fields_as_dict">fields_as_dict</a></code></li>
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.format" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.format">format</a></code></li>
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.get_fields" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.get_fields">get_fields</a></code></li>
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.get_patient" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.get_patient">get_patient</a></code></li>
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.get_updatable_fields" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.get_updatable_fields">get_updatable_fields</a></code></li>
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.is_modified" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.is_modified">is_modified</a></code></li>
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.keys" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.keys">keys</a></code></li>
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.patient_pk" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.patient_pk">patient_pk</a></code></li>
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.refetch_payload" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.refetch_payload">refetch_payload</a></code></li>
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.same_payload" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.same_payload">same_payload</a></code></li>
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.save" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.save">save</a></code></li>
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.save_payload" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.save_payload">save_payload</a></code></li>
<li><code><a title="Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.staff_id" href="gmBusinessDBObject.html#Gnumed.pycommon.gmBusinessDBObject.cBusinessDBObject.staff_id">staff_id</a></code></li>
</ul>
</li>
</ul>
</dd>
<dt id="Gnumed.business.gmStaff.gmCurrentProvider"><code class="flex name class">
<span>class <span class="ident">gmCurrentProvider</span></span>
<span>(</span><span>provider=None)</span>
</code></dt>
<dd>
<div class="desc"><p>Staff member Borg to hold currently logged on provider.</p>
<p>There may be many instances of this but they all share state.</p>
<p>Change or get currently logged on provider.</p>
<p>provider:
* None: get copy of current instance
* cStaff instance: change logged on provider (role)</p></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">class gmCurrentProvider(gmBorg.cBorg):
        &#34;&#34;&#34;Staff member Borg to hold currently logged on provider.

        There may be many instances of this but they all share state.
        &#34;&#34;&#34;
        def __init__(self, provider=None):
                &#34;&#34;&#34;Change or get currently logged on provider.

                provider:
                * None: get copy of current instance
                * cStaff instance: change logged on provider (role)
                &#34;&#34;&#34;
                # make sure we do have a provider pointer
                try:
                        self.provider
                except AttributeError:
                        self.provider = gmNull.cNull()

                # user wants copy of currently logged on provider
                if provider is None:
                        return None

                # must be cStaff instance, then
                if not isinstance(provider, cStaff):
                        raise ValueError(&#39;cannot set logged on provider to [%s], must be either None or cStaff instance&#39; % str(provider))

                # first invocation
                if isinstance(self.provider, gmNull.cNull):
                        self.provider = provider
                        return None

                # same ID, no change needed
                if self.provider[&#39;pk_staff&#39;] == provider[&#39;pk_staff&#39;]:
                        return None

                # user wants different provider
                raise ValueError(&#39;provider change [%s] -&gt; [%s] not yet supported&#39; % (self.provider[&#39;pk_staff&#39;], provider[&#39;pk_staff&#39;]))

        #--------------------------------------------------------
        def get_staff(self):
                return self.provider

        #--------------------------------------------------------
        # __getitem__ handling
        #--------------------------------------------------------
        def __getitem__(self, aVar):
                &#34;&#34;&#34;Return any attribute if known how to retrieve it by proxy.
                &#34;&#34;&#34;
                return self.provider[aVar]

        #--------------------------------------------------------
        # __s/getattr__ handling
        #--------------------------------------------------------
        def __getattr__(self, attribute):
                if attribute == &#39;provider&#39;:                     # so we can __init__ ourselves
                        raise AttributeError
                if not isinstance(self.provider, gmNull.cNull):
                        return getattr(self.provider, attribute)</code></pre>
</details>
<h3>Ancestors</h3>
<ul class="hlist">
<li><a title="Gnumed.pycommon.gmBorg.cBorg" href="gmBorg.html#Gnumed.pycommon.gmBorg.cBorg">cBorg</a></li>
</ul>
<h3>Methods</h3>
<dl>
<dt id="Gnumed.business.gmStaff.gmCurrentProvider.get_staff"><code class="name flex">
<span>def <span class="ident">get_staff</span></span>(<span>self)</span>
</code></dt>
<dd>
<div class="desc"></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def get_staff(self):
        return self.provider</code></pre>
</details>
</dd>
</dl>
</dd>
</dl>
</section>
</article>
<nav id="sidebar">
<h1>Index</h1>
<div class="toc">
<ul></ul>
</div>
<ul id="index">
<li><h3>Super-module</h3>
<ul>
<li><code><a title="Gnumed.business" href="http://www.gnumed.de/downloads/docs/api/business/index.html">Gnumed.business</a></code></li>
</ul>
</li>
<li><h3><a href="gmStaff.html#header-functions">Functions</a></h3>
<ul class="">
<li><code><a title="Gnumed.business.gmStaff.activate_staff" href="gmStaff.html#Gnumed.business.gmStaff.activate_staff">activate_staff</a></code></li>
<li><code><a title="Gnumed.business.gmStaff.create_staff" href="gmStaff.html#Gnumed.business.gmStaff.create_staff">create_staff</a></code></li>
<li><code><a title="Gnumed.business.gmStaff.deactivate_staff" href="gmStaff.html#Gnumed.business.gmStaff.deactivate_staff">deactivate_staff</a></code></li>
<li><code><a title="Gnumed.business.gmStaff.delete_staff" href="gmStaff.html#Gnumed.business.gmStaff.delete_staff">delete_staff</a></code></li>
<li><code><a title="Gnumed.business.gmStaff.get_public_keys_of_passphrase_trustees" href="gmStaff.html#Gnumed.business.gmStaff.get_public_keys_of_passphrase_trustees">get_public_keys_of_passphrase_trustees</a></code></li>
<li><code><a title="Gnumed.business.gmStaff.get_staff_list" href="gmStaff.html#Gnumed.business.gmStaff.get_staff_list">get_staff_list</a></code></li>
<li><code><a title="Gnumed.business.gmStaff.set_current_provider_to_logged_on_user" href="gmStaff.html#Gnumed.business.gmStaff.set_current_provider_to_logged_on_user">set_current_provider_to_logged_on_user</a></code></li>
</ul>
</li>
<li><h3><a href="gmStaff.html#header-classes">Classes</a></h3>
<ul>
<li>
<h4><code><a title="Gnumed.business.gmStaff.cStaff" href="gmStaff.html#Gnumed.business.gmStaff.cStaff">cStaff</a></code></h4>
<ul class="two-column">
<li><code><a title="Gnumed.business.gmStaff.cStaff.database_language" href="gmStaff.html#Gnumed.business.gmStaff.cStaff.database_language">database_language</a></code></li>
<li><code><a title="Gnumed.business.gmStaff.cStaff.identity" href="gmStaff.html#Gnumed.business.gmStaff.cStaff.identity">identity</a></code></li>
<li><code><a title="Gnumed.business.gmStaff.cStaff.inbox" href="gmStaff.html#Gnumed.business.gmStaff.cStaff.inbox">inbox</a></code></li>
<li><code><a title="Gnumed.business.gmStaff.cStaff.public_key_file" href="gmStaff.html#Gnumed.business.gmStaff.cStaff.public_key_file">public_key_file</a></code></li>
<li><code><a title="Gnumed.business.gmStaff.cStaff.role" href="gmStaff.html#Gnumed.business.gmStaff.cStaff.role">role</a></code></li>
<li><code><a title="Gnumed.business.gmStaff.cStaff.set_role" href="gmStaff.html#Gnumed.business.gmStaff.cStaff.set_role">set_role</a></code></li>
</ul>
</li>
<li>
<h4><code><a title="Gnumed.business.gmStaff.gmCurrentProvider" href="gmStaff.html#Gnumed.business.gmStaff.gmCurrentProvider">gmCurrentProvider</a></code></h4>
<ul class="">
<li><code><a title="Gnumed.business.gmStaff.gmCurrentProvider.get_staff" href="gmStaff.html#Gnumed.business.gmStaff.gmCurrentProvider.get_staff">get_staff</a></code></li>
</ul>
</li>
</ul>
</li>
</ul>
</nav>
</main>
<footer id="footer">
<p>Generated by <a href="https://pdoc3.github.io/pdoc" title="pdoc: Python API documentation generator"><cite>pdoc</cite> 0.10.0</a>.</p>
</footer>
</body>
</html>