Przejdź do treści

ProfessionalGroup (grupa zawodowa)

ProfessionalGroup (grupa zawodowa) to zasób reprezentujący grupę zawodową w ramach firmy – np. pielęgniarki, lekarze, oddziałowe – z hierarchią (partOf) i powiązaniem z podmiotem (organization – Reference Party). Ma identyfikator, name, shortName, symbol, status. Przypisania pracowników do grup opisuje EmployeeProfessionalGroup. Wzorowany na strukturach grup zawodowych w systemach kadrowych.

Rozszerza DomainResource.

1. Zakres i zastosowanie

ProfessionalGroup = jedna grupa zawodowa: identifier, name, shortName, symbol, partOf (grupa nadrzędna), organization (firma/podmiot; podawane, gdy system źródłowy zna podmiot grupy), status. Hierarchia grup przez partOf (np. pielęgniarki → oddziałowe).

  • Struktura grup zawodowych – drzewo ProfessionalGroup po partOf.
  • Przypisania – EmployeeProfessionalGroup łączy pracownika z ProfessionalGroup i dodaje period, employment.

2. Zawartość (struktura)

Oprócz elementów DomainResource (id, resourceType, meta, owner, comment, category, status, type, contained, attribute):

Nazwa Kard. Typ Opis
identifier 0..* Identifier Identyfikatory grupy w przestrzeni wdrożeniowej; system z NamingSystem
shortName 0..1 string Nazwa skrócona
symbol 0..1 string Symbol grupy
partOf 0..1 Reference(ProfessionalGroup) Grupa nadrzędna
organization 0..1 Reference(Party) Podmiot/firma, do której należy grupa
name 0..1 string Nazwa grupy zawodowej

Uwaga: status (z DomainResource) – słownik hr/professional-group-status (active, inactive). attribute (z DomainResource) – kody ze słownika hr/professional-group-attribute-type (professional-group-symbol).

2a. Identyfikatory i operacje

Przestrzeń identyfikatora grupy to urn:oid:1.2.616.1.113769.4.<instalacja>.<klucz> – parametr wdrożenia (zob. Identyfikacja i parametry wdrożenia).

Zasób jest tylko do odczytu.

GET /v1/professional-groups?identifier=<system>|<wartość>&count=20&offset=0
Parametr Wymagany Opis
identifier nie Jedna para system\|wartość (bez list po przecinku)
count, offset nie Paginacja (domyślnie 20 / 0)

Odpowiedź: { "items": [...], "nextToken": null }.

3. Zgodność z systemami ERP

System / kontekst Odpowiednik Uwagi
Struktury grup zawodowych w systemach kadrowych Grupa zawodowa z hierarchią i firmą partOf, organization
SAP / Oracle HCM Job family, Employee group Podobna rola grupowania ról/zawodów

4. Odniesienia