Łącznik Efecte Service Management w pigułce

Za pomocą tego łącznika można korzystać z usługi Efecte Self-Service

• Twórz nowe incydenty i zgłoszenia serwisowe w Efecte Service Management
• Ankieta jest aktualizowana w przypadku zmiany incydentów i żądań serwisowych w Efecte Service Management (na przykład w przypadku zmiany statusu żądania)
• Ankieta i wysyłanie danych o ocenach artykułów w bazie wiedzy w związku z poradami i wskazówkami
• Ankieta i wysyłanie danych o ocenach oraz komentarzy dotyczących nowych pomysłów w związku z funkcją „Polub mój pomysł”
• Ankieta dotycząca dynamicznych danych użytkowników z Efecte Service Management (MyServices)
• Dane ankietowe w celu utrzymania aktualności danych ofert usług (elementy katalogu)
• Wysyłaj decyzje zatwierdzające dla zatwierdzeń wizualnego przepływu pracy w Efecte Service Management
• Prześlij opinie zebrane od użytkowników końcowych do Efecte Service Management

Większość funkcjonalności łącznika działa automatycznie, korzystając z wartości domyślnych, do których odwołujemy się w całym dokumencie.

W tym artykule opisano zachowanie Efecte Service Management Connector w ESS w wersji 2022.3 i nowszych.

Obsługiwane szablony

Konektor Efecte domyślnie obsługuje dwa szablony – Service Request (ServiceRequest) i Incident (incident). W przypadku konieczności obsługi kilku szablonów, dla dzierżawy można wdrożyć wiele konektorów ESM, a miejsce docelowe dla żądań może różnić się od domyślnego. W takim przypadku tylko jeden z konektorów może zawierać bazę wiedzy i, podobnie jak w mojej konfiguracji – w przypadku, gdy wiele konektorów ma skonfigurowany którykolwiek z nich, zestaw wyników, który będzie używany do wyświetlania artykułów na stronie głównej, będzie tym pobranym jako ostatni do Efecte Self-Service, co może prowadzić do mylącego doświadczenia użytkownika, zwłaszcza w przypadku odnośników do różnych źródeł w ESM.

Z drugiej strony, korzystanie z jednego szablonu może być interesujące. Przy odpowiedniej konfiguracji wszystkie żądania mogą być kierowane do żądanego szablonu. Należy jednak zwrócić uwagę na kody atrybutów i wartości statusu oraz na sposoby potencjalnego oddzielenia różnych typów żądań, aby uniknąć generowania nadmiarowych logów z powodu niezgodności konfiguracji.

Format wiadomości ESM

Format wiadomości wymienianych pomiędzy produktami ESS i ESM jest zakodowany na stałe.

Uwaga: Pola wielowartościowe dla funkcji MyService są przekazywane w formacie CSV w tagach xml.

Konfiguracja połączenia

Aby skonfigurować połączenie dla ESM, należy użyć obiektu bean klasy com.efecte.integration.connector.configuration.ConnectionConfiguration, jak w poniższym przykładzie:

<bean id="connectionConfiguration" class="com.efecte.integration.connector.configuration.ConnectionConfiguration"> 
<property name="url" value="https://xxxxxxxxx.efectecloud.com/api/itsm" />
<property name="user" value="webapi-user" />
<property name="password" value="xxxxxxxxxxxxxxxxxxxxxxxxxx" />
<property name="connectionRequestTimeout" value="300" />
<property name="connectTimeout" value="300" />
<property name="socketTimeout" value="300" />
<property name="acceptSelfSignedCertificates" value="false"/>
<property name="allowAllHostnamesInCertificate" value="false"/>
   </bean>

Uwaga! W przypadku używania wielu konektorów, z których niektóre odnoszą się do różnych konfiguracji połączenia (np. różnych środowisk), powinny one mieć unikalny identyfikator dla każdej konfiguracji połączenia. Innymi słowy, upewnij się, że nie masz tego samego identyfikatora beana dla dwóch różnych konfiguracji połączenia. Ta konfiguracja ma zastosowanie w przypadku łączenia się z dwoma różnymi środowiskami ESM z jednego serwera ESS, dlatego dobrym pomysłem może być wskazanie środowiska w identyfikatorze beana, np.

identyfikator fasoli="connectionConfigurationEnvName"

Ten bean obsługuje następujące właściwości:

Konfiguracja żądania serwisowego

Mapowanie atrybutów zgłoszeń serwisowych można zdefiniować w pliku connector-efecte.xml. Przykładowa konfiguracja wszystkich dostępnych opcji:

