Osoby

Nastavení detailu osoby v MS

Detail osoby je nyní konfigurovatelný skrze JSON. Systém obsahuje výchozí nastavení zobrazení, které se dá pomocí JSONu upravit. JSON se pak ukládá do Settingu CRM_CUSTOM_MEMBER_DETAIL_VIEW_SETTING

Dostupné zákaznické jsony najdete v adresáři custom-ms-detail-json.

{
  "memberDetailViewSettings": [
    {
      "memberDetailContext": "BREEDING_CLUB", (1)
      "memberType": "CHK", (2)
      "memberSection": "INSTITUTION", (3)
      "tabs": [ (4)
        "crm-member-activities",
        "crm-member-contacts",
        "crm-membership-payments",
        "crm-member-info",
        "crm-member-documents",
        "crm-member-relations",
        "crm-member-acts"
      ]
    }
  ]
}
1 Definice kontextu zobrazení, podle kterého se nastavuje medailonek.
  • PERSON - Fyzická osoba

  • INSTITUTION - Právnická osoba

  • BREEDING_STATION - Chovatelská stanice

  • BREEDING_CLUB - Chovatelský klub

2 Typ osoby, u které se nastavení projeví. Pokud typ obsahuje hodnotu *, jedná se o obecné nastavení bez ohledu na vybraný typ.
3 Definice, zda se má nastavení projevit u FO (PERSON) nebo PO (INSTITUTION)
4 Definice záložek, které se mají zobrazit v detailu. Jedná se o seznam klíčů, které jsou pro jednotlivé záložky definované v kódu.

Výchozí nastavení lze obecně změnit tak, že se pro "memberType": "*" upraví klíče záložek v "tabs": []. Lze změnit i případně "emberDetailContext, pokud bude definovaný v kódu.

Jak nastavit formát členského čísla

Hodnoty formátů členských čísel se ukládají do settingu MEMBER_NUMBER_TYPE k organizaci. Všechny typy kontrolují unikátnost, ale pouze OWN lze ručně editovat/mazat. Při nastavení SEQUENTIAL se čísla automaticky doplňují při vyvtvoření osoby!

  • Výchozí hodnota je SEQUENTIAL.

Členská čísla podle formátu jsou v tuto chvíly řešeny jen u osob. U institucí a assetů se musí funkčnost dodělat.

Tabulka 1. Předdefinované formáty členských čísel
Formát Popis Lze ručně editovat/mazat

SEQUENTIAL

Členské číslo se bude přičítat k poslední hodnotě.

Ne

PATTERN

Členské číslo se bude ukládat v nastaveném formátu.

Ne

OWN

Vlastní číslování bez jakéhokoliv zpracování.

Ano

V případě nastavení formátu SEQUENTIAL musí členské číslo obsahovat čísla. V případě existence znaku bude členské číslo přeskočeno.

Při importu členů s již existujícímí členskými čísly je potřeba nastavit formát na OWN.

Nastavení PATTERNu

Hodnoty patternů členských čísel se ukládají do settingu MEMBER_NUMBER_PATTERN k organizaci.

  • Výchozí hodnota je %04d pro převod zadaného členského čísla na čtyřmístné číslo s nulami na začátku. Např. 0010, 0023, atd.

  • Může obsahovat prefix nebo suffix, např. 006%05d, kde 006 je prefix klubu, zbytek je pětimístné číslo s nulami na začátku. Např. 00601256.

Struktura členství

Tabulka 2. Struktura členství
Typ osoby (Enum) Typ člena (LOV) Členství (LOV)

MEMBER_TYPE_TYPE

MEMBER_TYPE

MEMBERSHIP_TYPE

Basic

-

duplikuje členství

Administrace/Členství

např. Aktivní člen

Dospělý

Dospělý

Golf*

-

Administrace/Číselníky/Typy členů

Administrace/Členství/Typy členství

např. Aktivní člen

Řádné členství

Dospělý - roční

*Navíc doplněno také o Kategorie

MEMBER_TYPE_TYPE
  • Aktivní člen - zelená barva pro aktuální

  • Bývalý člen - červená barva vždy

  • Zájemce - chystáme se změnit na žlutou

  • Nečlen - chystáme se zrušit

  • Instituce - chystáme se zrušit

Jak nastavit Seznam členů pro čtení

Jedná se o portlet CRM MEMBERS VIEWER. Nastavuje se zobrazení sloupců, které se na stránce budou zobrazovat. K seznamu se dá nastavit i filtr, kterů může být použit na sloupce, které se nezobrazují.

Filtry

