Efecte Service Management Connector auf den Punkt gebracht

Mit Hilfe dieses Konnektors kann Efecte Self-Service

• Erstellen Sie neue Vorfälle und Serviceanfragen in Efecte Service Management
• Abfrageaktualisierungen, wenn Vorfälle und Serviceanfragen in Efecte Service Management geändert werden (z. B. wenn der Anfragestatus geändert wird)
• Abfrage und Senden von Bewertungsdaten zu Wissensdatenbank-Artikeln im Zusammenhang mit Tipps & Tricks
• Umfragen durchführen und Bewertungsdaten und Kommentare zu neuen Ideen im Rahmen von „Like My Idea“ einsenden
• Abfrage dynamischer Benutzerdaten von Efecte Service Management (MyServices)
• Abfragedaten zur Pflege von Serviceangebotsdaten bis zu Daten (Katalogartikel)
• Senden Sie Genehmigungsentscheidungen für visuelle Workflow-Genehmigungen in Efecte Service Management
• Senden Sie das von Endbenutzern gesammelte Feedback an Efecte Service Management

Die meisten Funktionen des Connectors funktionieren automatisch unter Verwendung der Standardwerte, auf die in diesem Dokument überall verwiesen wird.

Dieser Artikel beschreibt das Verhalten des Efecte Service Management Connector in ESS Version 2022.3 oder neuer.

Unterstützte Vorlagen

Standardmäßig werden für den Efecte-Connector zwei Vorlagen unterstützt: Service Request (ServiceRequest) und Incident (Incident). Falls mehrere Vorlagen unterstützt werden müssen, können mehrere ESM-Connectoren für den Mandanten bereitgestellt werden, wobei das Ziel für Anfragen vom Standard abweichen kann. In diesem Fall kann nur einer der Connectoren die Wissensdatenbank enthalten. Wie in meiner Ideenkonfiguration beschrieben, wird bei der Konfiguration mehrerer Connectoren der zuletzt von Efecte Self-Service abgerufene Ergebnissatz zur Anzeige von Artikeln auf der Startseite verwendet. Dies kann insbesondere bei Verweisen auf verschiedene Quellen innerhalb von ESM zu einer verwirrenden Benutzererfahrung führen.

Andererseits kann die Verwendung einer einzigen Vorlage sinnvoll sein. Mit der richtigen Konfiguration können alle Anfragen an die gewünschte Vorlage weitergeleitet werden. Achten Sie jedoch auf Attributcodes und Statuswerte sowie auf die Möglichkeit, die verschiedenen Anfragetypen zu trennen, um die Generierung überzähliger Protokolle durch nicht übereinstimmende Konfigurationen zu vermeiden.

ESM-Nachrichtenformat

Das Format der zwischen ESS- und ESM-Produkten ausgetauschten Nachrichten ist fest codiert.

Hinweis: Mehrwertige Felder für die MyService-Funktion werden im CSV-Format innerhalb von XML-Tags übergeben.

Verbindungskonfiguration

Um die Verbindung für ESM zu konfigurieren, verwenden Sie eine Bean der Klasse com.efecte.integration.connector.configuration.ConnectionConfiguration, wie im folgenden Beispiel:

<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>

Hinweis! Wenn mehrere Konnektoren verwendet werden und einige davon auf unterschiedliche Verbindungskonfigurationen (z. B. unterschiedliche Umgebungen) verweisen, sollten sie pro Verbindungskonfiguration eine eindeutige ID haben. Stellen Sie also sicher, dass Sie nicht dieselbe Bean-ID für zwei verschiedene Verbindungskonfigurationen verwenden. Diese Konfiguration gilt für die Verbindung zu zwei verschiedenen ESM-Umgebungen von einem ESS aus. Daher empfiehlt es sich, die Umgebung in der Bean-ID anzugeben, z. B.

Bean-ID = "Verbindungskonfigurationsumgebungsname"

Diese Bean unterstützt folgende Eigenschaften:

Service Request-Konfiguration

Zuordnungen von Serviceanforderungsattributen können in der Datei connector-efecte.xml definiert werden. Beispielkonfiguration aller verfügbaren Optionen:

<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> 

Die Zuordnung für Vorfälle kann über die Mandantenadministrator-Benutzeroberfläche auf der Registerkarte „Supportkanalkonfiguration“ angepasst werden. Beim Erstellen eines neuen Supportkanals können die Standardwerte in der Konfiguration beachtet werden.