<bean id="connectorEfecte"
 class="com.efecte.integration.connector.efecte.EfecteConnector">
<property name="serviceRequestAttributes">
<bean class="com.efecte.integration.connector.configuration.ServiceRequestAttributes">
<property name="templateCode" value="ServiceRequest"/>
<property name="bundleTemplateCode" value="ServiceRequestBundle"/>
<property name="folderCode" value="ServiceRequests"/>
<property name="attachmentAttribute" value="RequestAttachments"/>
<property name="statusAttribute" value="status"/>
<property name="reopenReasonAttribute" value="reopen_reason"/> 
<property name="creationDateAttribute" value="created"/>
<property name="deadlineAttribute" value="deadline"/>
<property name="updatedAttribute" value="updated"/>
<property name="efecteIdAttribute" value="efecte_id"/>
<property name="languageAttribute" value="Language"/>
<property name="feedbackAttribute" value="rating"/>
<property name="resolutionTextAttribute" value="resolution"/>
<property name="supportPersonAttribute" value="support_person"/>
<property name="serviceOfferingNameAttribute" value="ServiceOffering"/>
<property name="serviceItemNameAttribute" value="ServiceItemName"/>
<property name="serviceItemExternalIdAttribute" value="ServiceItem"/>
<property name="priceAttribute" value="Price"/>
<property name="monthlySubscriptionAttribute" value="MonthlySubscription"/>
<property name="requestedForAttribute" value="RequestedFor"/>
<property name="costCenterAttribute" value="CostCenter"/>
<property name="deliveryAddressAttribute" value="DeliveryAddress"/>
<property name="orderedByAttribute" value="OrderedBy"/>
<property name="additionalInformationAttribute" value="AdditionalInformation"/>
<property name="siteIDAttribute" value="SiteID"/>
<property name="siteNameAttribute" value="SiteName"/>
<property name="requestBundleAttribute" value="RequestBundle"/>
<property name="requestBundleNameAttribute" value="RequestBundleName"/>
<property name="orderedByEmailAttribute" value="OrderedBy:email"/>
<property name="requestedForEmailAttribute" value="RequestedFor:email"/>
<property name="commentAttribute" value="external_comments"/>
<property name="reasonAttribute" value="user_reason"/>
<property name="dedicatedApproverAttribute" value="DedicatedApprover"/>
<property name="superiorApproverAttribute" value="approving_manager"/>
<property name="totalPriceAttribute" value="totalPrice"/>
 <property name="quantityAttribute" value="quantity"/>
 <property name="totalMonthlySubscriptionAttribute"value="TotalMonthlySubscription"/>
  <property name="punchout" value="punchOutOrderId"/>
</bean>
 </property>
 <!-- other configuration -->
</bean> 

Mapowanie incydentów można dostosować za pomocą interfejsu administratora dzierżawy, zakładki konfiguracji kanału wsparcia. Po utworzeniu nowego kanału wsparcia, w konfiguracji można zaobserwować wartości domyślne.

Szczegółowe zasady przetwarzania właściwości żądań serwisowych są następujące:

Jeżeli w ofercie serwisowej wybrano opcję „Włączona ilość pozycji”, dla żądania serwisowego przetwarzane są następujące dodatkowe reguły:

Uwaga! Atrybuty wymienione powyżej są wartościami domyślnymi. W przypadku konieczności ich zmiany, należy wprowadzić odpowiednie kody w pliku łącznika.

Funkcjonalność PunchOut umożliwia użytkownikom Efecte Self-Service korzystanie z zewnętrznego sklepu internetowego w celu gromadzenia pozycji do zgłoszenia serwisowego. Do działania funkcji PunchOut wymagane są następujące atrybuty w łączniku. Więcej informacji można znaleźć w uid konfiguracji PunchOut.

Złącze śledzące

Łącznik śledzenia uruchamia odpytywanie o aktualizacje z Efecte Service Management zarówno dla incydentów, jak i zgłoszeń serwisowych. Domyślne mapowanie domeny dla incydentów pochodzących z ESM do ESS oraz mapowanie pozycji usługi dla zgłoszeń serwisowych można skonfigurować, ustawiając następujące właściwości beana EfecteTrackingConnector:

Uwaga! Domyślnie odpytywane są incydenty, a nie żądania serwisowe. Aby odpytywać również żądania serwisowe, do pliku łącznika należy dodać łącznik Efecte Tracking.

Aby nowe sondowanie żądań usługi działało prawidłowo, po stronie ESM obowiązkowe są następujące atrybuty:

• Identyfikator żądania przekazywany w atrybucie efecteIdAttribute, domyślnie „efecte_id”
• Status przekazywany w statusAttribute.default 'status'
• Identyfikator klienta przekazywany w atrybucie askedForEmailAttribute, domyślnie „RequestedFor:email”
• Identyfikator elementu przekazywany w atrybucie serviceItemExternalIdAttribute, domyślnie „ServiceItem” — jeśli wartość tego atrybutu jest pusta, łącznik przyjmie wartość z atrybutu defaultIntegrationServiceItemId w konfiguracji łącznika śledzenia

Aby nowe sondowanie incydentów działało prawidłowo, po stronie ESM obowiązkowe są następujące atrybuty:

• Identyfikator incydentu przekazywany w atrybucie efecteIdAttribute, domyślnie „efecte_id”
• Status przekazywany w statusAttribute.default 'status'
• Identyfikator klienta przekazywany w atrybucie e-mail klienta, domyślnie klient:email
• Identyfikator kategorii przekazywany w integrationCategoryAttribute, domyślnie WebShopCategory — jeśli wartość tego atrybutu jest pusta, łącznik przyjmie wartość z defaultIntegrationCategoryId w konfiguracji łącznika śledzącego (kategoria z identyfikatorem kategorii musi zostać opublikowana w ESS)

Częstotliwość sondowania można dostosować za pomocą właściwości „updateFrequency” i „errorUpdateFrequency” klasy „EfecteTrackingConnector”. Wartości są wyrażone w konfigurowalnych jednostkach.

Uwaga! Zmiana domyślnego parametru „updateQuerySlidingWindowTime” jest bardzo rzadka. Dane z sondowania zawsze będą obejmować wszystkie karty danych, które zostały zmienione w danym okresie, a w dłuższym okresie te same zgłoszenia będą wielokrotnie zwracane do zestawu wyników. Już przy pierwszym podejściu zgłoszenie zostanie zaktualizowane w ESS. Rozszerzenie tego okna może potencjalnie spowolnić działanie zarówno w ESS, jak i ESM, bez żadnych dodatkowych korzyści.

Podczas pierwszego uruchomienia łącznika zostaną pobrane żądania i incydenty z ostatnich 24 godzin. Czas ten można dostosować, konfigurując właściwości initialQuerySlidingWindowTime i initialQuerySlidingWindowUnit.

Inne wartości domyślne dla łącznika Efecte Tracking Connector to:

Przykład konfiguracji:

<property name="efecteTrackingConnector">
     <bean class="com.efecte.integration.connector.efecte.EfecteTrackingConnector">
         <property name="updateQuerySlidingWindowTime" value="20"/>
         <property name="updateQuerySlidingWindowUnit" value="MINUTES"/>
         <property name="initialQuerySlidingWindowTime" value="1"/>
         <property name="initialQuerySlidingWindowUnit" value="DAYS"/>
         <property name="updateFrequency" value="10" />
         <property name="updateFrequencyUnit" value="MINUTES" />
         <property name="errorUpdateFrequency" value="10" />
         <property name="errorUpdateFrequencyUnit" value="MINUTES" />
         <property name="defaultIntegrationServiceItemId" value="DEFAULT_SERVICE_ITEM" />
         <property name="pollNewServiceRequestEnabled" value="false" />
         <property name="defaultIntegrationCategoryId" value="DEFAULT_EFECTE_CATEGORY"/>
         <property name="serviceRequestPollCondition" value="and $creator$ = 'WebAPI'"/>
         <property name="incidentPollCondition" value="and $creator$ = 'WebAPI'"/>
         <property name="pollNewIncidentEnabled" value="true" />
      </bean>
</property>

Jeśli właściwość „updateQuerySlidingWindowTime” nie jest skonfigurowana w złączu śledzącym, jako domyślny rozmiar okna przesuwnego zostanie użyta wartość „pollingInterval” pomnożona przez dwa (2).

Formularz opinii

Formularz opinii jest domyślnie obsługiwany w łączniku ESM. Atrybuty używane do mapowania na pola ESM można skonfigurować, dostosowując właściwości klasy bean EfecteFeedbackFormConnector oraz w samym formularzu za pośrednictwem interfejsu administratora, zakładki Zarządzanie opiniami. Obsługiwane są następujące właściwości:

Przykładowa konfiguracja EfecteFeedbackFormConnector wewnątrz EfecteConnector w pliku connector-efecte.xml:

<bean id="defaultConnectorEfecte" class="com.efecte.integration.connector.efecte.EfecteConnector">
<property name="connectionConfiguration" ref="connectionConfiguration" />
<property name="feedbackFormConnector">
<bean class="com.efecte.integration.connector.efecte.EfecteFeedbackFormConnector">
<property name="feedbackAttributes">
<bean class="com.efecte.integration.connector.configuration.FeedbackAttributes">
<property name="templateCode" value="feedback_management" />
<property name="folderCode" value="feedback" />
<property name="efecteIdAttribute" value="ticket_id" />
<property name="customerAttribute" value="customer" />
<property name="ratingAttribute" value="ticket_rating" />
</bean>
</property>
</bean>
 </property>
</bean>

Porady i wskazówki

Ta funkcja umożliwia importowanie Knowledge Base z systemu Efecte Service Management. Więcej szczegółów można znaleźć w uid ConfiguringTipsTricks dotyczącym kompleksowej konfiguracji.

Konfiguracja pakietu integracyjnego

Wszystkie pliki konfiguracyjne pakietu Integration Suite znajdują się w katalogu /etc/integration-hub/ i jego podkatalogach. Konektory specyficzne dla dzierżawcy znajdują się w podkatalogach tenant-configs/{tenant_name}.

Aby skonfigurować obsługę „Wskazówek i trików” w pakiecie Integration Suite, należy edytować plik connector-efecte.xml. Dodać bean klasy „EfecteKnowledgeBaseConnector” i podać mu bean konfiguracji połączenia ESM.

<bean id="connectionConfiguration"
 class="com.efecte.integration.connector.configuration.ConnectionConfiguration">
 <property name="url" value=" http://efecte.efecte.com/efecte " />
 <property name="user" value="webapi-user" />
 <property name="password" value="PASSWORD" />
</bean>

<bean id="efecteKnowledgeBaseConnector" class="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
 <property name="connectionConfiguration" ref="connectionConfiguration"/>
</bean>

Uwaga! Dobrą praktyką jest współdzielenie konfiguracji połączenia między łącznikami Efecte, dlatego poniżej znajduje się poniższy kod (często używany w konfiguracjach):

<bean id="defaultConnectorEfecte" class="com.efecte.integration.connector.efecte.EfecteConnector">
 <property name="connectionConfiguration">
<bean class="com.efecte.integration.connector.configuration.ConnectionConfiguration">
<property name="url" value="http://efecte.company.com" />
<property name="user" value="webapi-user" />
<property name="password" value="PASSWORD" />
</bean>
 </property>
</bean>

można zastąpić:

<bean id="defaultConnectorEfecte" class="com.efecte.integration.connector.efecte.EfecteConnector">
 <property name="connectionConfiguration" ref="connectionConfiguration"/>
</bean>

Konfigurowanie parametrów szablonu bazy wiedzy

Aby dostosować nazwy atrybutów używanych w ESM do obsługi Knowledge Base , parametry szablonu można skonfigurować, dodając właściwość knowledgeBaseAttributes do beana efecteKnowledgeBaseConnector. W przeciwnym razie zostaną użyte ustawienia domyślne.

<bean id="efecteKnowledgeBaseConnector" class="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
<property name="connectionConfiguration" ref="connectionConfiguration"/>
<property name="knowledgeBaseAttributes" >
<bean id="knowledgeBaseAttributes" class="com.efecte.integration.connector.configuration.KnowledgeBaseAttributes">
<property name="templateCode" value="knowledge_base_article"/>
<property name="pollingFolderCode" value="knowledge_base"/>
<property name="updateReadStatsFallbackFolderCode" value="knowledge_base"/> 
<property name="ratingFallbackFolderCode" value="knowledge_base"/>
 <property name="publishedInEssAttr" value="published_in_self_service"/>
<property name="publishedInEssValue" value="Yes"/>
<property name="deletedAttr" value="deleted"/>
<property name="nameAttr" value="solution_name"/>
<property name="descriptionAttr" value="solution_description"/>
<property name="categoryAttr" value="category"/>
 <property name="adGroupsAttr" value="ad_groups"/>
<property name="efecteIdAttr" value="efecte_id"/>
<property name="updatedAttr" value="updated"/>
<property name="ratingAttr" value="rating"/>
<property name="rankingAttr" value="rating"/>
<property name="readStatsAttr" value="read_count"/>
<property name="keywordsAttr" value="solution_keywords"/>
<property name="keywordsSeparator" value=","/> 
</bean>
</property>
</bean>

Obsługiwane są następujące właściwości klasy bean KnowledgeBaseAttributes:

publishedInEssAttr

published_in_self_service

publishedInEssValue

Yes

deletedAttr

deleted

nameAttr

solution_name

descriptionAttr

solution_description

categoryAttr

category

adGroupsAttr

ad_groups

