GrantTemporaryAccessToCase

Opis

Ta funkcja przyznaje tymczasowy dostęp do sprawy dla użytkownika zewnętrznego.

Ta funkcja przyznaje tymczasowy dostęp do sprawy dla użytkownika zewnętrznego. Wykorzystuje istniejącego niezablokowanego użytkownika zewnętrznego bez organizacji, w razie potrzeby tworzy nowego użytkownika tymczasowego, blokuje użycie adresu e-mail należącego do użytkownika wewnętrznego i zwraca pusty ciąg znaków przy sukcesie albo opis błędu przy niepowodzeniu walidacji. Oprócz preferowanego wariantu z obiektem options funkcja nadal obsługuje historyczne warianty skrócone: 10. argument jest interpretowany jako phoneNumber, gdy jest pojedynczym stringiem bez ’,’ ani ’;’, oraz jako buttonCodes, gdy zawiera ’,’ albo ’;’.

Składnia

GrantTemporaryAccessToCase("email", "firstName", "lastName", "accessFrom", "accessUntil", "subject", "bodyBefore", "bodyAfter", "stages")

Przyznaje tymczasowy dostęp do sprawy dla użytkownika zewnętrznego z określonymi parametrami.

GrantTemporaryAccessToCase("email", "firstName", "lastName", "accessFrom", "accessUntil", "subject", "bodyBefore", "bodyAfter", "stages", options)

Przyznaje tymczasowy dostęp do sprawy z wykorzystaniem obiektu options. To preferowany wariant, gdy chcesz sterować autoryzacją, widocznymi przyciskami, językiem albo załącznikami.

GrantTemporaryAccessToCase("email", "firstName", "lastName", "accessFrom", "accessUntil", "subject", "bodyBefore", "bodyAfter", "stages", "phoneNumber")

Historyczny wariant skrócony. Gdy 10. argument jest pojedynczym stringiem bez ’,’ ani ’;’, zostaje potraktowany jako numer telefonu, a funkcja automatycznie przełącza się na autoryzację telefoniczną.

GrantTemporaryAccessToCase("email", "firstName", "lastName", "accessFrom", "accessUntil", "subject", "bodyBefore", "bodyAfter", "stages", "buttonCodes")

Historyczny wariant skrócony. Gdy 10. argument zawiera ’,’ albo ’;’, zostaje potraktowany jako kody widocznych przycisków bez jawnego numeru telefonu. Na przykład "att;history" oznacza widoczne przyciski, a "777888999" nadal oznacza phoneNumber.

GrantTemporaryAccessToCase("email", "firstName", "lastName", "accessFrom", "accessUntil", "subject", "bodyBefore", "bodyAfter", "stages", "buttonCodes", "phoneNumber")

Historyczny wariant skrócony z jawną listą kodów widocznych przycisków i numerem telefonu, bez obiektu options.

Parametry

email

• Typ: String
• Wymagany: tak

Adres e-mail użytkownika

firstName

• Typ: String
• Wymagany: tak

Imię użytkownika

lastName

• Typ: String
• Wymagany: tak

Nazwisko użytkownika

accessFrom

• Typ: DateWithTime
• Wymagany: tak

Data rozpoczęcia tymczasowego dostępu

accessUntil

• Typ: DateWithTime
• Wymagany: tak

Data zakończenia tymczasowego dostępu

subject

• Typ: String
• Wymagany: tak

Temat wiadomości e-mail

bodyBefore

• Typ: String
• Wymagany: tak

Tekst przed linkiem w wiadomości e-mail

bodyAfter

• Typ: String
• Wymagany: tak

Tekst po linku w wiadomości e-mail

stages

• Typ: String
• Wymagany: tak

Tytuły etapów albo ich nazwy wyświetlane, na których tymczasowy dostęp ma być dostępny. Rozdzielaj wartości przez ’,’ albo ’;’. Nazwy, które nie pasują do żadnego etapu, są ignorowane.

options

• Typ: Object
• Wymagany: nie

Opcje, które można użyć:

Attachments – formuła używana do wybrania załączników sprawy, które zostaną wysłane razem z wiadomością o tymczasowym dostępie.

* all – wyślij wszystkie załączniki

* nazwa pola – wyślij załączniki z pól formularza; pola muszą być typu plik i można podać kilka nazw oddzielonych ’;’

* nazwa szablonu – wyślij załączniki pasujące do szablonu

* nazwa pliku albo wzorzec – wyślij załączniki pasujące do nazwy pliku; gwiazdka '*’ oznacza dowolny ciąg znaków