Detaillierte Regeln für die Verarbeitung von Serviceanforderungseigenschaften lauten wie folgt:

Wenn für das Serviceangebot die Option „Artikelmenge aktiviert“ ausgewählt ist, werden für die Serviceanfrage die folgenden zusätzlichen Regeln verarbeitet:

Hinweis! Die oben aufgeführten Attribute sind Standardwerte. Falls diese geändert werden müssen, müssen entsprechende Codes in die Connector-Datei eingefügt werden.

Die PunchOut-Funktionalität ermöglicht Efecte Self-Service-Benutzern die Nutzung eines externen Webshops zum Sammeln von Artikeln in ihrer Serviceanfrage. Die folgenden Attribute werden im Connector für die PunchOut-Funktionalität benötigt. Weitere Informationen uid Sie im PunchOut-Konfigurationshandbuch.

Tracking-Anschluss

Der Tracking-Connector löst die Abfrage von Updates von Efecte Service Management für Incidents und Service Requests aus. Die Standarddomänenzuordnung für Incidents von ESM zu ESS und die Service Item-Zuordnung für Service Requests können durch Festlegen der folgenden Eigenschaften der EfecteTrackingConnector-Bean konfiguriert werden:

Hinweis! Standardmäßig werden Incidents und keine Service Requests abgefragt. Um auch die Service Requests abzufragen, muss der Efecte Tracking Connector in die Connector-Datei eingefügt werden.

Damit die neue Serviceanforderungsabfrage ordnungsgemäß funktioniert, sind auf der ESM-Seite die folgenden Attribute obligatorisch:

• Anforderungskennung übermittelt in efecteIdAttribute, Standard „efecte_id“
• Status übermittelt in statusAttribute.default 'status'
• Kundenkennung übermittelt in requestedForEmailAttribute Standard „RequestedFor:email“
• Artikel-ID, die in serviceItemExternalIdAttribute übermittelt wird, Standard „ServiceItem“ – wenn der Wert dieses Attributs leer ist, übernimmt der Connector den Wert aus defaultIntegrationServiceItemId in der Tracking-Connector-Konfiguration

Damit die neue Vorfallabfrage korrekt funktioniert, sind auf der ESM-Seite folgende Attribute obligatorisch:

• Vorfallkennung, übermittelt im efecteIdAttribute, Standard „efecte_id“
• Status, der im statusAttribute.default „status“ übermittelt wird
• Kundenkennung im Kunden-E-Mail-Attribut übermittelt, Standardwert: customer:mail
• Kategorie-ID, die im IntegrationCategoryAttribute übermittelt wird, standardmäßig WebShopCategory – wenn der Wert dieses Attributs leer ist, übernimmt der Connector den Wert aus der defaultIntegrationCategoryId in der Tracking-Connector-Konfiguration (eine Kategorie mit der Kategorie-ID muss in ESS veröffentlicht werden).

Die Abfragehäufigkeit kann mithilfe der Eigenschaften „updateFrequency“ und „errorUpdateFrequency“ der Klasse „EfecteTrackingConnector“ angepasst werden. Die Werte werden in konfigurierbaren Einheiten ausgedrückt.

Hinweis! Es ist nur sehr selten notwendig, die Standardeinstellung „updateQuerySlidingWindowTime“ zu ändern. Die Abfragedaten umfassen immer alle Datenkarten, die innerhalb des Zeitraums geändert wurden, und über einen längeren Zeitraum werden dieselben Tickets immer wieder in den Ergebnissatz zurückgegeben. Bereits beim ersten Versuch wird das Ticket in ESS aktualisiert. Eine Vergrößerung des Fensters kann die Vorgänge in ESS und ESM verlangsamen, ohne dass ein zusätzlicher Nutzen entsteht.

Wenn der Connector zum ersten Mal ausgeführt wird, ruft er Anfragen und Vorfälle der letzten 24 Stunden ab. Diese Zeit kann durch Konfigurieren der Eigenschaften initialQuerySlidingWindowTime und initialQuerySlidingWindowUnit angepasst werden.

Weitere Standardwerte für den Efecte Tracking Connector sind:

Konfigurationsbeispiel:

<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>