efecteIdAttr

efecte_id

updatedAttr

updated

ratingAttr

rating

rankingAttr

rating

readStatsAttr

read_count

keywordsAttr

solution_keywords

keywordsSeparator

,

Konfigurowanie częstotliwości aktualizacji „Porad i trików”

Domyślnie, jeśli nie wystąpi żaden błąd, baza wiedzy będzie aktualizowana co 2 godziny. W przypadku wystąpienia błędu, czas odświeżania zostanie zmieniony na 2 minuty.

Opóźnienie rozpoczęcia harmonogramu (czas, po którym łącznik zacznie działać, mierzony od momentu uruchomienia huba integracyjnego) można skonfigurować przy użyciu właściwości startUpDelay dla beana connectorScheduler w pliku hub.xml.

Przykład z hub.xml:

<bean name="connectorScheduler" class="com.efecte.integration.container.ConnectorScheduler">
   <property name="taskScheduler" ref="taskScheduler"/>
    <property name="startUpDelay" value="20000"/>
</bean> 

Częstotliwość aktualizacji i zgłaszania błędów można skonfigurować w konfiguracji XML złącza (connector-efecte.xml). Proszę użyć następujących właściwości:

Przykład z pliku connector-efecte.xml:

<bean id="efecteKnowledgeBaseConnector" class="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
 <property name="connectionConfiguration" ref="connectionConfiguration"/>
 <property name="updateFrequency" value="30"/>
 <property name="updateFrequencyUnit" value="SECONDS"/>
</bean>

Podoba mi się mój pomysł

Funkcja ta umożliwia wyświetlanie i komentowanie pomysłów zapisanych w systemie Efecte Service Management.

Wszystkie pliki konfiguracyjne pakietu Integration Suite znajdują się w katalogu /etc/integration-hub/ i jego podkatalogach. Konektory specyficzne dla dzierżawcy znajdują się w podkatalogach tenant-configs/{tenant_name}.

Aby skonfigurować obsługę opcji „Lubię mój pomysł” w pakiecie Integration Suite, należy edytować plik connector-efecte.xml. Dodaj „ http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd " lokalizacje schematów do definicji głównych beanów.

<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd">

Dodaj element „annotation-config” oraz bean klasy „EfecteLikeMyIdeaConnector” i przekaż mu bean konfiguracji połączenia ESM. Dodaj również jeden bean typu „EfecteConnectorContext”.

<bean id="efecteLikeMyIdeaConnector" class="com.efecte.integration.connector.efecte.EfecteLikeMyIdeaConnector" autowire="constructor">
<property name="connectionConfiguration" ref="connectionConfiguration"/>
<property name="likeMyIdeaAttributes" >
<bean id="likeMyIdeaAttributes" class="com.efecte.integration.connector.configuration.LikeMyIdeaAttributes">
<property name="nameAttr" value="demand_name"/>
<property name="ratingFallbackFolderCode" value="ideas"/>
<property name="descriptionAttr" value="demand_details"/>
<property name="efecteIdAttr" value="efecte_id"/>
<property name="createdAttr" value="created"/>
<property name="likesAttr" value="likes"/>
<property name="dislikesAttr" value="dislikes"/>
<property name="templateCode" value="ideas"/>
<property name="pollingFolderCode" value="ideas"/>
<property name="deletedAttr" value="deleted"/>
<property name="commentsAttr" value="comment"/>
<property name="publishedInEssAttr" value="publish_for_rating" />
<property name="publishedInEssValue" value="Yes" />
</bean>
</property>
</bean>

Obsługiwane są następujące właściwości klasy bean LikeMyIdeaAttributes:

publishedInEssAttr

publish_for_rating

publishedInEssValue

Yes

deletedAttr

deleted

created

created

nameAttr

demand_name

descriptionAttr

demand_details

efecteIdAttr

efecte_id

likesAttr

likes

dislikesAttr

dislikes

commentsAttr

comment

Konfigurowanie częstotliwości aktualizacji „Lubię mój pomysł”

Domyślnie, jeśli nie wystąpi żaden błąd, „Lubię moje pomysły” będzie aktualizowane co 2 godziny. W przypadku wystąpienia błędu, czas odświeżania zostanie zmieniony na 2 minuty.

Opóźnienie rozpoczęcia harmonogramu (czas, po którym konektor zacznie działać, mierzony od uruchomienia centrum integracji) można skonfigurować za pomocą właściwości startUpDelay dla beana connectorScheduler w pliku hub.xml. Prosimy o zapoznanie się z instrukcjami w sekcji „Wskazówki i porady”.

