People.php 38.4 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
10
use UnicaenLdap\Exception;
use Zend\Ldap\Dn;
11
12
13
14
15
use Zend\Ldap\Exception\LdapException;

/**
 * Classe mère des entités de la branche "people" de l'annuaire LDAP.
 *
16
 * @author David Surville <david.surville@unicaen.fr>
17
18
19
20
21
22
 */
class People extends Entity
{
    protected $type = 'People';

    /**
23
     * Liste des classes d'objet nécessaires à la création d'une entité "People"
24
25
26
27
28
29
30
31
32
33
34
35
     * 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',
36
        'posixAccount',
37
38
        'sambaAccount',
        'sambaSamAcount',
39
40
        "schacPersonalCharacteristics",
        "schacEntryMetadata"
41
42
    ];

43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
    /**
     * Liste des attributs autorisés pour une entité "People"
     *
     * @var array
     */
    protected $authorizedAttributes = [
        // Attributes classes
        'objectClass',
        // Attributes
        'cn',
        'displayName',
        'dateDeNaissance',
        'eduPersonPrincipalName',
        'eduPersonNickname', // no getter and setter
        'eduPersonAffiliation',
        'eduPersonPrimaryAffiliation',
        'eduPersonOrgDN',
        'eduPersonOrgUnitDN',
        'eduPersonPrimaryOrgUnitDN',
        'dateFinInscription',
        'facsimileTelephoneNumber', // no getter and setter
        'gidNumber',
        'givenName',
        'homeDirectory',
        'labeledURI', // no getter and setter
        'leoCode',
        'loginShell',
        'mail',
        'mobile',
        'pager',
        'postalAddress',
        'preferredLanguage',
        'rid',
        'sambaSID',
        'schacDateOfBirth',
        'schacExpiryDate',
        'sexe',
        'sn',
        'supannActivite',
        'supannAffectation',
        'supannAliasLogin',
        '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',
        'title', // no getter and setter
        'ucbnAnneePostBac',
        'ucbnCodeEtape',
        'ucbnEtuComplementInscription',
        'ucbnFonctionStructurelle',
        'ucbnOrganisme',
        'ucbnPrivateAddress',
        'ucbnPrivateAddressBis',
        'ucbnSecteurDisciplinaire',
        'ucbnServiceADE',
        'ucbnServicePapercut',
        'ucbnSiteLocalisation',
        'ucbnSousStructure',
        'ucbnStatus',
        'ucbnStructureRecherche',
        'unicaenMonEtupass',
        'unicaenTermsOfUse',
        'userCertificate',
        'uidNumber',
    ];

131
132
133
134
135
    /**
     * Liste des attributs contenant des dates
     *
     * @var array
     */
136
137
138
    protected $dateTimeAttributes = [
        'schacExpiryDate',
    ];
139

140
141
142
143
144
145
146
147
    /**
     * Liste des attributs monovalués
     *
     * @var array
     */
    protected $monoValuedAttributes = [
        'cn',
        'dateDeNaissance',
148
        'dateFinInscription',
149
150
        'displayName',
        'eduPersonOrgDN',
151
        'eduPersonPrimaryAffiliation',
152
153
154
155
156
157
        'eduPersonPrimaryOrgUnitDN',
        'eduPersonPrincipalName',
        'givenName',
        'leoCode',
        'preferredLanguage',
        'schacDateOfBirth',
158
        'schacExpiryDate',
159
160
161
162
163
164
165
166
167
168
169
        'sexe',
        'supannAliasLogin',
        'supannCivilite',
        'supannCodeINE',
        'supannEmpId',
        'supannEntiteAffectationPrincipale',
        'supannEtuId',
        'supannListeRouge',
        'telephoneNumber',
    ];

170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
    /**
     * 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 = [
        'affiliate',
        'alum',
        'emeritus',
        'employee',
        'faculty',
        'member',
        'registered-reader',
        'researcher',
        'retired',
        'staff',
        'student',
        'teacher',
    ];

    /**
     * Liste des valeurs autorisées pour l'attribut "ucbnStatus"
     *
     * @var array
     */
    protected $ucbnStatusAuthorizedValues = [
        'ALUMNI',
        'APPRENANT',
        'AUDITEUR_LIBRE',
        'CONTRACTUEL',
        'ETUDIANT',
219
        'HEBERGE',
220
221
222
223
224
225
        'INVITE',
        'LECTEUR_SCD',
        'TITULAIRE',
    ];

