People.php 64.7 KB
Newer Older
1
2
3
4
5
6
<?php

namespace UnicaenLdap\Entity\Base;

use DateTime;
use UnicaenLdap\Entity\Entity;
7
8
use UnicaenLdap\Entity\People as PeopleEntity;
use UnicaenLdap\Entity\Structure as StructureEntity;
9
use UnicaenLdap\Exception;
10
use Zend\Ldap\Attribute;
11
use Zend\Ldap\Dn;
12
13
14
15
16
use Zend\Ldap\Exception\LdapException;

/**
 * Classe mère des entités de la branche "people" de l'annuaire LDAP.
 *
17
 * @author David Surville <david.surville@unicaen.fr>
18
19
20
 */
class People extends Entity
{
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
    /**
     * Constantes pour les champs eduPersonAffiliation et eduPersonPrimaryAffiliation
     */
    const STATUS_AFFILIATE = 'affiliate';
    const STATUS_ALUM = 'alum';
    const STATUS_EMERITUS = 'emeritus';
    const STATUS_EMPLOYEE = 'employee';
    const STATUS_FACULTY = 'faculty';
    const STATUS_MEMBER = 'member';
    const STATUS_REGISTERED_READER = 'registered-reader';
    const STATUS_RESEARCHER = 'researcher';
    const STATUS_RETIRED = 'retired';
    const STATUS_STAFF = 'staff';
    const STATUS_STUDENT = 'student';
    const STATUS_TEACHER = 'teacher';

    /**
     * @var string
     */
40
41
42
    protected $type = 'People';

