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
NewcomersAgentis aSocialAgentwho can also manage newcomers.
lino_welfare.modlib.newcomers.models.NewClients
lino_xl.lib.contacts.roles.ContactsUser
lino.modlib.office.roles.OfficeOperator
The
AvailableCoachestable shows only users who areSocialAgent