    /**
226
227
228
229
230
231
     * Liste des patterns génériques utilisés pour différents attributs
     */
    static protected $attribute_with_label_pattern = '/^\{(?<etiquette>[\w-:]+)\}(?<identifiant>.+)$/';

    /**
     * Liste des patterns spécifiques utilisés pour différents attributs
232
233
     */
    static protected $structure_pattern = '/^(?<code>[\w-]+);(?<libelle>.+)$/';
234
    static protected $secteur_disciplinaire_pattern = '/^(?<code>[\d]+);(?<libelle>.+)$/';
235
236
237
    static protected $postal_address_pattern = '/^(.*)\$(.*)\$(.*)\$(.*)\$(.*)\$(.*)$/';
    static protected $role_pattern = '/^\[role=(?<role>[\w-]+)\]\[type=(?<type>[\w-]+)\]\[code=(?<code>[\w-]+)\]\[libelle=(?<libelle>.+)\]$/';
    static protected $role_src_pattern = '/^(?<code>[\d]{4});(?<libelle>.+)$/';
238

239
240

    /**
241
242
     * Ajoute ou affecte une valeur à un attribut Ldap
     *
243
244
245
     * @param string $attrName
     * @param mixed $value
     * @param bool $append
246
247
     * @throws Exception
     * @throws LdapException
248
     */
249
    protected function appendOrNot($attrName, $value, $append)
250
251
252
253
254
255
    {
        (!$append)
            ? $this->set($attrName, $value)
            : $this->add($attrName, $value);
    }

256
257
258
259
260
261
    /**
     * Vérifie une valeur et supprime les valeurs nulles
     *
     * @param mixed $value
     * @return array
     */
262
    protected function preFormat($value)
263
    {
264
265
266
        if (is_scalar($value)
            || is_null($value)
            || is_a($value, 'DateTime')) {
267
268
269
270
271
272
273
274
            $value = [$value];
        }

        $value = array_filter($value);

        return $value;
    }

275
276
277
278
279
280
281
282
    /**
     * 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é
     *
283
     * @param array|string|null $value
284
285
     * @param bool $append
     * @return self
286
     * @throws Exception
287
288
     * @throws LdapException
     */
289
    public function setSn($value = null, $append = false)
290
    {
291
292
293
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatName'], $value);
        $this->appendOrNot('sn', $value, $append);
294
295
296
297
298
299
300

        return $this;
    }

    /**
     * Attribut Ldap "givenName"
     *
301
     * @param array|string|null $value
302
303
     * @param bool $append
     * @return self
304
     * @throws Exception
305
306
     * @throws LdapException
     */
307
    public function setGivenName($value = null, $append = false)
308
    {
309
310
311
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatName'], $value);
        $this->appendOrNot('givenName', $value, $append);
312
313
314
315
316
317
318

        return $this;
    }

    /**
     * Attribut Ldap "displayName"
     *
319
     * @param array|string|null $value
320
321
     * @param bool $append
     * @return self
322
     * @throws Exception
323
324
     * @throws LdapException
     */
325
    public function setDisplayName($value = null, $append = false)
326
    {
327
328
329
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatName'], $value);
        $this->appendOrNot('displayName', $value, $append);
330
331
332
333
334
335
336

        return $this;
    }

    /**
     * Attribut Ldap "cn"
     *
337
     * @param array|string|null $value
338
339
     * @param bool $append
     * @return self
340
     * @throws Exception
341
342
     * @throws LdapException
     */
343
    public function setCn($value = null, $append = false)
344
    {
345
346
347
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatName'], $value, [true]);
        $this->appendOrNot('cn', $value, $append);
348
349
350
351
352
353
354

        return $this;
    }

    /**
     * Attribut Ldap "dateDeNaissance"
     *
355
356
357
     * @deprecated Deprecated, use {@link self::setSchacDateOfBirth}
     *
     * @param array|string|DateTime|null $value
358
359
     * @param bool $append
     * @return self
360
     * @throws Exception
361
362
     * @throws LdapException
     */
363
    public function setDateDeNaissance($value = null, $append = false)
364
    {
365
366
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
367
368
369
370
            if (is_string($val)) {
                $val = new DateTime($val);
            }
            return $val->format('Ymd');
371
        }, $value);