    /**
43
     * Liste des classes d'objet nécessaires à la création d'une entité "People"
44
45
46
47
48
49
50
51
52
53
54
55
     * Il est nécessaire d'ajouter la classe 'ucbnEtu' ou 'ucbnEmp' selon le
     * statut de la personne.
     *
     * @var array
     */
    protected $objectClass = [
        'top',
        'inetOrgPerson',
        'organizationalPerson',
        'person',
        'eduPerson',
        'supannPerson',
56
57
58
59
        'schacPersonalCharacteristics',
        'schacEntryMetadata',
        'ucbnEmp',
        'ucbnEtu',
60
        'posixAccount',
61
        'sambaAccount',
62
        'sambaSamAccount',
63
64
    ];

65
66
67
68
69
70
71
72
73
    /**
     * Liste des attributs autorisés pour une entité "People"
     *
     * @var array
     */
    protected $authorizedAttributes = [
        // Attributes classes
        'objectClass',
        // Attributes
74
        'campusPassword',
75
76
        'cn',
        'dateDeNaissance',
77
78
        'dateFinInscription',
        'displayName',
79
        'eduPersonAffiliation',
80
        'eduPersonNickname',
81
82
        'eduPersonOrgDN',
        'eduPersonOrgUnitDN',
83
        'eduPersonPrimaryAffiliation',
84
        'eduPersonPrimaryOrgUnitDN',
85
86
        'eduPersonPrincipalName',
        'facsimileTelephoneNumber',
87
88
89
        'gidNumber',
        'givenName',
        'homeDirectory',
90
        'labeledURI',
91
92
93
        'leoCode',
        'loginShell',
        'mail',
94
        'mailForwardingAddress',
95
        'mobile',
96
        'ntPassword',
97
98
99
100
        'pager',
        'postalAddress',
        'preferredLanguage',
        'rid',
101
        'sambaNTPassword',
102
103
104
105
106
107
108
109
        'sambaSID',
        'schacDateOfBirth',
        'schacExpiryDate',
        'sexe',
        'sn',
        'supannActivite',
        'supannAffectation',
        'supannAliasLogin',
110
        'supannAutreMail',
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
        'supannAutreTelephone',
        'supannCivilite',
        'supannCodeINE',
        'supannEmpCorps',
        'supannEmpId',
        'supannEntiteAffectation',
        'supannEntiteAffectationPrincipale',
        'supannEtablissement',
        'supannEtuAnneeInscription',
        'supannEtuCursusAnnee',
        'supannEtuDiplome',
        'supannEtuElementPedagogique',
        'supannEtuEtape',
        'supannEtuId',
        'supannEtuInscription',
        'supannEtuRegimeInscription',
        'supannEtuSecteurDisciplinaire',
        'supannEtuTypeDiplome',
        'supannListeRouge',
        'supannMailPerso',
        'supannParrainDN',
        'supannRoleGenerique',
        'supannRoleEntite',
        'supannRefId',
        'supannTypeEntiteAffectation',
        'telephoneNumber',
137
        'title',
138
139
140
141
142
143
144
145
146
        'ucbnAnneePostBac',
        'ucbnCodeEtape',
        'ucbnEtuComplementInscription',
        'ucbnFonctionStructurelle',
        'ucbnOrganisme',
        'ucbnPrivateAddress',
        'ucbnPrivateAddressBis',
        'ucbnSecteurDisciplinaire',
        'ucbnServiceADE',
147
148
149
150
        'ucbnServiceAD',
        'ucbnServiceAnnuaire',
        'ucbnServiceEspacePerso',
        'ucbnServiceIMAP',
151
        'ucbnServicePapercut',
152
        'ucbnServiceRessourcesDoc',
153
        'ucbnServiceWIFI',
154
155
        'ucbnSiteLocalisation',
        'ucbnSousStructure',
156
        'ucbnSquidHash',
157
158
        'ucbnStatus',
        'ucbnStructureRecherche',
159
        'uidNumber',
160
        'unicaenMonEtupass',
161
162
        'unicaenSecuriteCompte',
        'unicaenServiceEtat',
163
164
        'unicaenTermsOfUse',
        'userCertificate',
165
        'userPassword',
166
167
    ];

168
169
170
171
172
    /**
     * Liste des attributs contenant des dates
     *
     * @var array
     */
173
174
175
    protected $dateTimeAttributes = [
        'schacExpiryDate',
    ];
176

177
178
179
180
181
182
183
184
    /**
     * Liste des attributs monovalués
     *
     * @var array
     */
    protected $monoValuedAttributes = [
        'cn',
        'dateDeNaissance',
185
        'dateFinInscription',
186
187
        'displayName',
        'eduPersonOrgDN',
188
        'eduPersonPrimaryAffiliation',
189
190
        'eduPersonPrimaryOrgUnitDN',
        'eduPersonPrincipalName',
191
        'gidNumber',
192
        'givenName',
193
        'homeDirectory',
194
        'leoCode',
195
196
        'loginShell',
        'ntPassword',
197
        'preferredLanguage',
198
199
200
        'rid',
        'sambaNTPassword',
        'sambaSID',
201
        'schacDateOfBirth',
202
        'schacExpiryDate',
203
204
205
206
207
208
209
210
211
        'sexe',
        'supannAliasLogin',
        'supannCivilite',
        'supannCodeINE',
        'supannEmpId',
        'supannEntiteAffectationPrincipale',
        'supannEtuId',
        'supannListeRouge',
        'telephoneNumber',
212
213
        'ucbnServiceADE',
        'ucbnServicePapercut',
214
        'ucbnSquidHash',
215
        'uidNumber',
216
        'userPassword',
217
218
    ];

219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
    /**
     * Liste des valeurs autorisées pour les attributs "eduPersonAffiliation" et "eduPersonPrimaryAffiliation"
     *
     * - affiliate : personne qui ne dépend pas de l'établissement (exemple : un partenaire extérieur). La valeur
     * "member" est exclue pour ces personnes.
     * - alum : ancien étudiant conservant des relations avec l'établissement.
     * - emeritus :  professeur ayant obtenu l'éméritat dans l'établissement.
     * - employee : tout personnel rémunéré par l'établissement, quelque soit son activité.
     * - faculty : personnel dont l'activité principale (dans l'établissement) est pédagogique, d'enseignement ou/et de
     * recherche. La valeur “member” est positionnée si ce personnel est géré par l'établissement.
     * - member : personne inscrite dans la (les) base(s) de gestion des étudiants ou celle(s) des personnels.
     * - registered-reader : lecteur de bibliothèque autorisé.
     * - researcher : personne assurant une activité de recherche. La valeur “member” est positionnée si ce personnel
     * est géré par l'établissement.
     * - retired :  personne à la retraite conservant des relations avec l'établissement.
     * - staff : personnel dont l'activité principale (dans l'établissement) est autre qu'enseignant ou chercheur
     * (typiquement BIATOS).
     * - student : personne suivant une formation quelconque dans l'établissement. Si la valeur “member” est positionnée,
     * la personne est enregistrée dans la base des étudiants.
     * - teacher : personnel assurant une activité d'enseignement.
     *
     * @var array
     */
    protected $eduPersonAffiliationAuthorizedValues = [
243
244
245
246
247
248
249
250
251
252
253
254
        self::STATUS_AFFILIATE,
        self::STATUS_ALUM,
        self::STATUS_EMERITUS,
        self::STATUS_EMPLOYEE,
        self::STATUS_FACULTY,
        self::STATUS_MEMBER,
        self::STATUS_REGISTERED_READER,
        self::STATUS_RESEARCHER,
        self::STATUS_RETIRED,
        self::STATUS_STAFF,
        self::STATUS_STUDENT,
        self::STATUS_TEACHER,
255
256
257
258
259
260
261
262
263
264
265
266
267
    ];