Częstotliwość aktualizacji i zgłaszania błędów można skonfigurować w konfiguracji XML złącza (connector-efecte.xml). Proszę użyć następujących właściwości:

Przykład z pliku connector-efecte.xml:

<bean id="efecteLikeMyIdeaConnector" class="com.efecte.integration.connector.efecte.EfecteLikeMyIdeaConnector">
<property name="connectionConfiguration" ref="connectionConfiguration"/>
<property name="updateFrequency" value="30"/>
<property name="updateFrequencyUnit" value="SECONDS"/>
</bean>

Moje usługi

Moje Usługi to powszechna nazwa zbioru mechanizmów integracyjnych umożliwiających zewnętrznym systemom dynamiczną modyfikację zawartości katalogu widocznej dla użytkowników.

Definiowanie pól MyServices

1. Przejdź do strony administracyjnej ESS -> Integracje -> Pola danych zewnętrznych
2. Naciśnij przycisk Dodaj pole Moje usługi
3. Wprowadź konfigurację
   • Nazwa pola — wprowadź nazwę, która będzie używana jako alias dla tego pola MyServices
   • Dane z - wybierz łącznik Efecte Service Management
   • Dane szablonu z Efecte Service Management zamapowane na pole MyServices (Zaloguj się do Efecte Service Management -> Administracja -> Szablony -> wybierz szablon)
     • Kod folderu – opcjonalny, ogranicza elementy do pobrania do zdefiniowanego folderu
     • Kod szablonu – wypełnij wartością użytkową z kodu szablonu
     • Kod atrybutu nazwy – kod atrybutu używany jako nazwa (ten atrybut może być widoczny dla użytkownika)
     • Kod atrybutu ID technicznego – kod atrybutu używany jako identyfikator DataCard (powinien być oznaczony jako atrybut podstawowy w ESM)

• Kod atrybutu użytkownika — odniesienie do szablonu opisującego użytkownika powiązanego z tym szablonem (szablon docelowy musi mieć atrybut e-mail, aby powiązania użytkowników działały prawidłowo)

1. Kliknij przycisk Aktualizuj - jeśli nie ma błędów, w tabeli elementów pól MyServices powinny być widoczne nazwy kart DataCards z Efecte Service Management
   1. Można to sprawdzić, przeglądając tabelę z kartami danych powiązanymi z wybranym szablonem w ESM

Mój katalog usług i ofert

Wpis MyService jako źródło identyfikatorów pozycji usług

1. Na stronie administratora otwórz zakładkę Usługi i wybierz pozycję usługi w ofercie usługi

2. W oknie Właściwości elementu otwórz menu rozwijane Łącze danych zewnętrznych i wybierz nazwę pola Dane zewnętrzne
3. Z listy rozwijanej „Identyfikator elementu” wybierz potrzebny element.

Identyfikator wybranego elementu będzie używany jako ItemID podczas składania zamówienia na dany element.

Powiązania między użytkownikami i kartami danych

Łącznik nie tylko odpowiada za pobieranie informacji z kart DataCard, ale także za:

• śledzenie powiązań między kartami danych a użytkownikami
• zmieniając wspomniane skojarzenia

Aby skorzystać z tej funkcjonalności:

1. Na stronie administratora otwórz Usługę i wybierz Element usługi

2. W oknie Właściwości elementu usługi otwórz rozwijaną listę Łącze Moje usługi i wybierz nazwę pola Moje usługi

1. Z listy rozwijanej Podelementy wybierz:
   1. Użytkownik używający – w tym przypadku użytkownikowi zostanie wyświetlona lista kart danych, z którymi jest powiązany
2. Użytkownik nieużywany – w tym przypadku użytkownikowi zostanie wyświetlona lista kart danych, z którymi nie jest powiązany

Złożenie zamówienia na pozycję serwisową spowoduje:

1. Usuwanie
2. Dodawanie

powiązanie między złożeniem zamówienia przez użytkownika a kartą DataCard

Katalogi przedmiotów

Podczas konfigurowania pozycji katalogu obsługiwane są następujące typy danych atrybutów ESM

Próbka złącza

<beans xmlns="http://www.springframework.org/schema/beans"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
        http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd">
    <bean id="connectionConfiguration" class="com.efecte.integration.connector.configuration.ConnectionConfiguration">
         <property name="url" value="https://xxxxxxxxx.efectecloud.com/api/itsm" />
         <property name="user" value="WebAPI" />
         <property name="password" value="xxxxxxxxxxxxxxxxxxxxxxxxxx" />
         <property name="connectionRequestTimeout" value="300" />
         <property name="connectTimeout" value="300" />
         <property name="socketTimeout" value="300" />
         <!--property name="acceptSelfSignedCertificates" value="true"/>
         <property name="allowAllHostnamesInCertificate" value="true"/-->
     </bean>