372

373
        $this->appendOrNot('dateDeNaissance', $value, $append);
374
375
376
377
378
379
380

        return $this;
    }

    /**
     * Attribut Ldap "schacDateOfBirth"
     *
381
     * @param array|string|DateTime|null $value
382
383
     * @param bool $append
     * @return self
384
     * @throws Exception
385
386
     * @throws LdapException
     */
387
    public function setSchacDateOfBirth($value = null, $append = false)
388
    {
389
390
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
391
392
393
394
            if (is_string($val)) {
                $val = new DateTime($val);
            }
            return $val->format('Ymd');
395
        }, $value);
396

397
        $this->appendOrNot('schacDateOfBirth', $value, $append);
398
399
400
401

        return $this;
    }

402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
    /**
     * Attribut Ldap "dateFinInscription"
     *
     * @deprecated Deprecated, use {@link self::setSchacExpiryDate}
     *
     * @param array|string|DateTime|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    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;
    }

452
453
454
    /**
     * Attribut Ldap "sexe"
     *
455
     * @param array|string|null $value
456
457
     * @param bool $append
     * @return self
458
     * @throws Exception
459
460
     * @throws LdapException
     */
461
    public function setSexe($value = null, $append = false)
462
    {
463
464
465
466
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
            return in_array($v, ['F', 'M']);
        });
467

468
        $this->appendOrNot('sexe', $value, $append);
469

470
        return $this;
471
472
    }

473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
    /**
     * 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;
    }

515
516
517
    /**
     * Attribut Ldap "postalAddress"
     *
518
     * @param array|string|null $value
519
520
     * @param bool $append
     * @return self
521
     * @throws Exception
522
523
     * @throws LdapException
     */
524
    public function setPostalAddress($value = null, $append = false)
525
    {
526
527
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
528
            return preg_match(self::$postal_address_pattern, $v);
529
530
        });

531
        $this->appendOrNot('postalAddress', $value, $append);
532
533
534
535
536
537
538

        return $this;
    }

    /**
     * Attribut Ldap "telephoneNumber"
     *
539
     * @param array|string|null $value
540
541
     * @param bool $append
     * @return self
542
     * @throws Exception
543
544
     * @throws LdapException
     */
545
    public function setTelephoneNumber($value = null, $append = false)
546
    {
547
548
549
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatTel'], $value);
        $this->appendOrNot('telephoneNumber', $value, $append);
550
551
552
553
554
555
556

        return $this;
    }

    /**
     * Attribut Ldap "supannAutreTelephone"
     *
557
     * @param array|string|null $value
558
559
     * @param bool $append
     * @return self
560
     * @throws Exception
561
562
     * @throws LdapException
     */
563
    public function setSupannAutreTelephone($value = null, $append = false)
564
    {
565
566
567
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatTel'], $value);
        $this->appendOrNot('supannAutreTelephone', $value, $append);
568
569
570
571
572
573
574

        return $this;
    }

    /**
     * Attribut Ldap "mobile"
     *
575
     * @param array|string|null $value
576
577
     * @param bool $append
     * @return self
578
     * @throws Exception
579
580
     * @throws LdapException
     */
581
    public function setMobile($value = null, $append = false)
582
    {
583
584
585
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatTel'], $value);
        $this->appendOrNot('mobile', $value, $append);
586
587
588
589
590
591
592

        return $this;
    }

    /**
     * Attribut Ldap "preferredLanguage"
     *
593
     * @param array|string|null $value
594
595
     * @param bool $append
     * @return self
596
     * @throws Exception
597
598
     * @throws LdapException
     */
599
    public function setPreferredLanguage($value = null, $append = false)
600
    {
601
602
603
        $value = $this->preFormat($value);
        $value = array_map('strtolower', $value);
        $this->appendOrNot('preferredLanguage', $value, $append);
604
605
606
607
608
609
610

        return $this;
    }

    /**
     * Attribut Ldap "leoCode"
     *
611
     * @param array|string|null $value
612
613
     * @param bool $append
     * @return self
614
     * @throws Exception
615
616
     * @throws LdapException
     */