Jedná se o jednoduchý JSON. Zapisuje se {"Slopec": "Hodnota", …​}. Pokud se filtr nepoužije, načtou se všechny osoby.

  • Základní sloupec - název se zobrazuje v zobrazení sloupců za znakem |. např. Aktuální členství|MEMBERSHIP. Viz. Beagle Club.

  • Sloupec se vztahem - název slupce je relatedMemberFilter, viz. SAA.

  • Sloupce v groupě kontaktů - Název je uložen v atributu field v xhtml sloupce., např. začíná contact-email. Tady se konstruuje název takto: contact-email:LOV_CONTACT_TYPE_UUID.

  • Sloupce v groupě Info - název začíná jako info-type, Tady se konstruuje název takto: info-type:INFO_TYPE_DB_ID.

  • Pokud chci osoby, které mají daný kontaktní typ vyplněný dám do filtru $not_empty (například filtr: "contact-name:CT_CONTACT_ADDRESS":"$not_empty")

Pokud se ve filtru vybírá hodnota, musí být zapsaná jako pole: "MEMBERSHIP": ["Člen", "Zahraniční člen"]

Hodnota pro zobrazení členů v nadřazeném vztahu musí obsahovat id vztahu a směr vztahu: "relatedMemberFilter" : "1111:PARENT". U vztahu musí být povoleno nahlížení, aby se osoba zobrazila v seznamu

Boolean filtr v doplňkovém info je jako výběr, protože obsahuje i filtr na prázdnou hodnotu, proto se musí použít pole: "info-type:1111":["true"]

Editace

Nastavení některých sloupců, které se zobrazí ve formuláři pro rychlou editaci.

Momentálně formulář může obsahovat:

  • Datum narození

  • Status

  • Kontakty - Telefon, Mobil, E-mail z nastaveného typu kontaktu

  • Info - Výběr více hodnot, Datum

Editace je vázaná na oprávnění (akci): Editovat osobu. Tím se určuje kdo může editovat a zobrazí se mu tlačítko Upravit.

Jak nastavit Seznam institucí v MS

Jedná se o portlet CRM Institutions. Který lazy načítá seznam institucí (právnických osob).

Filtry

Jedná se o jednoduchý JSON. Pravidla jsou stejná jako u Seznamu osob pro čtení.

Defaultní zobrazení

Dle textového názvu zobrazení se po načtení tabulky nastaví toto zobrazení (jakoby bylo vybráno v rámci Zobrzaneí tabulky).

Custom odkaz

Jedná se o JSON. Který obsahuje json obejkty pro jednotlivá tlačítka, která se zobrazí v záhlaví tabulky. Stuktura je definována jako:

{"label": "Archiv","url":"https://is-cmku.vrk.cz/group/cmku/archiv-chs"}

ČMKU - založení CHS

Pro potřeby ČMKU je možné v rámci nastavení portletu přepsat tlačítko "Nová instituce" na "Nová CHS". Uživatel poté zadává pouze Název a je automaticky nastaven typ CHS.

Jak zprovoznit stahování členského průkazu

Šablona pro členský průkaz je uložena v Docgenu pod UUID MEMBER_CARD, kde se nachází i globální šablona, která vždy vygeneruje průkaz s PI logem. V případě zákaznických šablon je potřeba šablonu vytvořit:

Šablona se zprovozňuje pomocí settingu crm-extension-member-card, která se musí u organizace nastavit na TRUE. Poté se zobrazí tlačítko Členský průkaz v detailu osoby, v seznamu členů a na kartě člena.

Omezení tlačítka na Kartě člena je navázána na akci DOWNLOAD_MEMBER_CARD pro roli Aktivní členstvíRegular v portletu CRM Member Card.

Nastavení Karty člena

Nastavení portletu Karty člena obsahuje setting, kde se ukládají vybrané typy osob. které nebudou součástí Karty člena. Je to primárně z důvodu, aby se vyřazené osoby zobrazovaly jinde, např. v Kartě chovatelské stanice.

Speciální karty

Karty, které byly odvození z karty člena.

Karta chovatelské stanice

Nastavení portletu obsahuje setting, kde se nastavuje typ osoby, která se na kartě bude zobrazovat. Obsahuje také nastavení záložky Odchovy, který vychází z nastavení AssetVieweru.

Karta chovatele

Nastavení portletu obsahuje setting, kde se vybírá vztah propojení uživatele s právnickou osobou. Obsahuje také nastavení záložky Odchovy, který vychází z nastavení AssetVieweru. Jedná se o portlet určený pro ČMKU.