    /**
     * Liste des valeurs autorisées pour l'attribut "ucbnStatus"
     *
     * @var array
     */
    protected $ucbnStatusAuthorizedValues = [
        'ALUMNI',
        'APPRENANT',
        'AUDITEUR_LIBRE',
        'CONTRACTUEL',
        'ETUDIANT',
268
        'HEBERGE',
269
270
271
272
273
        'INVITE',
        'LECTEUR_SCD',
        'TITULAIRE',
    ];

274
275
    /**
     * Liste des patterns spécifiques utilisés pour différents attributs
276
     */
277
    static protected $structure_pattern = '/^(?<code>[\w\-]+);(?<libelle>.+)$/';
278
279
280
281
282
    static protected $localisation_pattern = '/^(?<code>[\w\-]+);(?<libelle>.+)$/';
    static protected $etape_pattern = '/^(?<code>.+);(?<libelle>.+)$/';
    static protected $secteur_disciplinaire_pattern = '/^(?<code>\d+);(?<libelle>.+)$/';
    static protected $inscription_pattern =
        '/^\[etab=(?<etab>\{[\w\-:]+\}.+)\]' .
283
284
285
286
287
288
289
290
        '\[anneeinsc=(?<anneeinsc>\d{4})\]' .
        '\[regimeinsc=(?<regimeinsc>\{[\w\-:]+\}\w*)\]' . // {SISE}.* ou {INCONNU}
        '\[sectdisc=(?<sectdisc>\{[\w\-:]+\}\w*)\]' . // {SISE}.* ou {INCONNU}
        '\[typedip=(?<typedip>\{[\w\-:]+\}\w*)\]' . // {SISE}.* ou {INCONNU}
        '\[cursusann=(?<cursusann>\{SUPANN\}\w+)\]' .
        '\[affect=(?<affect>[\w\-]+)\]' .
        '\[diplome=(?<diplome>\{[\w\-:]+\}\w+)\]' .
        '\[etape=(?<etape>\{[\w\-:]+\}.+)\]$/';
291
292
293
294
295
296
297
298
299
    static protected $inscription_complement_pattern = 
        '/^\[anneeinsc=(?<anneeinsc>\d{4})\]' .
        '\[etape=(?<etape>\{[\w\-:]+\}.+)\]' .
        '\[adistance=(?<adistance>\{[\w\-:]+\}\w{1})\]$/';
    static protected $role_pattern =
        '/^\[role=(?<role>\{SUPANN\}[\w\-]+)\]' .
        '\[type=(?<type>\{SUPANN\}[\w\-]+)\]' .
        '\[code=(?<code>[\w\-]+)\]' .
        '\[libelle=(?<libelle>.+)\]$/';
300
    static protected $role_src_pattern = '/^(?<code>\d{4});(?<libelle>.+)$/';
301
    static protected $service_etat_pattern = '/^(?<etiquette>\{[\w\-]+\})(?<value>(A|I|S){1})$/';
302

303
304
305
306
307
308
309
310
311

    /**
     * Attribut Ldap "sn"
     *
     * Nom d'un individu
     * Doit contenir le nom d'usage. Il est possible d'ajouter le nom de famille en seconde valeur.
     *
     * Multivalué
     *
312
     * @param array|string|null $value
313
314
     * @param bool $append
     * @return self
315
     * @throws Exception
316
317
     * @throws LdapException
     */
318
    public function setSn($value = null, $append = false)
319
    {
320
321
322
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatName'], $value);
        $this->appendOrNot('sn', $value, $append);
323
324
325
326
327
328
329

        return $this;
    }

    /**
     * Attribut Ldap "givenName"
     *
330
     * @param array|string|null $value
331
332
     * @param bool $append
     * @return self
333
     * @throws Exception
334
335
     * @throws LdapException
     */
336
    public function setGivenName($value = null, $append = false)
337
    {
338
339
340
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatName'], $value);
        $this->appendOrNot('givenName', $value, $append);
341
342
343
344
345
346
347

        return $this;
    }

    /**
     * Attribut Ldap "displayName"
     *
348
     * @param array|string|null $value
349
350
     * @param bool $append
     * @return self
351
     * @throws Exception
352
353
     * @throws LdapException
     */
354
    public function setDisplayName($value = null, $append = false)
355
    {
356
357
358
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatName'], $value);
        $this->appendOrNot('displayName', $value, $append);
359
360
361
362
363
364
365

        return $this;
    }