617
    public function setLeoCode($value = null, $append = false)
618
    {
619
620
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
621
622
623
            return preg_match('/^\d+$/', $v);
        });

624
        $this->appendOrNot('leoCode', $value, $append);
625
626
627
628
629
630
631

        return $this;
    }

    /**
     * Attribut Ldap "supannALiasLogin"
     *
632
     * @param array|string|null $value
633
634
     * @param bool $append
     * @return self
635
     * @throws Exception
636
637
     * @throws LdapException
     */
638
    public function setSupannAliasLogin($value = null, $append = false)
639
    {
640
641
642
        $value = $this->preFormat($value);
        $value = array_map('strtolower', $value);
        $value = array_filter($value, function ($v) {
643
644
645
            return preg_match('/^[0-9a-z\-]+$/', $v);
        });

646
        $this->appendOrNot('supannAliasLogin', $value, $append);
647
648
649
650
651
652
653

        return $this;
    }

    /**
     * Attribut Ldap "supannEmpId"
     *
654
     * @param array|string|null $value
655
656
     * @param bool $append
     * @return self
657
     * @throws Exception
658
659
     * @throws LdapException
     */
660
    public function setSupannEmpId($value = null, $append = false)
661
    {
662
        $value = $this->preFormat($value);
663

664
665
666
        $this->appendOrNot('supannEmpId', $value, $append);

        return $this;
667
668
669
670
671
    }

    /**
     * Attribut Ldap "supannEtuId"
     *
672
     * @param array|string|null $value
673
674
     * @param bool $append
     * @return self
675
     * @throws Exception
676
677
     * @throws LdapException
     */
678
    public function setSupannEtuId($value = null, $append = false)
679
    {
680
        $value = $this->preFormat($value);
681

682
683
684
        $this->appendOrNot('supannEtuId', $value, $append);

        return $this;
685
686
687
688
689
    }

    /**
     * Attribut Ldap "supannCodeINE"
     *
690
     * @param array|string|null $value
691
692
     * @param bool $append
     * @return self
693
     * @throws Exception
694
695
     * @throws LdapException
     */
696
    public function setSupannCodeINE($value = null, $append = false)
697
    {
698
699
700
        $value = $this->preFormat($value);
        $value = array_map('strtoupper', $value);
        $value = array_filter($value, function ($v) {
701
702
703
            return preg_match('/^[0-9]{10}[A-Z]{1}$/', $v);
        });

704
        $this->appendOrNot('supannCodeINE', $value, $append);
705
706
707
708
709
710
711

        return $this;
    }

    /**
     * Attribut Ldap "supannCivilite"
     *
712
     * @param array|string|null $value
713
714
     * @param bool $append
     * @return self
715
     * @throws Exception
716
717
     * @throws LdapException
     */
718
    public function setSupannCivilite($value = null, $append = false)
719
    {
720
721
722
723
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
            return in_array($v, ['Mme', 'M.']);
        });
724

725
        $this->appendOrNot('supannCivilite', $value, $append);
726

727
        return $this;
728
729
730
731
732
    }

    /**
     * Attribut Ldap "supannListeRouge"
     *
733
     * @param array|string|null $value
734
735
     * @param bool $append
     * @return self
736
     * @throws Exception
737
738
     * @throws LdapException
     */
739
    public function setSupannListeRouge($value = null, $append = false)
740
    {
741
742
743
        $value = $this->preFormat($value);
        $value = array_map([$this, 'formatBoolean'], $value);
        $this->appendOrNot('supannListeRouge', $value, $append);
744
745
746
747
748
749
750

        return $this;
    }

    /**
     * Attribut Ldap "supannMailPerso"
     *
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
     * @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"
     *
769
     * @param array|string|StructureEntity|null $value
770
771
772
773
774
775
776
777
778
779
     * @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)) {
780
781
782
783
                return preg_match(self::$structure_pattern, $val) ? $val : null;
            } elseif ($val instanceof StructureEntity) {
                $val = sprintf('%s;%s', strtr($val->get('supannCodeEntite'), $this->getService()->getCodeStructurePrefixe(), ''), $val->get('description'));
                return preg_match(self::$structure_pattern, $val) ? $val : null;
784
785
786
787
788
            } else {
                return null;
            }
        }, $value);

789
        $this->appendOrNot('supannAffectation', array_filter($value), $append);
790
791
792
793
794
795
796

        return $this;
    }

    /**
     * Attribut Ldap "supannEntiteAffectation"
     *
797
     * @param array|string|StructureEntity|null $value
798
799
     * @param bool $append
     * @return self
800
     * @throws Exception
801
802
     * @throws LdapException
     */