Wenn die Eigenschaft „updateQuerySlidingWindowTime“ im Tracking-Connector nicht konfiguriert ist, wird der Wert von „pollingInterval“ multipliziert mit zwei (2) als Standardgröße des gleitenden Fensters verwendet.

Feedback-Formular

Das Feedback-Formular wird standardmäßig im ESM-Connector unterstützt. Attribute, die für die Zuordnung zu ESM-Feldern verwendet werden, können durch Anpassen der Eigenschaften der Bean-Klasse „EfecteFeedbackFormConnector“ und im eigentlichen Formular über die Admin-Benutzeroberfläche, Registerkarte „Feedback-Verwaltung“, konfiguriert werden. Folgende Eigenschaften werden unterstützt:

Beispielkonfiguration von EfecteFeedbackFormConnector innerhalb von EfecteConnector in 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>

Tipps & Tricks

Diese Funktion ermöglicht den Import Knowledge Base aus dem Efecte Service Management-System. Weitere Informationen zur End-to-End-Konfiguration uid Sie im ConfiguringTipsTricks-Handbuch.

Integration Suite-Konfiguration

Alle Konfigurationsdateien für die Integration Suite befinden sich im Verzeichnis /etc/integration-hub/ und dessen Unterverzeichnissen. Mandantenspezifische Konnektoren befinden sich in den Unterverzeichnissen tenant-configs/{tenant_name}.

Um die Unterstützung für „Tipps & Tricks“ in der Integration Suite zu konfigurieren, bearbeiten Sie bitte die Datei connector-efecte.xml. Fügen Sie eine Bean der Klasse „EfecteKnowledgeBaseConnector“ hinzu und versehen Sie sie mit der ESM-Verbindungskonfigurations-Bean.

<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>

Hinweis! Es empfiehlt sich, die Verbindungskonfiguration zwischen Efecte-Konnektoren gemeinsam zu nutzen. Daher der folgende Code (häufig in Konfigurationen verwendet):

<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>

kann ersetzt werden durch:

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

Konfigurieren der Parameter der Wissensdatenbankvorlage

Um die Namen der in ESM für Knowledge Base Unterstützung verwendeten Attribute anzupassen, können Vorlagenparameter konfiguriert werden, indem die Eigenschaft knowledgeBaseAttributes zur Bean efecteKnowledgeBaseConnector hinzugefügt wird. Andernfalls werden die Standardeinstellungen verwendet.

<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>

Folgende Eigenschaften der Bean der Klasse KnowledgeBaseAttributes werden unterstützt:

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

,

Konfigurieren der Aktualisierungshäufigkeit von „Tipps & Tricks“

Sofern kein Fehler auftritt, wird die Wissensdatenbank standardmäßig alle zwei Stunden aktualisiert. Bei einem Fehler wird die Aktualisierungszeit auf zwei Minuten geändert.

Die Startverzögerung der Planung (Zeit, nach der der Connector seine Arbeit aufnimmt, gemessen seit dem Start des Integration Hubs) kann mithilfe der Eigenschaft „startUpDelay“ für die ConnectorScheduler-Bean in der Datei „hub.xml“ konfiguriert werden.

Beispiel aus hub.xml:

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

Die Häufigkeit von Aktualisierungen und Fehleraktualisierungen kann in der Connector-XML-Konfiguration (connector-efecte.xml) konfiguriert werden. Bitte verwenden Sie die folgenden Eigenschaften:

Beispiel aus 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>

Gefällt mir, meine Idee

Diese Funktion ermöglicht das Anzeigen und Kommentieren von Ideen, die im Efecte Service Management-System gespeichert sind.

Alle Konfigurationsdateien für die Integration Suite befinden sich im Verzeichnis /etc/integration-hub/ und dessen Unterverzeichnissen. Mandantenspezifische Konnektoren befinden sich in den Unterverzeichnissen tenant-configs/{tenant_name}.

Um die Unterstützung für „Like My Idea“ in der Integration Suite zu konfigurieren, bearbeiten Sie bitte die Datei connector-efecte.xml. Fügen Sie „ http://www.springframework.org/schema/context “ hinzu. http://www.springframework.org/schema/context/spring-context-4.2.xsd " Schema-Speicherorte zur Haupt-Bean-Definition.

<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">