    /**
     * Attribut Ldap "cn"
     *
366
     * @param array|string|null $value
367
368
     * @param bool $append
     * @return self
369
     * @throws Exception
370
371
     * @throws LdapException
     */
372
    public function setCn($value = null, $append = false)
373
    {
374
375
376
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatName'], $value, [true]);
        $this->appendOrNot('cn', $value, $append);
377
378
379
380
381
382
383

        return $this;
    }

    /**
     * Attribut Ldap "dateDeNaissance"
     *
384
     * @param array|string|DateTime|null $value
385
386
     * @param bool $append
     * @return self
387
     * @throws Exception
388
     * @throws LdapException
389
390
     * @deprecated Deprecated, use {@link self::setSchacDateOfBirth}
     *
391
     */
392
    public function setDateDeNaissance($value = null, $append = false)
393
    {
394
395
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
396
397
398
399
            if (is_string($val)) {
                $val = new DateTime($val);
            }
            return $val->format('Ymd');
400
        }, $value);
401

402
        $this->appendOrNot('dateDeNaissance', $value, $append);
403
404
405
406
407
408
409

        return $this;
    }

    /**
     * Attribut Ldap "schacDateOfBirth"
     *
410
     * @param array|string|DateTime|null $value
411
412
     * @param bool $append
     * @return self
413
     * @throws Exception
414
415
     * @throws LdapException
     */
416
    public function setSchacDateOfBirth($value = null, $append = false)
417
    {
418
419
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
420
421
422
423
            if (is_string($val)) {
                $val = new DateTime($val);
            }
            return $val->format('Ymd');
424
        }, $value);
425

426
        $this->appendOrNot('schacDateOfBirth', $value, $append);
427
428
429
430

        return $this;
    }

431
432
433
434
435
436
437
438
    /**
     * Attribut Ldap "dateFinInscription"
     *
     * @param array|string|DateTime|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
439
440
     * @deprecated Deprecated, use {@link self::setSchacExpiryDate}
     *
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
     */
    public function setDateFinInscription($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
            if (is_string($val)) {
                $val = new DateTime($val);
            }
            return $val->format('Ymd');
        }, $value);

        $this->appendOrNot('dateFinInscription', $value, $append);

        return $this;
    }

    /**
     * Attribut Ldap "schacDateOfBirth"
     *
     * @param array|string|DateTime|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setSchacExpiryDate($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
            if (is_string($val)) {
                $val = new DateTime($val, new \DateTimeZone('+0000')); // définition du timezone à +0h
            }
            return (int)$val->format('U');
        }, $value);

        $this->appendOrNot('schacExpiryDate', $value, $append);

        return $this;
    }

481
482
483
    /**
     * Attribut Ldap "sexe"
     *
484
     * @param array|string|null $value
485
486
     * @param bool $append
     * @return self
487
     * @throws Exception
488
489
     * @throws LdapException
     */
490
    public function setSexe($value = null, $append = false)
491
    {
492
493
494
495
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
            return in_array($v, ['F', 'M']);
        });
496

497
        $this->appendOrNot('sexe', $value, $append);
498

499
        return $this;
500
501
    }

502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
    /**
     * Attribut Ldap "eduPersonAffiliation"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setEduPersonAffiliation($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
            return in_array($v, $this->eduPersonAffiliationAuthorizedValues);
        });

        $this->appendOrNot('eduPersonAffiliation', $value, $append);

        return $this;
    }

    /**
     * Attribut Ldap "eduPersonPrimaryAffiliation"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setEduPersonPrimaryAffiliation($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
            return in_array($v, $this->eduPersonAffiliationAuthorizedValues);
        });

        $this->appendOrNot('eduPersonPrimaryAffiliation', $value, $append);

        return $this;
    }

544
545
546
    /**
     * Attribut Ldap "postalAddress"
     *
547
     * @param array|string|null $value
548
549
     * @param bool $append
     * @return self
550
     * @throws Exception
551
552
     * @throws LdapException
     */
553
    public function setPostalAddress($value = null, $append = false)
554
    {
555
556
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
557
            return preg_match(self::$postal_address_pattern, $v);
558
559
        });

560
        $this->appendOrNot('postalAddress', $value, $append);
561
562
563
564
565
566
567

        return $this;
    }

    /**
     * Attribut Ldap "telephoneNumber"
     *
568
     * @param array|string|null $value
569
570
     * @param bool $append
     * @return self
571
     * @throws Exception
572
573
     * @throws LdapException
     */
574
    public function setTelephoneNumber($value = null, $append = false)