803
    public function setSupannEntiteAffectation($value = null, $append = false)
804
    {
805
806
807
808
809
810
811
        $value = $this->preFormat($value);
        $value = array_map(function ($val) {
            if (is_string($val)) {
                if (0 !== strpos($val, $this->getService()->getCodeStructurePrefixe())) {
                    $val = $this->getService()->getCodeStructurePrefixe() . $val;
                }
                return $val;
812
            } elseif ($val instanceof StructureEntity) {
813
814
815
816
817
818
                return $val->get('supannCodeEntite');
            } else {
                return null;
            }
        }, $value);

819
        $this->appendOrNot('supannEntiteAffectation', array_filter($value), $append);
820
821
822
823
824
825
826

        return $this;
    }

    /**
     * Attribut Ldap "supannEntiteAffectationPrincipale"
     *
827
     * @param array|string|StructureEntity|null $value
828
829
830
831
832
833
834
835
836
837
838
839
840
841
     * @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)) {
                if (0 !== strpos($val, $this->getService()->getCodeStructurePrefixe())) {
                    $val = $this->getService()->getCodeStructurePrefixe() . $val;
                }
                return $val;
842
            } elseif ($val instanceof StructureEntity) {
843
844
845
846
847
848
                return $val->get('supannCodeEntite');
            } else {
                return null;
            }
        }, $value);

849
        $this->appendOrNot('supannEntiteAffectationPrincipale', array_filter($value), $append);
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865

        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);
866
867
        $supannLabel = $this->getLabel('SUPANN');
        $value = array_map(function ($val) use ($supannLabel) {
868
            if (is_string($val)) {
869
                return preg_match("/^$supannLabel.+$/", $val) ? $val : sprintf('%s%s', $supannLabel, $val);
870
            } else {
871
                return null;
872
873
874
            }
        }, $value);

875
        $this->appendOrNot('supannTypeEntiteAffectation', array_filter($value), $append);
876
877
878
879

        return $this;
    }

880
881
882
    /**
     * Attribut Ldap "ucbnSousStructure"
     *
883
     * @param array|string|StructureEntity|null $value
884
885
886
887
888
889
890
891
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setUcbnSousStructure($value = null, $append = false)
    {
        $value = $this->preFormat($value);
892
893
894
895
896
897
898
899
900
901
        $value = array_map(function ($val) {
            if (is_string($val)) {
                return preg_match(self::$structure_pattern, $val) ? $val : null;
            } elseif ($val instanceof StructureEntity) {
                $val = sprintf('%s;%s', strtr($val->get('supannCodeEntite'), $this->getService()->getCodeStructurePrefixe(), ''), $val->get('description'));
                return preg_match(self::$structure_pattern, $val) ? $val : null;
            } else {
                return null;
            }
        }, $value);
902

903
        $this->appendOrNot('ucbnSousStructure', array_filter($value), $append);
904
905
906
907
908
909
910

        return $this;
    }

    /**
     * Attribut Ldap "ucbnStructureRecherche"
     *
911
     * @param array|string|StructureEntity|null $value
912
913
914
915
916
917
918
919
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setUcbnStructureRecherche($value = null, $append = false)
    {
        $value = $this->preFormat($value);
920
921
922
923
924
925
926
927
928
929
        $value = array_map(function ($val) {
            if (is_string($val)) {
                return preg_match(self::$structure_pattern, $val) ? $val : null;
            } elseif ($val instanceof StructureEntity) {
                $val = sprintf('%s;%s', strtr($val->get('supannCodeEntite'), $this->getService()->getCodeStructurePrefixe(), ''), $val->get('description'));
                return preg_match(self::$structure_pattern, $val) ? $val : null;
            } else {
                return null;
            }
        }, $value);
930

931
        $this->appendOrNot('ucbnStructureRecherche', array_filter($value), $append);
932
933
934
935

        return $this;
    }

936
937
938
939
940
941
942
943
944
945
946
947
    /**
     * Attribut Ldap "eduPersonPrincipalName"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setEduPersonPrincipalName($value = null, $append = false)
    {
        $value = $this->preFormat($value);
948
949
950
        $value = array_map(function ($v) {
            list($identifiant, $domaine) = array_pad(explode('@', strtolower($v)), 2, null);
            if ($domaine != self::$etablissement_domaine) {
951
952
953
954
955
                $v = sprintf('%s@%s', $v, self::$etablissement_domaine);
            }
            return $v;
        }, $value);
        $value = array_filter($value, function ($v) {
956
            return preg_match('/^[0-9a-z\-]+@' . self::$etablissement_domaine . '$/', $v);
957
958
959
960
961
962
963
964
965
966
        });

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

        return $this;
    }

    /**
     * Attribut Ldap "eduPersonOrgDN"
     *
967
     * @param array|string|Dn|StructureEntity|null $value
968
969
970
971
972
973
974
975
976
977
978
979
980
     * @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();
981
            } elseif ($val instanceof StructureEntity) {
982
983
984
985
986
987
                return $val->getDn();
            } else {
                return null;
            }
        }, $value);

988
        $this->appendOrNot('eduPersonOrgDN', array_filter($value), $append);
989
990
991
992
993
994
995

        return $this;
    }

    /**
     * Attribut Ldap "eduPersonOrgUnitDN"
     *
996
     * @param array|string|Dn|StructureEntity|null $value
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
     * @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();
1010
            } elseif ($val instanceof StructureEntity) {
1011
1012
1013
1014
1015
1016
                return $val->getDn();
            } else {
                return null;
            }
        }, $value);

1017
        $this->appendOrNot('eduPersonOrgUnitDN', array_filter($value), $append);
1018
1019
1020
1021
1022
1023
1024

        return $this;
    }

    /**
     * Attribut Ldap "eduPersonPrimaryOrgUnitDN"
     *
1025
     * @param array|string|Dn|StructureEntity|null $value
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
     * @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();
1039
            } elseif ($val instanceof StructureEntity) {
1040
1041
1042
1043
1044
1045
                return $val->getDn();
            } else {
                return null;
            }
        }, $value);

1046
        $this->appendOrNot('eduPersonPrimaryOrgUnitDN', array_filter($value), $append);
1047
1048
1049
1050

        return $this;
    }

1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
    /**
     * 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)) {
1066
                return preg_match("/^$supannLabel.+$/", $val) ? $val : sprintf('%s%s', $supannLabel, $val);
1067
            } else {
1068
                return null;
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
            }
        }, $value);

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

        return $this;
    }

    /**
     * Attribut Ldap "supannRoleEntite"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setSupannRoleEntite($value = null, $append = false)
    {
        $value = $this->preFormat($value);

        $supannLabel = $this->getLabel('SUPANN');
        $value = array_map(function ($v) use ($supannLabel) {
1092
            if (preg_match(self::$role_pattern, $v, $matches)) {
1093
1094
1095
1096
1097
                /**
                 * @var string $role
                 * @var string $type
                 * @var string $code
                 */