Phone – numer telefonu używany do dodatkowej autoryzacji telefonicznej.

Authentication – jawny typ dodatkowej autoryzacji. Obsługiwane wartości: Email, Phone, None. Gdy opcja nie jest ustawiona, funkcja wybiera Phone, jeśli podano Phone, w przeciwnym razie wybiera Email.

Language – kod języka / kultury dla użytkownika tymczasowego. Funkcja zwraca błąd, gdy kultura jest nieznana.

Buttons – kody przycisków, które będą widoczne na sprawie z tymczasowym dostępem. Rozdzielaj wartości przez ’;’ albo ’,’.

OBSŁUGIWANE WARTOŚCI: att, sign, print, unread, conn, documentEditing, comm, rem, copy, open, cc, con, history, closecase, priority, casestate, diagram, addfield, connectedcases, attList, commList, signList, repository, assignToMe, caseId.

Jeśli podasz att, comm albo sign, runtime dodatkowo wystawi odpowiadające przyciski list attList, commList i signList.

Wyjaśnienie skrótów:

att – pozwala na dodawanie załączników

sign – pozwala na podpisywanie sprawy

print – pozwala na drukowanie sprawy

unread – pozwala oznaczyć sprawę jako nieprzeczytaną

conn – pozwala dodawać sprawy powiązane

documentEditing – pozwala edytować dokumenty

comm – pozwala na dodawanie komentarzy

rem – pozwala ustawiać przypomnienia

copy – pozwala kopiować sprawę

open – pozwala otwierać sprawę

cc – pozwala dodawać osoby do CC

con – pozwala dodawać osoby do CON

history – pozwala przeglądać historię

closecase – pozwala zamknąć sprawę

priority – pozwala zmieniać priorytet sprawy

casestate – pozwala przeglądać stan sprawy

diagram – pozwala przeglądać diagram procesu

addfield – pozwala dodawać pola

connectedcases – pokazuje listę powiązanych spraw

attList – pokazuje listę załączników

commList – pokazuje listę komentarzy

signList – pokazuje listę podpisów

repository – pokazuje repozytorium

assignToMe – pozwala przypisać sprawę do bieżącego użytkownika

caseId – pokazuje identyfikator sprawy

Zwracana wartość

• Typ: String

Zwraca pusty ciąg znaków, jeśli dostęp został pomyślnie przyznany, w przeciwnym razie zwraca opis błędu, jeśli coś poszło nie tak.

Przykłady

Kandydat uzupełnia kwestionariusz osobowy

Przyznaje kandydatowi tymczasowy dostęp do sprawy, aby mógł uzupełnić kwestionariusz osobowy i dostarczyć wymagane dokumenty rekrutacyjne.

      options.Language = "pl-PL";
      options.Buttons = "open;att;attList;caseId";
      GrantTemporaryAccessToCase("kandydat@outlook.com", "Anna", "Nowak", DateTime("2026-04-01 08:00"), DateTime("2026-04-05 23:59"), "Uzupełnienie danych rekrutacyjnych", "Dziękujemy za udział w rekrutacji. Prosimy o uzupełnienie danych i załączenie wymaganych dokumentów.", "Link wygaśnie automatycznie po upływie terminu.", "Kwestionariusz osobowy", options);

Oczekiwany efekt: Kandydat otrzymuje tymczasowy dostęp ograniczony do etapu kwestionariusza osobowego.

Dostawca uzupełnia ankietę kwalifikacyjną

Przyznaje dostawcy tymczasowy dostęp do sprawy, aby mógł odpowiedzieć na pytania kwalifikacyjne i dołączyć dokumenty wymagane do autoryzacji dostawcy.

      options.Language = "pl-PL";
      options.Buttons = "open;att;attList;caseId";
      GrantTemporaryAccessToCase("kontakt@dostawca.pl", "Piotr", "Wiśniewski", DateTime("2026-04-03 08:00"), DateTime("2026-04-10 18:00"), "Uzupełnienie ankiety dostawcy", "Prosimy o odpowiedź na pytania oraz dołączenie dokumentów wymaganych w procesie autoryzacji dostawcy.", "Po zakończeniu oceny dostępu nie będzie można już użyć.", "Kwalifikacja dostawcy;Ankieta dostawcy", options);

Oczekiwany efekt: Dostawca otrzymuje tymczasowy dostęp ograniczony do etapów kwalifikacji dostawcy.

