Newcomers (tested tour)

This is a tested tour about the lino_welfare.modlib.newcomers module.

Side note: Code snippets (lines starting with >>>) in this document get tested as part of our development workflow. The following initialization snippet tells you which demo project is being used in this document.

>>> from lino import startup
>>> startup('lino_welfare.projects.gerd.settings.doctests')
>>> from lino.api.doctest import *

Newcomers configuration

The newcomer module adds three configuration models: Broker, Faculty and Competence.

The corresponding tables are populated with the following data:

>>> rt.show('newcomers.Brokers')
... 
============
 name
------------
 Other PCSW
 Police
============
>>> rt.show('newcomers.Faculties')
... 
================================ =========
 Bezeichnung                      Aufwand
-------------------------------- ---------
 Ausländerbeihilfe                4
 DSBE                             5
 Eingliederungseinkommen (EiEi)   10
 Finanzielle Begleitung           6
 Laufende Beihilfe                2
 **Total (5 Zeilen)**             **27**
================================ =========

Every newcomer agent gets attributed a set of Competences:

>>> rt.show('newcomers.Competences')
... 
==== ================= ================================ =========
 ID   Benutzer          Fachbereich                      Aufwand
---- ----------------- -------------------------------- ---------
 1    Alicia Allmanns   Eingliederungseinkommen (EiEi)   10
 2    Hubert Huppertz   DSBE                             5
 3    Mélanie Mélard    Ausländerbeihilfe                4
 4    Alicia Allmanns   Finanzielle Begleitung           6
 5    Hubert Huppertz   Laufende Beihilfe                2
 6    Mélanie Mélard    Eingliederungseinkommen (EiEi)   10
 7    Alicia Allmanns   DSBE                             5
                                                         **42**
==== ================= ================================ =========

The newcomers table

>>> rt.show('newcomers.NewClients')
... 
==================================== =========== ============ ================================ =============== ======= ======================================= =========== ========================== =========
 Name                                 Zustand     Vermittler   Fachbereich                      NR-Nummer       Handy   Adresse                                 Alter       E-Mail-Adresse             Telefon
------------------------------------ ----------- ------------ -------------------------------- --------------- ------- --------------------------------------- ----------- -------------------------- ---------
 BASTIAENSEN Laurent (117)            Neuantrag                Finanzielle Begleitung           971207 001-67           Am Berg, 4700 Eupen                     16 Jahre    laurent@example.com
 BRAUN Bruno (259)                    Neuantrag                                                                                                                 40 Jahre
 DEMEULENAERE Dorothée (122)          Neuantrag                Ausländerbeihilfe                                        Auf'm Rain, 4700 Eupen                  unbekannt
 DERICUM Daniel (121)                 Neuantrag                DSBE                             950221 001-20           August-Thonnar-Str., 4700 Eupen         19 Jahre    daniel@example.com
 EIERSCHAL Emil (175)                 Neuantrag                Laufende Beihilfe                930412 001-68           Aachen, Deutschland                     21 Jahre    emil@example.com
 EMONTSPOOL Erwin (151)               Neuantrag                DSBE                             910602 001-49           4730 Raeren                             22 Jahre    erwin@example.com
 ERNST Berta (125)                    Neuantrag                Laufende Beihilfe                900627 002-53           Bergkapellstraße, 4700 Eupen            23 Jahre    berta@example.com
 FRISCH Paul (240)                    Neuantrag                                                                                                                 46 Jahre
 GERNEGROSS Germaine (131)            Neuantrag                Laufende Beihilfe                880816 002-64           Buchenweg, 4700 Eupen                   25 Jahre    germaine@example.com
 HILGERS Henri (134)                  Neuantrag                Ausländerbeihilfe                870911 001-07           Euregiostraße, 4700 Eupen               26 Jahre    henri@example.com
 INGELS Irene (135)                   Neuantrag                Finanzielle Begleitung           861006 002-45           Feldstraße, 4700 Eupen                  27 Jahre    irene@example.com
 JANSEN Jérémy (136)                  Neuantrag                Laufende Beihilfe                851031 001-51           Gewerbestraße, 4700 Eupen               28 Jahre
 KASENNOVA Tatjana (213)              Neuantrag                DSBE                             830115 002-37           4701 Kettenis                           31 Jahre
 LAHM Lisa (176)                      Neuantrag                Eingliederungseinkommen (EiEi)   820209 002-09           Aachen, Deutschland                     32 Jahre    lisa@example.com
 LASCHET Laura (143)                  Neuantrag                Eingliederungseinkommen (EiEi)   810306 002-85           Habsburgerweg, 4700 Eupen               33 Jahre    laura@example.com
 MARTELAER Mark (172)                 Neuantrag                DSBE                             790426 001-33           Amsterdam, Königreich der Niederlande   35 Jahre    mark@example.com
 MEIER Marie-Louise (149)             Neuantrag                Laufende Beihilfe                780521 002-71           Hisselsgasse, 4700 Eupen                36 Jahre    marie-louise@example.com
 RADERMACHER Berta (154)              Neuantrag                Laufende Beihilfe                770615 002-43           4730 Raeren                             36 Jahre    berta@example.com
 RADERMACHER Daniela (156)            Neuantrag                DSBE                             760710 002-82           4730 Raeren                             37 Jahre    daniela@example.com
 RADERMACHER Inge (162)               Neuantrag                DSBE                             730924 002-01           4730 Raeren                             40 Jahre    inge@example.com
 VANDENMEULENBOS Marie-Louise (174)   Neuantrag                Finanzielle Begleitung           721019 002-40           Amsterdam, Königreich der Niederlande   41 Jahre    marie-louise@example.com
 DI RUPO Didier (164)                 Neuantrag                Ausländerbeihilfe                711114 001-80           4730 Raeren                             42 Jahre    didier@example.com
