Zarządzanie usługami Efecte – łączność samoobsługowa Efecte
Zarządzanie usługami Efecte – łączność samoobsługowa Efecte
Tworzenie żądań serwisowych z ESS do ESM
Aby usługa Efecte Self-Service mogła poprawnie tworzyć nowe żądania usług lub sprawdzać ich dostępność, następujące atrybuty i kody atrybutów muszą istnieć i posiadać wartość:
- Efekt efecte_id
- statusAttribute - status
- askedForEmailAttribute – RequestedFor
- serviceItemExternalIdAttribute – ServiceItem. Jeśli wartość tego atrybutu jest pusta, ESS użyje wartości z defaultIntegrationServiceItemId zdefiniowanej w łączniku Efecte Service Management ESS.
Jeżeli którekolwiek z wymaganych pól wymienionych powyżej jest puste , zgłoszenie serwisowe nie zostanie utworzone.
Szczegółowe zasady przetwarzania zgłoszeń serwisowych przedstawiają się następująco:
- WebShopId – jeśli występuje, zostanie wykonana aktualizacja istniejącego zgłoszenia serwisowego
- efecte_id – jeśli WebShopId jest pusty i w ESS nie ma żądania o podanym efecte_id, zostanie utworzone nowe żądanie usługi. Jeśli w ESS istnieje żądanie o podanym efecte_id, zostanie wykonana aktualizacja istniejącego żądania.
- RequestedFor – użytkownik o pasującym adresie e-mail musi znajdować się w danych organizacji w ESS. W przeciwnym razie zgłoszenie serwisowe nie zostanie utworzone.
- OrderedBy – użytkownik o pasującym adresie e-mail musi znajdować się w danych organizacji. W przeciwnym razie zgłoszenie serwisowe nie zostanie utworzone. Jeśli wartość pola jest pusta, zamiast tego zostanie użyty adres e-mail RequestedFor.
- ServiceItem – element usługi o dokładnie tym samym identyfikatorze musi istnieć i być prawidłowy (sprawdzenia są również przeprowadzane w oparciu o kopię roboczą w Efecte Self Service). Jeśli ten warunek nie jest spełniony, zgłoszenie serwisowe nie zostanie utworzone w ESS.
- ServiceOffering – jeśli ustawiony, żądanie usługi zostanie utworzone z podaną nazwą. Jeśli atrybut nie jest ustawiony, nazwa oferty usługi zostanie skopiowana z oferty usługi znalezionej na podstawie elementu ServiceItem w ESS.
- ServiceItemName – jeśli ustawiony, żądanie usługi zostanie utworzone z tą nazwą. Jeśli atrybut nie jest ustawiony, nazwa usługi zostanie skopiowana z elementu usługi znalezionego na podstawie elementu ServiceItem w ESS.
- Cena / Miesięczna Subskrypcja – jeśli ustawione, zgłoszenie serwisowe zostanie utworzone z odpowiednimi danymi. Jeśli atrybut nie jest ustawiony, atrybuty zostaną skopiowane z elementu usługi znalezionego na podstawie elementu ServiceItem.
- Informacje dodatkowe – jeśli wartość atrybutu informacji dodatkowych zaczyna się od „Opis:”, łącznik będzie pobierał tekst po części „Opis:” aż do końca wiersza. Jeśli pole informacji dodatkowych nie zaczyna się od prefiksu „Opis:”, przetworzona zostanie cała zawartość wartości atrybutu.
Otrzymywanie ocen artykułów Knowledge Base od ESS do ESM
Użytkownicy mogą oceniać artykuły z bazy wiedzy w ESS, jeśli ta funkcja jest włączona w ESS. Aby włączyć ocenianie artykułów z bazy wiedzy w ESM, należy wykonać następujące kroki:
- Dodaj atrybut „Ocena” do szablonu artykułu Knowledge Base
- Ustaw AverageHandler na atrybut.
- Nie są potrzebne żadne metadane, ale jeśli chcesz, możesz ustawić maksymalną wartość paska Pro : 1 i Pro paska postępu: wartość. Te ustawienia wyświetlają wartość jako pasek postępu.
- Typ danych: liczba dziesiętna. (Ustawienie obsługi powoduje automatyczną zmianę typu danych przez obsługę).
- Ustaw widoczność: Pokaż tylko w widoku
- Zapisz atrybut
- Przejdź do klasy, w której znajduje się atrybut
- Potwierdź, że atrybut ma kod (powinien zostać nadany automatycznie)
- Skonfiguruj uprawnienia atrybutu
- Upewnij się, że w konfiguracji ESS ocena jest mapowana na ten atrybut
- Utwórz widoki, które wykorzystują atrybut Ocena, aby wyświetlić średnie oceny artykułów Knowledge Base
Pro postępu
Po prawidłowej konfiguracji pasek postępu jest wyświetlany w widoku listy i widoku karty danych. Jest on również widoczny w widokach listy w interfejsie użytkownika mobilnego.