575
    {
576
577
578
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatTel'], $value);
        $this->appendOrNot('telephoneNumber', $value, $append);
579
580
581
582
583
584
585

        return $this;
    }

    /**
     * Attribut Ldap "supannAutreTelephone"
     *
586
     * @param array|string|null $value
587
588
     * @param bool $append
     * @return self
589
     * @throws Exception
590
591
     * @throws LdapException
     */
592
    public function setSupannAutreTelephone($value = null, $append = false)
593
    {
594
595
596
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatTel'], $value);
        $this->appendOrNot('supannAutreTelephone', $value, $append);
597
598
599
600

        return $this;
    }

601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
    /**
     * Attribut Ldap "mail"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setMail($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_filter(filter_var_array($value, FILTER_VALIDATE_EMAIL));
        $this->appendOrNot('mail', $value, $append);

        return $this;
    }

619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
    /**
     * Attribut Ldap "supannAutreMail"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setSupannAutreMail($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_filter(filter_var_array($value, FILTER_VALIDATE_EMAIL));
        $this->appendOrNot('supannAutreMail', $value, $append);

        return $this;
    }

    /**
     * Attribut Ldap "mailForwardingAddress"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setMailForwardingAddress($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_filter(filter_var_array($value, FILTER_VALIDATE_EMAIL));
        $this->appendOrNot('mailForwardingAddress', $value, $append);

        return $this;
    }

655
656
657
    /**
     * Attribut Ldap "mobile"
     *
658
     * @param array|string|null $value
659
660
     * @param bool $append
     * @return self
661
     * @throws Exception
662
663
     * @throws LdapException
     */
664
    public function setMobile($value = null, $append = false)
665
    {
666
667
668
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatTel'], $value);
        $this->appendOrNot('mobile', $value, $append);
669
670
671
672

        return $this;
    }

673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
    /**
     * Attribut Ldap "pager"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setPager($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatTel'], $value);
        $this->appendOrNot('pager', $value, $append);

        return $this;
    }

691
692
693
    /**
     * Attribut Ldap "preferredLanguage"
     *
694
     * @param array|string|null $value
695
696
     * @param bool $append
     * @return self
697
     * @throws Exception
698
699
     * @throws LdapException
     */
700
    public function setPreferredLanguage($value = null, $append = false)
701
    {
702
703
704
        $value = $this->preFormat($value);
        $value = array_map('strtolower', $value);
        $this->appendOrNot('preferredLanguage', $value, $append);
705
706
707
708
709
710
711

        return $this;
    }

    /**
     * Attribut Ldap "leoCode"
     *
712
     * @param array|string|null $value
713
714
     * @param bool $append
     * @return self
715
     * @throws Exception
716
717
     * @throws LdapException
     */
718
    public function setLeoCode($value = null, $append = false)
719
    {
720
721
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
722
            return preg_match('/^\d{13}$/', $v);
723
724
        });

725
        $this->appendOrNot('leoCode', $value, $append);
726
727
728
729
730
731
732

        return $this;
    }

    /**
     * Attribut Ldap "supannALiasLogin"
     *
733
     * @param array|string|null $value
734
735
     * @param bool $append
     * @return self
736
     * @throws Exception
737
738
     * @throws LdapException
     */
739
    public function setSupannAliasLogin($value = null, $append = false)
740
    {
741
742
743
        $value = $this->preFormat($value);
        $value = array_map('strtolower', $value);
        $value = array_filter($value, function ($v) {
744
745
746
            return preg_match('/^[0-9a-z\-]+$/', $v);
        });

747
        $this->appendOrNot('supannAliasLogin', $value, $append);
748
749
750
751
752
753
754

        return $this;
    }

    /**
     * Attribut Ldap "supannEmpId"
     *
755
     * @param array|string|null $value
756
757
     * @param bool $append
     * @return self
758
     * @throws Exception
759
760
     * @throws LdapException
     */
761
    public function setSupannEmpId($value = null, $append = false)
762
    {
763
764
765
766
        $value = $this->preFormat($value);
        $this->appendOrNot('supannEmpId', $value, $append);

        return $this;
767
768
769
770
771
    }

    /**
     * Attribut Ldap "supannEtuId"
     *
772
     * @param array|string|null $value
773
774
     * @param bool $append
     * @return self
775
     * @throws Exception
776
777
     * @throws LdapException
     */
778
    public function setSupannEtuId($value = null, $append = false)
779
    {
780
781
782
783
        $value = $this->preFormat($value);
        $this->appendOrNot('supannEtuId', $value, $append);

        return $this;
784
785
    }

