Ustawienia BeeOffice
Ważne
Przed rozpoczęciem działań w zakresie integracji portalu pracowniczego BeeOffice z aplikacją BC, należy dokonać poprawnych ustawień aplikacji.
Ustawienia dotyczące integracji HR and Payroll Manager z BeeOffice znajdują się po przejściu na stronę Ustawienia BeeOffice
Przejście do Ustawienia BeeOffice
W celu przejścia do ustawień BeeOffice:
- Wybierz ikonę
, wprowadź Ustawienia BeeOffice, a następnie kliknij w powiązane łącze. - Otworzy się strona Ustawienia BeeOffice
- Kartoteka ustawień BeeOffice zawiera 3 skrócone karty:
- Nieobecności - Na karcie znajdują się 2 parametry związane z nieobecnościami.
- Formuła daty od dla nieobecności - należy wprowadzić formułę określającą jak stare urlopy aplikacja ma pobierać z BeeOffice. Wprowadzenie np formuły -1M oznacza, że aplikacja będzie pobierać urlopy dodane do BeeOffice miesiąc temu w stosunku do daty systemowej.
- Treść komentarza dla pobieranych urlopów - można (nie wymagane) wstawić komentarz jaki ma się pojawiać w BeeOffice przy zawnioskowanych urlopach, które zostały już pobrane do BC (Business Central).
- Odcinki wypłaty - na karcie znajdują się parametry związane z generowaniem odcinków wypłat. Należy zaznaczyć poszczególne opcje na skróconej karcie jeśli generowany i przesyłany odcinek wypłaty do BeeOffice ma posiadać daną informację.
- PIT - na karcie znajduje sią magazyn raportów PIT - czyli wszystkie dostępne wersje pitów, które mogą być przekazywane do portalu pracowniczego.
Konfiguracja ustawień - kroki do wykonania
- Należy zainstalować aplikację Beeoffice dostępną w sklepie https://integroit.sharepoint.com/sites/HR_PayrollManager
- Ustaw Adres Bazowy dla portalu BeeOffice. Zobacz: Adres bazowy HTTP, punkty końćowe, pary klucz/wartość
- Ustaw Mapowanie Składników pomiędzy BC a Beeoffice. Zobacz: Mapowanie składników
- Ustaw Statusy Urlopów BeeOffice. Zobacz: Statusy urlopów BeeOffice
- Ustaw Akcje Przepływu BeeOffice. Zobacz: Akcje przepływu BeeOffice
- Po skonfigurowaniu podstawowych ustawień przetestuj połączenie. Zobacz: Testuj połączenie
- Po dokonaniu ustawień podstawowych jeśli chcesz skonfigurować ustawienia dotyczące wysyłki pasków płacowych do BeeOffice przejdź do artykułu Ustawienia do odcinków wypłaty
- Jeśli wykorzystywana będzie funkcjonalność wysyłki PITów pracownika do Beeoffice przejdź do artykułu Ustawienia do wysyłki PIT
Adres Bazowy HTTP, punkty końcowe, pary klucz/wartość
Jednym z kroków przy konfiguracji połączenia z BeeOffice jest ustawienie:
- Adresu bazowego HTTP - Zobacz: Adres Bazowy HTTP
- Punktów końcowych - Zobacz: Punkty końcowe
- Pary klucz/wartość - Zobacz: Pary kluczy/wartości
Adres Bazowy HTTP
W celu ustawienia adresu bazowego HTTP dla BeeOffice:
- Wybierz ikonę , wprowadź Adresy bazowy HTTP, a następnie kliknij w powiązane łącze.
- Otworzy się okno Adresy bazowe HTTP
- Z dostępnych na belce akcji wybierz Nowy
- Otworzy się kartoteka adresu bazowego HTTP
- W polu Ścieżka wprowadź: https://app.beeoffice.com/
- W polu Typ wprowadź: Bearer
- W polu Nr punktu końcowego Bearer wybierz z rozwijanej listy np Punkt końcowy Token z wcześniej zdefiniowanych punktów końcowych. (Zobacz: Punkty końcowe)
Punkty końcowe
W celu ustawienia/dodania punktów końcowych HTTP:
- Wybierz ikonę , wprowadź Punkty końcowe HTTP, a następnie kliknij w powiązane łącze.
- Otworzy się strona Punkty końcowe HTTP
- Dodaj Typ zapytania HTTP i jego parametry. Przykład ustawień punktów końcowych HTTP.
Pary kluczy/wartości
Należy ustawić dla jednego typu zapytania HTTP zestaw kluczy. W tym celu:
Wybierz ikonę
, wprowadź Punkty końcowe HTTP, a następnie kliknij w powiązane łącze.Otworzy się strona Punkty końcowe HTTP
Zaznacz punkt końcowy z ścieżką Token
Z dostępnych na belce akcji wybierz Pokaż pary klucz/wartość
Dodaj Klucze/wartości zgodnie z poniższymi wskazówkami:
Klucz Wartość Dodaj do username (należy wprowadzić nazwę użytkownika głównego do logowania się w portalu BeeOffice) Treść grant_type Należy wpisać: password Treść password (należy wpisać hasło którym użytkownik loguje się do portalu BeeOffice) Treść logsys (Należy wpisać nazwę systemu który wpisujemy w trakcie logowania do BeeOffice) Treść
Mapowanie składników
W celu poprawnych ustawień mapowań składników, składniki powinny być wprowadzone zarówno w BC jak i w BeeOffice
Ustawienia mapowania w BC
W tym miejscu znajduje sie lista składników nieobecności wraz z powiązaniami pomiędzy nieobecnościami BeeOffice i składnikami BC.
W celu prześcia na stronę Mapowanie składników BeeOffice:
Wybierz ikonę
, wprowadź Mapowanie składników BeeOffice, a następnie kliknij w powiązane łącze.Otworzy się strona Mapowanie składników BeeOffice
Wprowadź powiązania między składnikami BC i składnikami BeeOffice według poniższego wzoru:
Gdzie:
- Kod składnika BeeOffice - wprowadź kod składnika dostępny w BeeOffice
- Nazwa składnika BeeOffice - wprowadź nazwę składnika w BeeOffice
- Kod składnika BC - określa wartość składnika w Business Central
- Nazwa składnika BC - nazwa składnika w Business Central
- Źródło danych - z rozwijanej listy wybierz czy źródłem danych dla danego składnika jest Beeoffice czy BC. Jeśli wskazane jest źródło danych BeeOffice - dany składnik będzie wprowadzany w BeeOffice i przenoszony do BC. Jeśli żródłem danych będzie BC - dany składnik będzie wprowadzony w BC i przeniesiony do BeeOffice.
- Inicjowane przez - z rozwijanej listy należy wskazać z jakiego miejsca inicjowany jest sładnik. W przypakdu składników dotyczących nieobecności będzie to opcja Nieobecności
Ustawienia składników w BeeOffice
W celu poprawnego zmapowania składników pomiędzy BC a BeeOffice nalezy skonfigurować również odpowiednio składniki w BeeOffice. W tym celu:
Po zalogowaniu się do portalu BeeOffice przejdź w zakładkę Administracja
Wybierz Konfiguracja
Wybierz Czas pracy i wskaż Rodzaje urlopów
Kliknij na ikonę kartki z ołówkiem przy opcji Rodzaje urlopów
Otworzy się okno Konfiguracja urlopów w którym należy skonfigurować składniki
Aby dodać nową nieobecność należy wybrać przycisk Dodaj rekord
Należy uzupełnić pola i zapisać wprowadzony zapis.
Ważne
Istotne jest pole Kod w interfejsie - numer składnika jaki wprowadzimy w tym miejscu musi być tym samym, który wprowadzamy w okienku mapowania w BC w polu Kod składnika BeeOffice. Zobacz: Ustawienia mapowania w BC
Statusy Urlopów BeeOffice
Na stronie Statusy Urlopów BeeOffice należy ustawić występujące statusy urlopowe przy zatwierdzeniach wniosków urlopowych w BeeOffice oraz ustawić urlopy z jakim statusem mają być przetwarzane do BC.
Przed konfiguracją należy ustalić z dostawcą BeeOffice jakie statusy urlopowe będą dostępne z poziomu BeeOffice.
W celu ustawienia statusów:
- Wybierz ikonę , wprowadź Statusy Urlopów BeeOffice, a następnie kliknij w powiązane łącze.
- Otworzy się strona Statusy Urlopów BeeOffice, gdzie należy ustawić statusy według poniższego schematu:
Gdzie:
- ID - wartość identyfikująca dany status
- Nazwa - nazwa statusu w BeeOffice
- Nazwa techniczna - należy wprowadzić nazwę techniczną statusu, którą posługuje się BeeOffice.
Ważne
Spytaj dostawcę BeeOffice o nazwy techniczne!
- Status - z rozwijanej listy wskaż odpowiedni do wprowadzanego zapisu status
- Uzwględnij w filtrze - zaznacz pole jeśli urlop o danym statusie ma być przenoszony z BeeOffice do BC
Akcje przepływu BeeOffice
Należy ustawić akcje przepływu urlopów pomiędzy BC a BeeOffice.
Ważne
Akcje te ustawiane są w zależności od ścieżki akceptacji urlopów jaka ustalona jest w BeeOffice. Ustal w pierwszej kolejności ścieżkę akceptacji wniosków urlopowych w BeeOffice aby następnie na tej podstawie poprawnie skonfigurować przepływy w BC.
Ważne
Jeśli po ustawieniu przepływu, dostawca BeeOffice dokona zmian akcji po stronie portalu pracowniczego, należy zaktualizować ustawione przepływy w BC.
Aby skonfigurować przepływy:
- Wybierz ikonę , wprowadź Akcje Przepływu BeeOffice, a następnie kliknij w powiązane łącze.
- Otworzy się strona Akcje Przepływu BeeOffice, gdzie należy ustawić przepływy według poniższego schematu:
Gdzie:
- ID - wartość identyfikująca dany przepływ
- Nazwa nazwa przepływu
- ID początku łuku - z rozwijanej listy należy wskazać początek łuku. Należy zatem ustalić jaki jest status wniosku urlopowego przed kliknięciem danej akcji. Np. Przy wprowadzaniu nowego wniosku urlopowego ID początku łuku będzie Nowy (Wprowadzony nowy wniosek urlopowy)
- ID końca łuku - z rozwijanej listy należy wskazać koniec łuku. Należy zatem ustalić jaki będzie status wiosku urlopowego po kliknięciu danej akcji. Np. Po wprowadzeniu nowego wniosku urlopowego i po zatwierdzeniu tego wniosku przez przełożonego, wniosek urlopowy będzie miał status Zatwierdzony (wniosek został zatwierdzony)
- Nazwa techniczna początku łuku - nazwa techniczna wprowadzonego ID początku łuku
- Nazwa techniczna końca łuku - nazwa techniczna wprowadzonego ** ID końca łuku**
- Nazwa początku łuku - nazwa początku łuku
- Nazwa końca łuku - nazwa końca łuku
- Waga łuku - określa wagę łuku, która zostanie użyta podczas optymalizacji algorytmu, znajdującego najmniejszy zbiór akcji potrzebnych do wykonania, aby zmienić status urlopowy na inny.
Testuj połączenie
Przed uruchomieniem importu/eksportu danych pomiędzy BC a BeeOffice można przetestować czy wszystkie ustawienia są poprawne i czy system łączy się z BeeOffice.
W tym celu:
- Wybierz ikonę , wprowadź Mapowanie składników BeeOffice, a następnie kliknij w powiązane łącze.
- Otworzy się strona Ustawienia BeeOffice
- Z dostępnych na belce akcji wybierz Powiązane
- Wskaż Testuj połączenie
- Jeśli połączenie zakończy się sukcesem zostanie wyświetlony stosowny komunikat.