Posiada następujące ustawienia:
- Wzorzec wyjściowy dziesiętny.
- Maksymalna wartość.
- Kod atrybutu dla maksymalnej wartości paska postępu.
- Skala Pro
- Obsługiwane są dwa tryby:
- Wartość
- Procent
Ustawienia administratora dla paska postępu (wyświetlanego w formacie dziesiętnym):

Ogłoszenia dotyczące usług wydawniczych z ESM do ESS
Publikowanie ogłoszeń z ESM do ESS jest realizowane przy użyciu następujących funkcji:
- Słuchacze, którzy wysyłają ogłoszenia z ESM do ESS za pomocą SendDataCardXmlToHttpAction
- Nasłuchiwacz, który ustawia wygaśnięcie ogłoszenia
- Zdarzenie, które uruchamia zapis karty danych po upływie ważności komunikatu. Zapis karty danych uruchamia wspomniany powyżej nasłuchiwacz.

Włączanie powiadomień o usługach w istniejącym środowisku ESM-ESS
Importowanie pakietu konfiguracyjnego
Dostępny jest pakiet konfiguracyjny (efecte-configuration_ESS_ANNOUNCEMENTS.xml), który zawiera szablon komunikatu serwisowego i większość konfiguracji. Ponadto wymienione poniżej pliki są dostępne jako osobne pliki. Zaimportowanie pakietu konfiguracyjnego automatycznie konfiguruje większość ustawień i zmniejsza nakład pracy potrzebny do wykonania poniższych kroków. Pakiet konfiguracyjny można zaimportować za pomocą funkcji Importuj konfiguracje w widoku Konserwacja.
Pakiet zawiera:
- Szablon ogłoszenia o usłudze.
- Słuchacze.
- Wstępnie wypełnione ustawienia platformy, które należy edytować po imporcie.
- Zadanie kolejki komunikatów.
- Zdarzenie wyzwalające wygaśnięcie ogłoszenia.
Jeśli importujesz pakiet, możesz pominąć następujące części:
- Importuj szablon ogłoszenia serwisowego i słuchaczy.
- Skonfiguruj jedno zdarzenie w szablonie ogłoszenia samoobsługowego.
- Część konfiguracji zadania MessageQueue. Należy skonfigurować ustawienia harmonogramu.
Po pomyślnym zaimportowaniu konfiguracji powinieneś otrzymać następujący raport:
Utworzono szablony: 1
Utworzono słuchaczy kart danych: 3
Utworzono foldery: 0
Utworzono role: 0
Utworzono użytkowników: 0
Utworzono raporty: 0
Utworzono Dashboard : 0
Utworzono zadania do harmonogramowania: 1
Utworzono wydarzenia szablonowe: 1
Utworzono uprawnienia: 0
Utworzono ustawienia platformy: 3
Utworzono układy: 0
Poniższe sekcje umożliwiają sprawdzenie poprawności wszystkich konfiguracji oraz uzupełnienie części, które należy skonfigurować ręcznie po zaimportowaniu konfiguracji.
Szablon ogłoszenia usługi importu i słuchacze
- Zaimportuj szablon ogłoszenia serwisowego do ESM za pomocą opcji importowania szablonów.
- ESM_Szablon_ESS_Ogłoszenie_2015_4.xml
- Sprawdź uprawnienia szablonu i wybierz, które role będą miały dostęp do szablonu.
- Utwórz folder „Ogłoszenia serwisowe”, w którym można tworzyć karty danych szablonu. Zezwól na tworzenie kart danych Ogłoszeń serwisowych w tym folderze.
- Zaimportuj te odbiorniki do szablonu komunikatu samoobsługowego:
- 1. ustawia wartość pomocniczą ostatniej akcji: 1_presave.set_Last_Action_For_ESS_Announcement.xml
- 2. wysyła ogłoszenie do ESS: 2_postsave.1.POST_ESS_Announcement_To_ESS.xml
- 3. usuwa ogłoszenie z ESS: 3_postsave.2.DELETE_ESS_Announcement_From_ESS.xml
Wprowadź token API ESS do ustawień platformy ESM
- Jeśli Twoje środowisko działa w chmurze, skontaktuj się z działem obsługi klienta Efecte Service Desk mogą dostarczyć Ci token API ESS, który jest niezbędny do komunikacji ESM-ESS.
- Jeśli środowisko jest lokalne, przejdź do globalnego panelu administracyjnego ESS i wygeneruj tam token API .
- Utwórz nowe ustawienie platformy „ess.token”.
- Ustaw wartość tego ustawienia, kopiując i wklejając token API .
- Można skonfigurować nazwę ustawienia, ale w domyślnym programie nasłuchującym jego nazwa to „ess.token”. Jeśli zmienisz nazwę, zaktualizuj zarówno ustawienie platformy, jak i program nasłuchujący.
Wprowadź ustawienia dzierżawcy ESS do ustawień platformy
- Utwórz nowe ustawienie platformy „ess.tenant”.
- Ustaw nazwę dzierżawcy ESS jako wartość tego ustawienia, np. mycompany.
Wprowadź adres URL ESS do ustawień platformy
- Utwórz nowe ustawienie platformy „ess.announcement.url”.
- W środowisku lokalnym: ustaw adres URL ESS jako wartość tego ustawienia, np. https://mycompany.testefecte.com:55443/announcement
- W chmurze: ustaw adres URL ESS jako wartość tego ustawienia, np. https://mycompany.efectecloud-dev.com/api/ssc/announcement
- Port i nazwa usługi/ogłoszenia pozostają takie same dla wszystkich środowisk ESS.
- Można skonfigurować nazwę ustawienia, ale w domyślnym programie nasłuchującym jego nazwa to „ess.announcement.url”. Jeśli zmienisz nazwę, zaktualizuj zarówno ustawienie platformy, jak i program nasłuchujący.
Włącz ogłoszenia z ESS
- Włącz opcję „Włącz ogłoszenia” w panelu administracyjnym dzierżawy ESS — Ustawienia
Skonfiguruj jedno zdarzenie w szablonie ogłoszenia samoobsługowego

Sprawdź i skonfiguruj zadania harmonogramowane
- Aby wyzwolić zdarzenie, należy skonfigurować EventTask. W większości środowisk jest to możliwe i nie wymaga żadnych zmian.
- Funkcja MessageQueueTask musi być skonfigurowana tak, aby czyścić i ponownie przetwarzać elementy w kolejce. Domyślnie uruchamiana jest co 5 minut.
Sprawdź i skonfiguruj ustawienia sieciowe
Upewnij się, że port ogłoszenia jest dostępny i że nie ma żadnych zapór itp. blokujących połączenia z ESM do środowiska ESS.