Klient przekazuje dane do oceny kredytu kupieckiego

Przyznaje klientowi tymczasowy dostęp do sprawy, aby mógł przekazać dane i dokumenty niezbędne do oceny kredytu kupieckiego.

      options.Language = "pl-PL";
      options.Buttons = "open;att;attList;caseId";
      GrantTemporaryAccessToCase("finanse@klient.pl", "Tomasz", "Mazur", DateTime("2026-04-05 08:00"), DateTime("2026-04-12 18:00"), "Uzupełnienie danych do oceny kredytu kupieckiego", "Prosimy o przekazanie wymaganych informacji i dokumentów potrzebnych do oceny limitu kupieckiego.", "Dostęp wygaśnie automatycznie po zakończeniu tego etapu.", "Ocena kredytu kupieckiego", options);

Oczekiwany efekt: Klient otrzymuje tymczasowy dostęp ograniczony do etapu oceny kredytu kupieckiego.

Zewnętrzny radca prawny opiniuje umowę

Przyznaje zewnętrznemu radcy prawnemu tymczasowy dostęp do sprawy, aby mógł przeanalizować dokumenty i wyrazić opinię prawną dotyczącą umowy.

      options.Language = "pl-PL";
      options.Buttons = "open;history;attList;comm;commList;caseId";
      GrantTemporaryAccessToCase("radca@kancelaria.pl", "Karolina", "Wójcik", DateTime("2026-04-06 08:00"), DateTime("2026-04-13 18:00"), "Prośba o opinię prawną", "Udostępniamy sprawę w celu przygotowania opinii prawnej do projektu umowy.", "Prosimy o zamieszczenie uwag i komentarzy w sprawie przed upływem terminu.", "Opinia prawna", options);

Oczekiwany efekt: Radca prawny otrzymuje tymczasowy dostęp ograniczony do etapu opinii prawnej.

Historyczny skrót udostępnia wybrane przyciski bez obiektu options

Używa historycznego wariantu skróconego, aby pokazać wybrany zestaw widocznych przycisków bez obiektu options i bez autoryzacji telefonicznej.

      GrantTemporaryAccessToCase("partner@firma-zewnetrzna.pl", "Marek", "Kaczmarek", DateTime("2026-04-08 08:00"), DateTime("2026-04-10 18:00"), "Podgląd uzgodnień", "Udostępniamy sprawę do wglądu i komentarza.", "Dostęp wygaśnie po zakończeniu uzgodnień.", "Uzgodnienia", "open;history;comm");

Oczekiwany efekt: Użytkownik zewnętrzny otrzymuje tymczasowy dostęp z widocznymi przyciskami open, history i comm, a dodatkowa autoryzacja pozostaje oparta na e-mailu.

Zewnętrzny opiniujący otrzymuje autoryzację SMS i wybrane załączniki

Używa obiektu options, aby wymusić autoryzację telefoniczną i wysłać razem z wiadomością o tymczasowym dostępie tylko wybrane załączniki.

      options.Authentication = "Phone";
      options.Phone = "777888999";
      options.Attachments = "PowerOfAttorney;DraftAgreement";
      options.Buttons = "open;history;attList;caseId";
      GrantTemporaryAccessToCase("reviewer@partner.pl", "Ewa", "Krawczyk", DateTime("2026-04-09 08:00"), DateTime("2026-04-14 18:00"), "Prośba o analizę dokumentów", "Udostępniamy sprawę wraz z wybranymi załącznikami do analizy.", "Kod SMS będzie wymagany przy logowaniu.", "Analiza dokumentów", options);

Oczekiwany efekt: Zewnętrzny opiniujący otrzymuje tymczasowy dostęp z weryfikacją SMS, a wskazane załączniki są dołączone do wiadomości e-mail.

Przypadki użycia

Kandydat rekrutacyjny uzupełnia wymagane formularze

Użyj tej funkcji, gdy kandydat, który nie jest pracownikiem firmy, ma tymczasowo uzyskać dostęp do sprawy rekrutacyjnej w celu uzupełnienia kwestionariusza, odpowiedzi na pytania lub dodania wymaganych dokumentów.

Dostawca uzupełnia dane do kwalifikacji i autoryzacji

Użyj tej funkcji, gdy zewnętrzny dostawca ma odpowiedzieć na pytania kwalifikacyjne, uzupełnić ankietę zgodności lub dodać dokumenty wymagane w procesie autoryzacji dostawcy.

Klient przekazuje dane do oceny kredytu kupieckiego