==================================== =========== ============ ================================ =============== ======= ======================================= =========== ========================== =========

Assigning a coach to a newcomer

Let’s look at the AvailableCoachesByClient table.

>>> obj = pcsw.Client.objects.get(pk=117)
>>> print(obj)
BASTIAENSEN Laurent (117)
>>> rt.show(newcomers.AvailableCoachesByClient, master_instance=obj)
================= ========== ================= =============== =================== =========== =============== ===================
 Name              Workflow   Komplette Akten   Neue Klienten   Quote Erstempfang   Belastung   Mehrbelastung   Mehrbelastung (%)
----------------- ---------- ----------------- --------------- ------------------- ----------- --------------- -------------------
 Alicia Allmanns              **12**            **1**           100                 6,          6,              100,00
================= ========== ================= =============== =================== =========== =============== ===================
>>> url = '/api/newcomers/AvailableCoachesByClient?fmt=json&mt=58&mk=117'
>>> test_client.force_login(rt.login('rolf').user)
>>> res = test_client.get(url, REMOTE_USER='rolf')
>>> res.status_code
200
>>> d = json.loads(res.content)

The value in column “Arbeitsablauf” of the first data row in the above table looks empty, but when rendered on screen it contains a call to the AssignCoach action:

>>> html = d['rows'][0][1]
>>> soup = BeautifulSoup(html, 'lxml')
>>> print(soup.get_text(' ', strip=True))
... 
Zuweisen
>>> links = soup.find_all('a')
>>> len(links)
1

The text of this action call is “Zuweisen”:

>>> print(links[0].string)
Zuweisen

And the status of this call (the second argument to Lino.WindowAction.run()) must include the record_id of the user being assigned (6 in this case):

>>> print(links[0].get('href'))
... 
javascript:Lino.newcomers.AvailableCoachesByClient.assign_coach.run(null,{
"base_params": { "mk": 117, "mt": ... }, "field_values": { "notify_body":
"[client 117] wird ab jetzt begleitet f\u00fcr Finanzielle Begleitung durch
Alicia Allmanns.", "notify_silent": false, "notify_subject": "BASTIAENSEN
Laurent (117) zugewiesen zu Alicia Allmanns" }, "param_values": { "for_client":
"BASTIAENSEN Laurent (117)", "for_clientHidden": 117, "since": "22.04.2014" },
"record_id": 6 })

This call is generated by dd.Model.workflow_buttons, which calls ar.action_button. Which is where we had a bug on 2015-05-15.

User roles

The newcomers module distinguishes between newcomer agents and newcomer operators.

  • The fields broker, faculty and refusal_reason are readonly for all except newcomer agents/operators.

  • A NewcomersAgent is a SocialAgent who can also manage newcomers.

lino_welfare.modlib.newcomers.models.NewClients

lino_xl.lib.contacts.roles.ContactsUser lino.modlib.office.roles.OfficeOperator

  • The AvailableCoaches table shows only users who are SocialAgent