Fügen Sie das Element „annotation-config“ und die Bean der Klasse „EfecteLikeMyIdeaConnector“ hinzu und versehen Sie es mit der ESM-Verbindungskonfigurations-Bean. Fügen Sie außerdem eine Bean vom Typ „EfecteConnectorContext“ hinzu.

<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>

Folgende Eigenschaften der LikeMyIdeaAttributes-Klassen-Bean werden unterstützt:

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

Konfigurieren der Aktualisierungshäufigkeit von „Like My Idea“

Standardmäßig wird „Gefällt mir“-Angaben alle 2 Stunden aktualisiert, sofern kein Fehler auftritt. Bei einem Fehler wird die Aktualisierungszeit auf 2 Minuten geändert.

Die Startverzögerung (Zeit, nach der der Connector seit dem Start des Integration Hubs seine Arbeit aufnimmt) kann über die Eigenschaft „startUpDelay“ für die ConnectorScheduler-Bean in der Datei „hub.xml“ konfiguriert werden. Bitte beachten Sie die Anweisungen im Abschnitt „Tipps & Tricks“.

Die Häufigkeit von Aktualisierungen und Fehleraktualisierungen kann in der Connector-XML-Konfiguration (connector-efecte.xml) konfiguriert werden. Bitte verwenden Sie die folgenden Eigenschaften:

Beispiel aus 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>

Meine Leistungen

„Meine Dienste“ ist ein allgemeiner Name für eine Reihe von Integrationsmechanismen, die es externen Systemen ermöglichen, für Benutzer sichtbare Kataloginhalte dynamisch zu ändern.

Definieren von MyServices-Feldern

1. Gehen Sie zur ESS-Admin-Seite -> Integrationen -> Externe Datenfelder
2. Drücken Sie die Schaltfläche „Meine Dienste hinzufügen“
3. Konfiguration eingeben
   • Feldname - geben Sie den Namen ein, der als Alias für dieses MyServices-Feld verwendet wird
   • Daten von – wählen Sie den Efecte Service Management-Connector aus
   • Vorlagendaten von Efecte Service Management, die dem Feld „MyServices“ zugeordnet sind (Anmeldung bei Efecte Service Management -> Verwaltung -> Vorlagen -> Vorlage auswählen)
     • Ordnercode – optional, beschränkt die abzurufenden Elemente auf definierte Ordner
     • Vorlagencode – mit dem Nutzwert aus dem Vorlagencode ausfüllen
     • Namensattributcode – Code des als Name verwendeten Attributs (dieses Attribut kann für den Benutzer sichtbar sein)
     • Technischer ID-Attributcode – Code des Attributs, das als DataCard- Kennung verwendet wird (sollte in ESM als primäres Attribut markiert werden)

• Benutzerattributcode – Verweis auf die Vorlage, die den mit dieser Vorlage verknüpften Benutzer beschreibt (die Zielvorlage muss über ein E-Mail-Attribut verfügen, damit die Benutzerzuordnungen ordnungsgemäß funktionieren)

1. Klicken Sie auf die Schaltfläche „ Aktualisieren “. Wenn keine Fehler vorliegen, sollten Sie in der Tabelle mit den Feldelementen von MyServices die Namen der DataCards von Efecte Service Management sehen.
   1. Sie können dies überprüfen, indem Sie sich eine Tabelle mit DataCards ansehen, die mit der ausgewählten Vorlage in ESM verknüpft sind

Mein Leistungs- und Angebotskatalog

MyService-Eintrag als Quelle für Service Item IDs

1. Öffnen Sie auf der Admin-Seite die Registerkarte „Dienste“ und wählen Sie „Dienstelement“ in einem Dienstangebot aus

2. Öffnen Sie in den Elementeigenschaften das Dropdown- Menü „ Externer Datenlink“ und wählen Sie den Namen des externen Datenfelds aus.
3. Wählen Sie aus der Dropdown-Liste „Artikel-ID“ das gewünschte Element aus.

Die ID des ausgewählten Elements wird als Artikel-ID verwendet, wenn Benutzer Bestellungen für den angegebenen Artikel aufgeben.

Zuordnungen zwischen Benutzern und DataCards

Connector ist nicht nur für das Abrufen von DataCards-Informationen verantwortlich, sondern auch für:

• Verfolgung von Verknüpfungen zwischen DataCards und Benutzern
• Änderung dieser Assoziationen