1098
                foreach (['role', 'type'] as $part) {
1099
                    $$part = preg_match("/^$supannLabel.+$/", $matches[$part])
1100
1101
1102
1103
1104
1105
1106
1107
1108
                        ? $matches[$part]
                        : sprintf('%s%s', $supannLabel, $matches[$part]);
                }

                $prefixe = $this->getService()->getCodeStructurePrefixe();
                $code = (0 !== strpos($matches['code'], $prefixe))
                    ? sprintf('%s%s', $prefixe, $matches['code'])
                    : $matches['code'];
                return preg_replace(self::$role_pattern, "[role=$role][type=$type][code=$code][libelle=\\4]", $v, 1);
1109
            } else {
1110
                return null;
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
            }

        }, $value);

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

        return $this;
    }

    /**
1121
     * Attribut Ldap "ucbnFonctionStructurelle"
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setUcbnFonctionStructurelle($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
            return preg_match(self::$role_src_pattern, $v);

        });

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

        return $this;
    }

1142
1143
1144
    /**
     * Attribut Ldap "supannParrainDN"
     *
1145
     * @param array|string|Dn|PeopleEntity|null $value
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setSupannParrainDN($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();
1159
            } elseif ($val instanceof PeopleEntity) {
1160
1161
1162
1163
1164
1165
                return $val->getDn();
            } else {
                return null;
            }
        }, $value);

1166
        $this->appendOrNot('supannParrainDN', array_filter($value), $append);
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183

        return $this;
    }

    /**
     * Attribut Ldap "supannRefId"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return self
     * @throws Exception
     * @throws LdapException
     */
    public function setSupannRefId($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
1184
            return preg_match(self::$attribute_with_label_pattern, $v);
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
        });

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

        return $this;
    }

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

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

        return $this;
    }

    /**
     * Attribut Ldap "unicaenTermsOfUse"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return $this
     * @throws Exception
     * @throws LdapException
     */
    public function setUnicaenTermsOfUse($value = null, $append = false)
    {
        $value = $this->preFormat($value);

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

        return $this;
    }