<bean id="defaultConnectorEfecte" class="com.efecte.integration.connector.efecte.EfecteConnector">
         <property name="connectionConfiguration" ref="connectionConfiguration" />
        <!-- property name="generalConfiguration"> NOT RECOMMENDED TO BE CHANGED
             <bean class="com.efecte.integration.connector.configuration.GeneralConfiguration">
                 <property name="dateTimeFormat" value="yyyy-MM-dd HH:mm:ss z"/>
                 <property name="integrationIdAttribute" value="WebShopId"/>
                <property name="integrationCategoryAttribute" value="WebShopCategory"/>
             </bean>
         </property -->
        <!-- property name="serviceRequestAttributes">
           <bean class="com.efecte.integration.connector.configuration.ServiceRequestAttributes">
              <property name="templateCode" value="ServiceRequest"/>
              <property name="bundleTemplateCode" value="ServiceRequestBundle"/>
              <property name="folderCode" value="ServiceRequests"/>
              <property name="attachmentAttribute" value="RequestAttachments"/>
              <property name="statusAttribute" value="status"/>
              <property name="reopenReasonAttribute" value="reopen_reason"/> 
              <property name="creationDateAttribute" value="created"/>
              <property name="deadlineAttribute" value="deadline"/>
              <property name="updatedAttribute" value="updated"/>
              <property name="efecteIdAttribute" value="efecte_id"/>
              <property name="languageAttribute" value="Language"/>
              <property name="feedbackAttribute" value="rating"/>
              <własność nazwa="resolutionTextAttribute" wartość="rozdzielczość"/>
              <własność nazwa="supportPersonAttribute" wartość="osoba_wspierająca"/>
              <własność nazwa="serviceOfferingNameAttribute" wartość="OfertaUsług"/>
              <własność nazwa="serviceItemNameAttribute" wartość="NazwaElementuUsługi"/>
              <własność nazwa="serviceItemExternalIdAttribute" wartość="Pozycjausługi"/>
              <własność nazwa="priceAttribute" wartość="Cena"/>
              <własność nazwa="atrybutMiesięcznejAskrypcji" wartość="Miesięcznasubskrypcja"/>
              <własność nazwa="requestedForAttribute" wartość="Zapytanoo"/>
              <własność nazwa="atrybutCenterkosztów" wartość="CentrumKosztów"/>
              <własność nazwa="atrybutadresudostawy" wartość="Adresdostawy"/>
              <własność nazwa="uporządkowanewedługatrybutu" wartość="Zamówioneprzez"/>
              <własność nazwa="atrybutinformacjidodatkowych" wartość="Dodatkoweinformacje"/>
              <własność nazwa="atrybutID_site" wartość="Identyfikatorwitryny"/>
              <własność nazwa="atrybutNazwyStrony" wartość="NazwaWitryny"/>
              <własność nazwa="requestBundleAttribute" wartość="RequestBundle"/>
              <własność nazwa="requestBundleNameAttribute" wartość="NazwaPakietuŻądania"/>
              <własność nazwa="orderByEmailAttribute" wartość="Zamówioneprzez:e-mail"/>
              <własność nazwa="requestedForEmailAttribute" wartość="RequestedFor:email"/>
              <własność nazwa="atrybutkomentarza" wartość="komentarze_zewnętrzne"/>
              <własność nazwa="atrybutpowodu" wartość="powód_użytkownika"/>
              <własność nazwa="dedicatedApproverAttribute" wartość="DedykowanyZatwierdzający"/>
              <własność nazwa="superiorApproverAttribute" wartość="zatwierdzający_menedżer"/>
              <własność nazwa="totalPriceAttribute" wartość="cenacałkowita"/>
              <własność nazwa="atrybutilości" wartość="ilość"/>
              <własność nazwa="totalMonthlySubscriptionAttribute" wartość="Całkowitamiesięcznasubskrypcja"/>
          </fasola>
      </własność -->
     <!-- nieruchomość nazwa="atrybutyodpowiedzizatwierdzenia"> NIE ZALECONY DO BYĆ ZMIENIONO
          <fasola klasa="com.efecte.integration.connector.configuration.ApprovalResponseAttributes">
              <własność nazwa="kodszablonu" wartość="zatwierdzenie"/>
              <własność nazwa="kodfolderu" wartość="zatwierdzenia"/>
              <własność nazwa="efecteId" wartość="efecte_id"/>
              <własność nazwa="actualApprover" wartość="RzeczywistyZatwierdzający"/>
              <własność nazwa="Decyzjazatwierdzenia" wartość="DecyzjaZatwierdzenia"/>
              <własność nazwa="powód" wartość="Powód"/>
              <własność nazwa="esmApprovedCode" wartość="zatwierdzono"/>
              <własność nazwa="esmRejectedCode" wartość="odrzucono"/>
          </fasola>
      </własność -->
     <!-- nieruchomość name="efecteTrackingConnector">
          <fasola class="com.efecte.integration.connector.efecte.EfecteTrackingConnector">
              <własność nazwa="updateQuerySlidingWindowTime" wartość="20"/>
              <własność nazwa="updateQuerySlidingWindowUnit" wartość="MINUTY"/>
              <własność nazwa="initialQuerySlidingWindowTime" wartość="1"/>
              <własność nazwa="initialQuerySlidingWindowUnit" wartość="DNI"/>
              <własność nazwa="updateFrequency" wartość="10" />
              <własność nazwa="updateFrequencyUnit" wartość="MINUTY" />
              <własność nazwa="errorUpdateFrequency" wartość="10" />
              <własność nazwa="errorUpdateFrequencyUnit" wartość="MINUTY" />
              <własność nazwa="defaultIntegrationServiceItemId" wartość="DEFAULT_SERVICE_ITEM" />
              <własność nazwa="pollNewServiceRequestEnabled" wartość="fałsz" />
             <własność nazwa="domyślnyIdentyfikatorKategoriiIntegracji" wartość="DOMYŚLNA_KATEGORIA_EFEKTU"/>
              <własność nazwa="serviceRequestPollCondition" wartość="i Twórca = „PortalSefService”
              <własność nazwa="incidentPollCondition" wartość="i Twórca = 'Sklepinternetowy'"/>
          </fasola>
      </własność -->
     <!-- nieruchomość nazwa="feedbackFormConnector">
           <fasola class="com.efecte.integration.connector.efecte.EfecteFeedbackFormConnector">
              <własność nazwa="atrybutyfeedback">
                     <fasola klasa="com.efecte.integration.connector.configuration.FeedbackAttributes">
                         <własność nazwa="kodszablonu" wartość="zarządzanie_informacjami_zwrotnymi" />
                         <własność nazwa="kodfolderu" wartość="informacjazwrotna" />
                         <własność nazwa="efecteIdAttribute" wartość="id_biletu" />
                         <własność nazwa="atrybutklienta" wartość="klient" />
                         <własność nazwa="atrybutoceny" wartość="ocena_biletu" />
                     </fasola>
               </własność>
           </fasola>
       </własność --> 
     </fasola>