Um diese Funktion zu nutzen:

1. Öffnen Sie auf der Admin-Seite „Service“ und wählen Sie „Service Item“ aus.

2. Öffnen Sie in den Service-Elementeigenschaften das Dropdown- Menü „MyServices-Link“ und wählen Sie den Namen des MyServices-Felds aus.

1. Wählen Sie aus der Dropdown- Liste „Unterelemente“ Folgendes aus:
   1. Benutzer verwendet - in diesem Fall wird dem Benutzer eine Liste der DataCards angezeigt, mit denen er verknüpft ist
2. Benutzer verwendet nicht - in diesem Fall wird dem Benutzer eine Liste der DataCards angezeigt, mit denen er nicht verknüpft ist

Das Absenden einer Bestellung für einen Serviceartikel führt zu

1. Entfernen
2. Hinzufügen

Verbindung zwischen der Bestellung des Benutzers und der DataCard

Katalogartikel

Folgende ESM-Attributdatentypen werden bei der Konfiguration von Katalogelementen unterstützt

Connector-Beispiel

<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"/>
              <Eigenschaft name="AuflösungTextAttribute" Wert="Auflösung"/>
              <Eigenschaft name="supportPersonAttribute" value="support_person"/>
              <Eigenschaft name="serviceOfferingNameAttribute" value="ServiceOffering"/>
              <Eigenschaft name="serviceItemNameAttribute" Wert="ServiceItemName"/>
              <Eigenschaft name="serviceItemExternalIdAttribute" Wert="ServiceItem"/>
              <Eigenschaft name="Preisattribut" value="Preis"/>
              <Eigenschaft name="MonatsabonnementAttribut" value="Monatsabonnement"/>
              <Eigenschaft name="angefordertFürAttribut" Wert="Angefordertfür"/>
              <Eigenschaft name="costCenterAttribute" value="Kostenstelle"/>
              <Eigenschaft name="Lieferadressenattribut" value="Lieferadresse"/>
              <Eigenschaft name="orderedByAttribute" Wert="Sortiertnach"/>
              <Eigenschaft name="additionalInformationAttribute" value="ZusätzlicheInformationen"/>
              <Eigenschaft name="siteIDAttribute" Wert="SiteID"/>
              <Eigenschaft name="siteNameAttribute" Wert="SiteName"/>
              <Eigenschaft name="requestBundleAttribute" Wert="RequestBundle"/>
              <Eigenschaft name="requestBundleNameAttribute" Wert="RequestBundleName"/>
              <Eigenschaft name="orderedByEmailAttribute" Wert="Bestelltnach:E-Mail"/>
              <Eigenschaft name="requestedForEmailAttribute" Wert="Angefordertfür:E-Mail"/>
              <Eigenschaft name="Kommentarattribut" value="external_comments"/>
              <Eigenschaft name="Grundattribut" value="Benutzergrund"/>
              <Eigenschaft name="dedicatedApproverAttribute" Wert="DedicatedApprover"/>
              <Eigenschaft name="superiorApproverAttribute" value="genehmigender_Manager"/>
              <Eigenschaft name="Gesamtpreisattribut" value="Gesamtpreis"/>
              <Eigenschaft name="Mengenattribut" Wert="Menge"/>
              <Eigenschaft name="totalMonthlySubscriptionAttribute" value="Gesamtmonatsabonnement"/>
          </bean>
      </Eigenschaft -->
     <!-- Eigentum name="approvalResponseAttributes"> NICHT EMPFOHLEN ZU SEI GEÄNDERT
          <Bohne class="com.efecte.integration.connector.configuration.ApprovalResponseAttributes">
              <Eigenschaft name="Vorlagencode" value="Genehmigung"/>
              <Eigenschaft name="Ordnercode" value="Genehmigungen"/>
              <Eigenschaft name="efecteId" value="efecte_id"/>
              <Eigenschaft name="actualApprover" value="ActualApprover"/>
              <Eigenschaft name="Genehmigungsentscheidung" value="Genehmigungsentscheidung"/>
              <Eigenschaft Name="Grund" Wert="Grund"/>
              <Eigenschaft name="esmApprovedCode" value="genehmigt"/>
              <Eigenschaft name="esmRejectedCode" Wert="abgelehnt"/>
          </bean>
      </Eigenschaft -->
     <!-- Eigentum name="efecteTrackingConnector">
          <Bohne class="com.efecte.integration.connector.efecte.EfecteTrackingConnector">
              <Eigenschaft name="updateQuerySlidingWindowTime" Wert="20"/>
              <Eigenschaft name="updateQuerySlidingWindowUnit" value="MINUTEN"/>
              <Eigenschaft name="initialQuerySlidingWindowTime" Wert="1"/>
              <Eigenschaft name="initialQuerySlidingWindowUnit" value="TAGE"/>
              <Eigenschaft name="updateFrequenz" Wert="10" />
              <Eigenschaft name="updateFrequencyUnit" Wert="Minuten" />
              <Eigenschaft name="FehlerUpdateFrequenz" Wert="10" />
              <Eigenschaft name="errorUpdateFrequencyUnit" Wert="Minuten" />
              <Eigenschaft name="defaultIntegrationServiceItemId" Wert="DEFAULT_SERVICE_ITEM" />
              <Eigenschaft name="pollNewServiceRequestEnabled" Wert="falsch" />
             <Eigenschaft name="Standard-Integrationskategorie-ID" value="DEFAULT_EFECTE_CATEGORY"/>
              <Eigenschaft name="serviceRequestPollCondition" value="und $Schöpfer$ = 'SefServicePortal'"/>
              <Eigenschaft name="incidentPollCondition" value="und $Schöpfer$ = 'Webshop'"/>
          </bean>
      </Eigenschaft -->
     <!-- Eigentum name="feedbackFormConnector">
           <Bohne class="com.efecte.integration.connector.efecte.EfecteFeedbackFormConnector">
              <Eigenschaft name="feedbackAttributes">
                     <Bohne class="com.efecte.integration.connector.configuration.FeedbackAttributes">
                         <Eigenschaft name="Vorlagencode" Wert="Feedback-Management" />
                         <Eigenschaft name="Ordnercode" Wert="Feedback" />
                         <Eigenschaft name="efecteIdAttribute" Wert="Ticket-ID" />
                         <Eigenschaft name="Kundenattribut" Wert="Kunde" />
                         <Eigenschaft name="Bewertungsattribut" Wert="Ticketbewertung" />
                     </bean>
               </Eigenschaft>
           </bean>
       </Eigenschaft --> 
     </bean>