1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
    /**
     * Attribut Ldap "supannActivite"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return $this
     * @throws Exception
     * @throws LdapException
     */
    public function setSupannActivite($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
            return preg_match(self::$attribute_with_label_pattern, $v);
        });

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

        return $this;
    }

    /**
     * Attribut Ldap "ucbnSecteurDisciplinaire"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return $this
     * @throws Exception
     * @throws LdapException
     */
    public function setUcbnSecteurDisciplinaire($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $value = array_filter($value, function ($v) {
            return preg_match(self::$secteur_disciplinaire_pattern, $v);

        });

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

        return $this;
    }

    /**
     * Attribut Ldap "supannEmpCorps"
     *
     * @param array|string|null $value
     * @param bool $append
     * @return $this
     * @throws Exception
     * @throws LdapException
     */
    public function setSupannEmpCorps($value = null, $append = false)
    {
        $value = $this->preFormat($value);
        $corpsLabel = $this->getLabel('NCORPS');
        $value = array_map(function ($val) use ($corpsLabel) {
            if (is_string($val)) {
                return preg_match("/^$corpsLabel.+$/", $val) ? $val : sprintf('%s%s', $corpsLabel, $val);
            } else {
                return null;
            }
        }, $value);

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

        return $this;
    }

1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
    /**
     * Retourne les structures auxquelles appartiennent la personne
     *
     * @return Structure[]
     */
    public function getEduPersonOrgUnit()
    {
        $structure = $this->getService()->getServiceLocator()->get('ldapServiceStructure');
        $dn = $this->eduPersonOrgUnitDN;
        if (empty($dn)) return null;

        return $structure->getAllBy($dn, 'dn');
    }

    /**
     * Retourne la structure principale à laquelle appartient la personne
     *
     * @return Structure
     */
    public function getEduPersonPrimaryOrgUnit()
    {
        $structure = $this->getService()->getServiceLocator()->get('ldapServiceStructure');
        $dn = $this->eduPersonPrimaryOrgUnitDN;
        if (empty($dn)) return null;

        return $structure->getBy($dn, 'dn');
    }

    /**
     * Retourne la structure d'affectation de la personne
     *
     * @todo à terminer
     * @return Structure[]
     * @throws \Exception
     */
    public function getSupannEntiteAffectation()
    {
        throw new \Exception('Méthode pas finie');
        $structure = $this->getService()->getServiceLocator()->get('ldapServiceStructure');
        $codes = $this->getNode()->getAttribute('supannEntiteAffectation');
        var_dump($codes);

        return $structure->getBy($dn, 'dn');
    }

    /**
     * Retourne la structure d'affectation de la personne
     *
     * @todo à terminer
     * @return Structure
     * @throws \Exception
     */
    public function getSupannEntiteAffectationPrincipale()
    {
        throw new \Exception('Méthode pas finie');
        $structure = $this->getService()->getServiceLocator()->get('ldapServiceStructure');

        $codes = [];
        $affectations = $this->getNode()->getAttribute('supannAffectation');


        list($code, $description) = explode(';', $this->supannAffectation);
        $code = $this->supannAffectation;
        if (empty($dn)) return null;

        return $structure->getBy($dn, 'dn');
    }
}