Użyj tej funkcji, gdy klient spoza organizacji ma tymczasowo uzyskać dostęp do sprawy, aby przekazać dane finansowe, odpowiedzieć na dodatkowe pytania lub dołączyć dokumenty potrzebne do decyzji o kredycie kupieckim.

Zewnętrzny radca prawny wydaje opinię prawną

Użyj tej funkcji, gdy zewnętrzny radca prawny lub kancelaria potrzebuje czasowego dostępu do sprawy, aby przeanalizować dokumenty, dodać komentarze i przygotować opinię prawną.

Starsza reguła zachowuje wybrane widoczne przyciski bez obiektu options

Użyj tego wariantu, gdy utrzymujesz starszą regułę opartą na wariancie skróconym i chcesz zachować wybrany zestaw widocznych przycisków bez natychmiastowej migracji wywołania do obiektu options.

Zewnętrzny opiniujący potrzebuje weryfikacji SMS i wybranych załączników

Użyj tej funkcji, gdy zewnętrzny opiniujący, doradca albo partner ma otrzymać tymczasowy dostęp z autoryzacją telefoniczną i tylko wybranym zestawem załączników potrzebnych do analizy.

Dobre praktyki

• Upewnij się, że podany adres e-mail jest poprawny i nie należy do użytkownika wewnętrznego.
• Sprawdź daty dostępu, aby upewnić się, że nie są w przeszłości.
• Preferuj wariant z obiektem options zamiast historycznych wariantów stringowych dla przycisków / telefonu.
• Jeśli celowo używasz historycznego skrótu buttonCodes, przekaż kody z separatorem ’,’ albo ’;’, aby runtime nie zinterpretował tej wartości jako phoneNumber.
• Jeśli przekazujesz wiele nazw pól plikowych w options.Attachments, rozdziel je średnikiem ’;’, aby runtime potraktował je jako listę pól.
• Używaj opisowych tematów i treści wiadomości e-mail, aby poprawić doświadczenie użytkownika.
• Wyraźnie określ etapy, aby uniknąć przyznania niezamierzonego dostępu.

Typowe błędy

Podanie nieprawidłowego adresu e-mail.

Skutek: Dostęp nie może zostać przyznany, a zwracany jest błąd.

Rozwiazanie: Zweryfikuj adres e-mail przed wywołaniem funkcji.

Ustawienie dat dostępu w przeszłości.

Skutek: Dostęp jest odrzucany, a zwracany jest błąd.

Rozwiazanie: Upewnij się, że daty dostępu są w przyszłości.

Udzielenie tymczasowego dostępu na adres e-mail, który należy już do aktywnego użytkownika wewnętrznego.

Skutek: Funkcja zwraca błąd (Internal user exists with email: ...) i nie przyznaje tymczasowego dostępu.

Rozwiazanie: Użyj adresu e-mail osoby zewnętrznej. Nie używaj tej funkcji dla osób, które mają już wewnętrzne konto AMODIT.

Przekazanie nazw etapów, które nie pasują do żadnego tytułu etapu ani nazwy wyświetlanej.

Skutek: Takie nazwy etapów są ignorowane i przyznany dostęp może nie obejmować oczekiwanych etapów.

Rozwiazanie: Zweryfikuj tytuły etapów / nazwy wyświetlane przed wywołaniem funkcji.

Użycie nieznanego kodu języka w opcjach.

Skutek: Zwracany jest błąd wskazujący, że kultura jest nieznana.

Rozwiazanie: Użyj prawidłowych kodów języka obsługiwanych przez system.

Przekazanie pojedynczego kodu przycisku bez ’,’ ani ’;’ jako 10. argumentu historycznego wariantu skróconego.

Skutek: Runtime interpretuje tę wartość jako phoneNumber, a nie jako buttonCodes, więc widoczne przyciski nie zostaną ustawione zgodnie z intencją.

Rozwiazanie: Użyj preferowanego wariantu z options.Buttons albo przekaż kody przycisków z jawnym separatorem, na przykład "att;history".

Rozdzielenie wielu nazw pól plikowych w options.Attachments przecinkiem ’,’ zamiast średnikiem ’;’.

Skutek: Runtime nie rozpoznaje tej wartości jako listy nazw pól, więc oczekiwane załączniki z pól mogą nie zostać dodane do wiadomości e-mail.

Rozwiazanie: Rozdzielaj wiele nazw pól w options.Attachments średnikiem ’;’, na przykład "PowerOfAttorney;DraftAgreement".