<Bohne id="efecteKnowledgeBaseConnector" class="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
    <Eigenschaft name="Verbindungskonfiguration" ref="Verbindungskonfiguration"/>
    <Eigenschaft name="knowledgeBaseAttributes" >
           <Bohne id="knowledgeBaseAttributes" class="com.efecte.integration.connector.configuration.KnowledgeBaseAttributes">
                 <Eigenschaft name="Vorlagencode" value="Wissensdatenbankartikel"/>
                 <Eigenschaft name="pollingFolderCode" value="Wissensdatenbank"/>
                 <Eigenschaft name="updateReadStatsFallbackFolderCode" value="Wissensdatenbank"/>
                 <Eigenschaft name="ratingFallbackFolderCode" value="Wissensdatenbank"/>
                 <Eigenschaft name="publishedInEssAttr" value="veröffentlicht_im_Self_Service"/>
                 <Eigenschaft name="publishedInEssValue" Wert="Ja"/>
                 <Eigenschaft name="gelöschtesAttr" Wert="gelöscht"/>
                 <Eigenschaft name="NameAttr" value="Lösungsname"/>
                 <Eigenschaft name="descriptionAttr" value="Lösungsbeschreibung"/>
                 <Eigenschaft name="categoryAttr" Wert="Kategorie"/>
                 <Eigenschaft name="efecteIdAttr" value="efecte_id"/>
                 <Eigenschaft name="aktualisiertesAttr" Wert="aktualisiert"/>
                 <Eigenschaft name="ratingAttr" Wert="Bewertung"/>
                 <Eigenschaft name="rankingAttr" Wert="Bewertung"/>
                 <Eigenschaft name="readStatsAttr" Wert="read_count"/>
                 <Eigenschaft name="keywordsAttr" value="Lösungsschlüsselwörter"/>
                 <Eigenschaft name="keywordsSeparator" Wert=","/>
             </bean>
       </Eigenschaft>
    </bean>
</bohnen>