786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
    /**
     * Attribut Ldap "supannEtuInscription"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setSupannEtuInscription($value = null, $append = false)
    {
        $value = $this->preFormat($value);

        $supannLabel = $this->getLabel('SUPANN');
        $siseLabel = $this->getLabel('SISE');
        $inconnuLabel = $this->getLabel('INCONNU');
        $value = array_map(function ($v) use ($supannLabel, $siseLabel, $inconnuLabel) {
            if (preg_match(self::$inscription_pattern, $v, $matches)) {
                /**
                 * @var string $etab
                 * @var string $anneeinsc
                 * @var string $regimeinsc
                 * @var string $sectdisc
                 * @var string $typedip
                 * @var string $cursusann
                 * @var string $affect
                 * @var string $diplome
                 * @var string $etape
                 */
                foreach (['regimeinsc', 'sectdisc', 'typedip'] as $part) {
                    $$part = preg_match("/^($siseLabel|$inconnuLabel)\w*$/", $matches[$part])
                        ? $matches[$part]
                        : sprintf('%s%s', $siseLabel, $matches[$part]);
                }
                foreach (['cursusann'] as $part) {
                    $$part = preg_match("/^$supannLabel\w+$/", $matches[$part])
                        ? $matches[$part]
                        : sprintf('%s%s', $supannLabel, $matches[$part]);
                }

826
                $prefixe = $this->service->getLdapStructureService()->getCodeStructurePrefixe();
827
828
829
830
                $affect = (0 !== strpos($matches['affect'], $prefixe))
                    ? sprintf('%s%s', $structure_prefixe, $matches['affect'])
                    : $matches['affect'];

831
                $prefixe = $this->service->getLdapStructureService()->getCodeModuleEnseignementPrefixe();
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
                preg_match('/^(?<etiquette>\{[\w\-:]+\})(?<identifiant>.+)$/', $matches['etape'], $parts);
                $val = (0 !== strpos($parts['identifiant'], $prefixe))
                    ? $prefixe . $parts['identifiant']
                    : $parts['identifiant'];
                $etape = sprintf('%s%s', $parts['etiquette'], $val);

                return preg_replace(
                    self::$inscription_pattern,
                    "[etab=\\1][anneeinsc=\\2][regimeinsc=$regimeinsc][sectdisc=$sectdisc][typedip=$typedip][cursusann=$cursusann][affect=$affect][diplome=\\8][etape=$etape]",
                    $v, 1);
            } else {
                return null;
            }

        }, $value);

        $this->appendOrNot('supannEtuInscription', array_filter($value), $append);

        return $this;
    }

853
854
855
    /**
     * Attribut Ldap "supannCodeINE"
     *
856
     * @param array|string|null $value
857
858
     * @param bool $append
     * @return self
859
     * @throws Exception
860
861
     * @throws LdapException
     */
862
    public function setSupannCodeINE($value = null, $append = false)
863
    {
864
865
866
        $value = $this->preFormat($value);
        $value = array_map('strtoupper', $value);
        $value = array_filter($value, function ($v) {
867
            return preg_match('/^[\w]{11}$/', $v);
868
869
        });

870
        $this->appendOrNot('supannCodeINE', $value, $append);
871
872
873
874
875
876
877

        return $this;
    }

    /**
     * Attribut Ldap "supannCivilite"
     *
878
     * @param array|string|null $value
879
880
     * @param bool $append
     * @return self
881
     * @throws Exception
882
883
     * @throws LdapException
     */
884
    public function setSupannCivilite($value = null, $append = false)
885
    {
886
887
888
889
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
            return in_array($v, ['Mme', 'M.']);
        });
890

891
        $this->appendOrNot('supannCivilite', $value, $append);
892

893
        return $this;
894
895
896
897
898
    }

    /**
     * Attribut Ldap "supannListeRouge"
     *
899
     * @param array|string|null $value
900
901
     * @param bool $append
     * @return self
902
     * @throws Exception
903
904
     * @throws LdapException
     */
905
    public function setSupannListeRouge($value = null, $append = false)
906
    {
907
908
909
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatBoolean'], $value);
        $this->appendOrNot('supannListeRouge', $value, $append);
910
911
912
913
914
915
916

        return $this;
    }

    /**
     * Attribut Ldap "supannMailPerso"
     *
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setSupannMailPerso($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_filter(filter_var_array($value, FILTER_VALIDATE_EMAIL));
        $this->appendOrNot('supannMailPerso', $value, $append);

        return $this;
    }

    /**
     * Attribut Ldap "supannAffectation"
     *
935
     * @param array|string|StructureEntity|null $value
936
937
938
939
940
941
942
943
944
945
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setSupannAffectation($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
            if (is_string($val)) {
946
947
                return preg_match(self::$structure_pattern, $val) ? $val : null;
            } elseif ($val instanceof StructureEntity) {
948
                $val = sprintf('%s;%s', strtr($val->get('supannCodeEntite'), $this->service->getLdapStructureService()->getCodeStructurePrefixe(), ''), $val->get('description'));
949
                return preg_match(self::$structure_pattern, $val) ? $val : null;
950
951
952
953
954
            } else {
                return null;
            }
        }, $value);

955
        $this->appendOrNot('supannAffectation', array_filter($value), $append);
956
957
958
959
960
961
962

        return $this;
    }

    /**
     * Attribut Ldap "supannEntiteAffectation"
     *
963
     * @param array|string|StructureEntity|null $value
964
965
     * @param bool $append
     * @return self
966
     * @throws Exception
967
968
     * @throws LdapException
     */