<fasola id="efecteKnowledgeBaseConnector" class="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
    <własność nazwa="konfiguracjapołączenia" ref="konfiguracjapołączenia"/>
    <własność nazwa="atrybutybazywiedzy" >
           <fasola id="atrybutybazywiedzy" klasa="com.efecte.integration.connector.configuration.KnowledgeBaseAttributes">
                 <własność nazwa="kodszablonu" wartość="artykuł_bazy_wiedzy"/>
                 <własność nazwa="pollingFolderCode" wartość="baza_wiedzy"/>
                 <własność nazwa="updateReadStatsFallbackFolderCode" wartość="baza_wiedzy"/>
                 <własność nazwa="ratingFallbackFolderCode" wartość="baza_wiedzy"/>
                 <własność nazwa="publishedInEssAttr" wartość="opublikowano_w_samoobsłudze"/>
                 <własność nazwa="publishedInEssValue" wartość="Tak"/>
                 <własność nazwa="deletedAttr" wartość="usunięto"/>
                 <własność nazwa="nameAttr" wartość="nazwa_rozwiązania"/>
                 <własność nazwa="descriptionAttr" wartość="opis_rozwiązania"/>
                 <własność nazwa="categoryAttr" wartość="kategoria"/>
                 <własność nazwa="efecteIdAttr" wartość="efecte_id"/>
                 <własność nazwa="updatedAttr" wartość="zaktualizowano"/>
                 <własność nazwa="ratingAttr" wartość="ocena"/>
                 <własność nazwa="rankingAttr" wartość="ocena"/>
                 <własność nazwa="readStatsAttr" wartość="liczba_odczytów"/>
                 <własność nazwa="keywordsAttr" wartość="słowa_kluczowe_rozwiązania"/>
                 <własność nazwa="Separatorsłówkluczowych" wartość=","/>
             </fasola>
       </własność>
    </fasola>
</fasola>