969
    public function setSupannEntiteAffectation($value = null, $append = false)
970
    {
971
972
973
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
            if (is_string($val)) {
974
975
                if (0 !== strpos($val, $this->service->getLdapStructureService()->getCodeStructurePrefixe())) {
                    $val = $this->service->getLdapStructureService()->getCodeStructurePrefixe() . $val;
976
977
                }
                return $val;
978
            } elseif ($val instanceof StructureEntity) {
979
980
981
982
983
984
                return $val->get('supannCodeEntite');
            } else {
                return null;
            }
        }, $value);

985
        $this->appendOrNot('supannEntiteAffectation', array_filter($value), $append);
986
987
988
989
990
991
992

        return $this;
    }

    /**
     * Attribut Ldap "supannEntiteAffectationPrincipale"
     *
993
     * @param array|string|StructureEntity|null $value
994
995
996
997
998
999
1000
1001
1002
1003
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setSupannEntiteAffectationPrincipale($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
            if (is_string($val)) {
1004
1005
                if (0 !== strpos($val, $this->service->getLdapStructureService()->getCodeStructurePrefixe())) {
                    $val = $this->service->getLdapStructureService()->getCodeStructurePrefixe() . $val;
1006
1007
                }
                return $val;
1008
            } elseif ($val instanceof StructureEntity) {
1009
1010
1011
1012
1013
1014
                return $val->get('supannCodeEntite');
            } else {
                return null;
            }
        }, $value);

1015
        $this->appendOrNot('supannEntiteAffectationPrincipale', array_filter($value), $append);
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031

        return $this;
    }

    /**
     * Attribut Ldap "supannTypeEntiteAffectation"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setSupannTypeEntiteAffectation($value = null, $append = false)
    {
        $value = $this->preFormat($value);
1032
1033
        $supannLabel = $this->getLabel('SUPANN');
        $value = array_map(function ($val) use ($supannLabel) {
1034
            if (is_string($val)) {
1035
                if (preg_match("/^" . $supannLabel . "[\w\-]+$/", $val)) {
1036
                    return $val;
1037
                } elseif (preg_match("/^[\w\-]+$/", $val)) {
1038
1039
                    return sprintf('%s%s', $supannLabel, $val);
                }
1040
            }
1041
            return null;
1042
1043
        }, $value);

1044
        $this->appendOrNot('supannTypeEntiteAffectation', array_filter($value), $append);
1045
1046
1047
1048

        return $this;
    }

1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
    /**
     * Attribut Ldap "ucbnSiteLocalisation"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setUcbnSiteLocalisation($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
            return preg_match(self::$localisation_pattern, $v);
        });

        $this->appendOrNot('ucbnSiteLocalisation', $value, $append);

        return $this;
    }

1070
1071
1072
    /**
     * Attribut Ldap "ucbnSousStructure"
     *
1073
     * @param array|string|StructureEntity|null $value
1074
1075
1076
1077
1078
1079
1080
1081
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setUcbnSousStructure($value = null, $append = false)
    {
        $value = $this->preFormat($value);
1082
1083
1084
1085
        $value = array_map(function ($val) {
            if (is_string($val)) {
                return preg_match(self::$structure_pattern, $val) ? $val : null;
            } elseif ($val instanceof StructureEntity) {
1086
                $val = sprintf('%s;%s', strtr($val->get('supannCodeEntite'), $this->service->getLdapStructureService()->getCodeStructurePrefixe(), ''), $val->get('description'));
1087
1088
1089
1090
1091
                return preg_match(self::$structure_pattern, $val) ? $val : null;
            } else {
                return null;
            }
        }, $value);
1092

1093
        $this->appendOrNot('ucbnSousStructure', array_filter($value), $append);
1094
1095
1096
1097
1098
1099
1100

        return $this;
    }

    /**
     * Attribut Ldap "ucbnStructureRecherche"
     *
1101
     * @param array|string|StructureEntity|null $value
1102
1103
1104
1105
1106
1107
1108
1109
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setUcbnStructureRecherche($value = null, $append = false)
    {
        $value = $this->preFormat($value);
1110
1111
1112
1113
        $value = array_map(function ($val) {
            if (is_string($val)) {
                return preg_match(self::$structure_pattern, $val) ? $val : null;
            } elseif ($val instanceof StructureEntity) {
1114
                $val = sprintf('%s;%s', strtr($val->get('supannCodeEntite'), $this->service->getLdapStructureService()->getCodeStructurePrefixe(), ''), $val->get('description'));
1115
1116
1117
1118
1119
                return preg_match(self::$structure_pattern, $val) ? $val : null;
            } else {
                return null;
            }
        }, $value);
1120

1121
        $this->appendOrNot('ucbnStructureRecherche', array_filter($value), $append);
1122
1123
1124
1125

        return $this;
    }

1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
    /**
     * Attribut Ldap "eduPersonPrincipalName"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setEduPersonPrincipalName($value = null, $append = false)
    {
1137
        $universiteDomaine = $this->service->getLdapRootService()->getEtablissementDomain();
1138
        $value = $this->preFormat($value);
1139
        $value = array_map(function ($v) use ($universiteDomaine) {
1140
            list($identifiant, $domaine) = array_pad(explode('@', strtolower($v)), 2, null);
1141
1142
            if ($domaine != $universiteDomaine) {
                $v = sprintf('%s@%s', $v, $universiteDomaine);
1143
1144
1145
            }
            return $v;
        }, $value);
1146
        $value = array_filter($value, function ($v) use ($universiteDomaine) {
1147
            return preg_match('/^[0-9a-z\-]+@' . $universiteDomaine . '$/', $v);
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
        });

        $this->appendOrNot('eduPersonPrincipalName', $value, $append);

        return $this;
    }

    /**
     * Attribut Ldap "eduPersonOrgDN"
     *
1158
     * @param array|string|Dn|StructureEntity|null $value
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setEduPersonOrgDN($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
            if (is_string($val)) {
                return Dn::checkDn($val) ? $val : null;
            } elseif ($val instanceof Dn) {
                return $val->toString();
1172
            } elseif ($val instanceof StructureEntity) {
1173
1174
1175
1176
1177
1178
                return $val->getDn();
            } else {
                return null;
            }
        }, $value);

1179
        $this->appendOrNot('eduPersonOrgDN', array_filter($value), $append);
1180
1181
1182
1183
1184
1185
1186

        return $this;
    }

    /**
     * Attribut Ldap "eduPersonOrgUnitDN"
     *
1187
     * @param array|string|Dn|StructureEntity|null $value
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setEduPersonOrgUnitDN($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
            if (is_string($val)) {
                return Dn::checkDn($val) ? $val : null;
            } elseif ($val instanceof Dn) {
                return $val->toString();
1201
            } elseif ($val instanceof StructureEntity) {
1202
1203
1204
1205
1206
1207
                return $val->getDn();
            } else {
                return null;
            }
        }, $value);

1208
        $this->appendOrNot('eduPersonOrgUnitDN', array_filter($value), $append);
1209
1210
1211
1212
1213
1214
1215

        return $this;
    }

    /**
     * Attribut Ldap "eduPersonPrimaryOrgUnitDN"
     *
1216
     * @param array|string|Dn|StructureEntity|null $value
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setEduPersonPrimaryOrgUnitDN($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
            if (is_string($val)) {
                return Dn::checkDn($val) ? $val : null;
            } elseif ($val instanceof Dn) {
                return $val->toString();
1230
            } elseif ($val instanceof StructureEntity) {
1231
1232
1233
1234
1235
1236
                return $val->getDn();
            } else {
                return null;
            }
        }, $value);

1237
        $this->appendOrNot('eduPersonPrimaryOrgUnitDN', array_filter($value), $append);
1238
1239
1240
1241

        return $this;
    }

1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
    /**
     * Attribut Ldap "supannRoleGenerique"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setSupannRoleGenerique($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $supannLabel = $this->getLabel('SUPANN');
        $value = array_map(function ($val) use ($supannLabel) {
            if (is_string($val)) {
1257
                if (preg_match("/^" . $supannLabel . "[\w\-]+$/", $val)) {
1258
                    return $val;
1259
                } elseif (preg_match("/^[\w\-]+$/", $val)) {
1260
1261
                    return sprintf('%s%s', $supannLabel, $val);
                }
1262
            }
1263
            return null;
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
        }, $value);

        $this->appendOrNot('supannRoleGenerique', array_filter($value), $append);

        return $this;
    }

    /**
     * Attribut Ldap "supannR