Zendesk

Authentifizierung konfigurieren

Geben Sie die Details basierend auf der zu verwendenden Authentifizierung ein.

• Nutzername und Passwort
  • Nutzername: Der Zendesk-Nutzername für die Verbindung.
  • Kennwort: Secret Manager-Secret mit dem Passwort, das dem Zendesk-Nutzernamen zugeordnet ist.
• API-Token
  • Nutzer: Das Zendesk-Nutzerkonto, das zur Authentifizierung verwendet wird.
  • API-Token: Das API-Token des authentifizierten Nutzers.
  • Secret-Version: Secret-Version für das Secret.
• OAuth 2.0-Autorisierungscode
  • Client-ID: Die Client-ID, die vom Connector für die von Ihnen erstellte Anwendung bereitgestellt wird.
  • Bereiche: Eine durch Kommas getrennte Liste der gewünschten Bereiche.
  • Clientschlüssel: Secret Manager-Secret mit dem Clientschlüssel für die verbundene App, die Sie erstellt haben.
  • Secret-Version: Secret-Version für das Secret.
  • Authorization URL (Autorisierungs-URL): Die Autorisierungs-URL, die beim Erstellen des Clients in der Zendesk-Instanz generiert wurde.

Ereignisabo konfigurieren

Wenn Sie das Ereignis-Abo aktiviert haben, geben Sie im Abschnitt Details zum Ereignis-Abo die folgenden Werte ein:

1. Wählen Sie einen Zieltyp aus.
   • Hostadresse: Geben Sie die Registrierungs-URL Ihres Backend-Systems in das Feld Host ein.
2. Geben Sie die Authentifizierungsdetails ein.
   1. Nutzername: Geben Sie den Nutzernamen ein.
   2. Passwort: Wählen Sie das Secret Manager-Secret mit dem Passwort aus, das dem Nutzernamen zugeordnet ist.
   3. Secret-Version: Wählen Sie die Secret-Version aus.
3. Optional: Wählen Sie Datenanreicherung aktivieren aus, wenn Sie möchten, dass der Antwort des Backend-Systems zusätzliche Informationen angehängt werden.

   Die zusätzlichen Informationen sind spezifisch für die Einheit, für die Sie das Ereignis konfiguriert haben. Weitere Informationen finden Sie unter Datenanreicherung in Ereignisbenachrichtigungen.

4. Wählen Sie Private Verbindung aktivieren aus, um eine sichere Verbindung zwischen Ihrer Backend-Anwendung und Ihrer Verbindung herzustellen. Wenn Sie diese Option auswählen, müssen Sie nach dem Erstellen der Verbindung zusätzliche Konfigurationsschritte ausführen. Weitere Informationen finden Sie unter Private Verbindung für Ereignisabos.
5. Geben Sie die Konfiguration für unzustellbare Nachrichten ein. Wenn Sie ein Thema für fehlgeschlagene Nachrichten konfigurieren, schreibt die Verbindung die nicht verarbeiteten Ereignisse in das angegebene Pub/Sub-Thema. Geben Sie die folgenden Informationen ein:
   1. Projekt-ID für Unzustellbarkeitsnachrichten : Die Google Cloud-Projekt-ID, in der Sie das Pub/Sub-Thema für Unzustellbarkeitsnachrichten konfiguriert haben.
   2. Thema für unzustellbare Nachrichten : Das Pub/Sub-Thema, in das Sie die Details des nicht verarbeiteten Ereignisses schreiben möchten.
6. Wenn Sie einen Proxy verwenden möchten, um eine Verbindung zu Ihrem Backend herzustellen (für das Abonnieren von Ereignissen), geben Sie die folgenden Details ein:
1. Proxy-SSL-Typ: Der SSL-Typ, der beim Herstellen einer Verbindung zum Proxyserver verwendet werden soll. Wählen Sie einen der folgenden Authentifizierungstypen aus:
   • Immer: Die Verbindung ist für das Ereignisabo immer SSL-aktiviert.
   • Nie: Die Verbindung ist für das Ereignis-Abo nicht SSL-fähig.
2. Proxy-Authentifizierungsschema: Wählen Sie den Authentifizierungstyp für die Authentifizierung beim Proxyserver aus. Die folgenden Authentifizierungstypen werden unterstützt:
   • Standard: Basis-HTTP-Authentifizierung.
3. Proxy-Nutzer: Geben Sie den Nutzernamen ein, der für die Authentifizierung beim Proxyserver verwendet werden soll.
4. Proxy-Passwort: Wählen Sie das Secret Manager-Secret des Nutzerpassworts aus.
5. Secret-Version: Wählen Sie die Secret-Version aus.
6. Geben Sie im Abschnitt Proxyserver die Details des Proxyservers ein.
   1. Klicken Sie auf + Ziel hinzufügen und wählen Sie dann Hostadresse als Zieltyp aus.
   2. Geben Sie den Hostnamen oder die IP-Adresse des Proxyservers und die Portnummer des Proxyservers ein.

Beispiele für Verbindungskonfigurationen

Verbindungstyp für die Basisauthentifizierung

Verbindungstyp für API-Token

OAuth 2.0-Verbindungstyp mit Autorisierungscode

Die Verbindung zu Zendesk erfolgt standardmäßig über SSL. Wenn Sie die Standard-Zendesk-URL verwenden, z. B. https://yoursubdomain.zendesk.com, ist keine zusätzliche Konfiguration erforderlich.

Entitäten, Vorgänge und Aktionen

Alle Integration Connectors bieten eine Abstraktionsebene für die Objekte der verbundenen Anwendung. Sie können nur über diese Abstraktion auf die Objekte einer Anwendung zugreifen. Die Abstraktion wird Ihnen als Entitäten, Vorgänge und Aktionen zur Verfügung gestellt.

• Entität: Eine Entität kann als Objekt oder Sammlung von Attributen in der verbundenen Anwendung oder im verbundenen Dienst verstanden werden. Die Definition einer Entität unterscheidet sich von Connector zu Connector. Beispiel: In einem Datenbank-Connector sind Tabellen die Entitäten, in einem Dateiserver-Connector sind Ordner die Entitäten und in einem Nachrichtensystem-Connector sind Warteschlangen die Entitäten.

  Es ist jedoch möglich, dass ein Connector keine Entitäten unterstützt oder keine Entitäten enthält. In diesem Fall ist die Liste Entities leer.

• Vorgang: Ein Vorgang ist die Aktivität, die Sie für eine Entität ausführen können. Sie können einen der folgenden Vorgänge für eine Entität ausführen:
  • Liste
  • Abrufen
  • Erstellen
  • Aktualisieren
  • Löschen

  Durch Auswahl einer Entität aus der verfügbaren Liste wird eine Liste der Vorgänge generiert, die für die Entität verfügbar sind. Eine detaillierte Beschreibung der Vorgänge finden Sie in den Entitätsvorgängen der Connectors-Aufgabe. Wenn ein Connector jedoch keine der Entitätsvorgänge unterstützt, werden diese nicht unterstützten Vorgänge nicht in der Operations-Liste aufgeführt.

• Aktion: Eine Aktion ist eine Funktion erster Klasse, die über die Connector-Benutzeroberfläche für die Integration verfügbar gemacht wird. Mit einer Aktion können Sie Änderungen an einer oder mehreren Entitäten vornehmen, die von Connector zu Connector unterschiedlich sind. Normalerweise hat eine Aktion einige Eingabeparameter und einen Ausgabeparameter. Es ist jedoch möglich, dass ein Connector keine Aktionen unterstützt. In diesem Fall ist die Actions-Liste leer.

Systembeschränkungen

Der Zendesk-Connector kann fünf Transaktionen pro Sekunde und Knoten verarbeiten und drosselt alle Transaktionen, die dieses Limit überschreiten. Standardmäßig werden für eine Verbindung zwei Knoten (für eine bessere Verfügbarkeit) zugewiesen.

Informationen zu den für Integration Connectors geltenden Limits finden Sie unter Limits.

Aktionen

Der Zendesk-Connector bietet Aktionen zum Verwalten Ihrer Tickets basierend auf der ticket ID. Informationen zum Konfigurieren der Aktionen finden Sie unter Beispiele für Aktionen.

Beispiele für Aktionen

In diesem Abschnitt wird beschrieben, wie Sie einige der Aktionen in diesem Connector ausführen.

Beispiel: Fahrkarte löschen

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion DeleteTicketsPermanently aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
     "Id": "18"
   }

In diesem Beispiel wird das Ticket endgültig gelöscht. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
  "Success": "true"
}] 

Beispiel: Tickets zusammenführen

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion MergeTickets aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
     "Id": "25",
     "Id": "26"
   }

In diesem Beispiel werden die beiden Tickets zusammengeführt. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
  "Success": null,
  "Message": null
}] 

Beispiel: Ticket wiederherstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion RestoreTicket aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
     "id": "20"
   }

In diesem Beispiel wird ein Ticket wiederhergestellt. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
  "Success": "true"
}] 

Beispiel: Gesperrtes Ticket reaktivieren

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion RecoverSuspendedTicket aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
     "id": "18726501985809"
   }

In diesem Beispiel wird das gesperrte Ticket wiederhergestellt. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
  "Id": "60921"
}]

Beispiele für Entitätsvorgänge

Beispiel – List-Vorgang für Tickets

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Tickets aus der Liste Entity aus.
3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.

Sie können den List-Vorgang für die folgenden Entitäten ausführen:

Anhänge, Ticketkommentare, Ticketformulare, Ticketfelder, Anfragen, Ticketaudits, Ticketmesswerte, gesperrte Tickets, Vereinbarungen zur gemeinsamen Nutzung, Nutzer, Nutzeridentitäten, nutzerbezogene Informationen, Nutzerfelder, Organisationsfelder und JobStatus

Beispiel – Get-Vorgang für Tickets

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Tickets aus der Liste Entity aus.
3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
4. Hier ist die entityId auf 34.0 festgelegt. Klicken Sie zum Festlegen der „entityId“ im Bereich Aufgabeneingabe der Aufgabe Connectors auf entityId und geben Sie dann 34.0 in das Feld Default Value ein.

Sie können den Vorgang „Get“ für die folgenden Entitäten ausführen:

Ticketformulare, Ticketfelder, Anfragen, Ticketaudits, gesperrte Tickets, Nutzerfelder, Nutzeridentitäten und Nutzer

Beispiel – Create-Vorgang für Tickets

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Tickets aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "Subject": "Zendesk_Create_Ticket",
       "RawSubject": "Zendesk_Create",
       "Description": "this ticket is related to application integration Create operation",
       "Type": "incident",
       "Priority": "urgent",
       "Status": "open",
       "Recipient": null,
       "HasIncidents": false,
       "DueAt": null,
       "RequesterId": 3.84625885158E11,
       "SubmitterId": 3.84625883418E11,
       "AssigneeId": 3.84625883418E11,
       "OrganizationId": "16665992392721",
       "GroupId": 3.60008282358E11,
       "TicketFormId": 3.60001719218E11,
       "BrandId": 3.60003285058E11,
       "Tags": null,
       "ViaChannel": "web",
       "ViaSource": "{\r\n  \"from\": null,\r\n  \"to\": null,\r\n  \"rel\": null\r\n}",
       "CustomFields": null,
       "SatisfactionRating": null,
       "SharingAgreementIds": null,
       "AllowChannelback": false,
       "IsPublic": true,
       "Url": "https://altostrat.zendesk.com/api/v2/tickets/1.json"
     }
     

   Wenn die Integration erfolgreich ist, hat das Feld connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    {
       "Id": 38.0
     }
     

Beispiel – Vorgang zum Erstellen für TicketForms

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie TicketForms aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "Name": "Altostrat_Zendesk1",
       "RawName": "Altostrat_Zendesk1",
       "DisplayName": "Altostrat_Issues1",
       "RawDisplayName": "Altostrat_Issues1",
       "Position": 2.0,
       "Active": true,
       "EndUserVisible": true,
       "Default": false,
       "InAllBrands": true,
       "RestrictedBrandIds": null,
       "FallbackToDefault": null,
       "AssociatedToBrand": null
     }
     

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des TicketForms-Vorgangs einen Wert, der dem folgenden ähnelt:

   {
       "Id":1.8104712053393E13
     }
     

Beispiel – Vorgang zum Erstellen für TicketFields

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie TicketFields aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "Type": "text",
       "Title": "New field created",
       "RawTitle": null,
       "Description": "Please create the new field",
       "RawDescription": null,
       "Position": 2.0,
       "Active": true,
       "Required": false,
       "CollapsedForAgents": false,
       "RegexpForValidation": null,
       "VisibleInPortal": true,
       "EditableInPortal": true,
       "Tag": null,
       "CreatedAt": "2021-07-06 06:35:19.0",
       "UpdatedAt": "2021-07-06 06:35:19.0",
       "SystemFieldOptions": null,
       "CustomFieldOptions": null,
       "Removable": false
     }
     

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des TicketFields-Vorgangs einen Wert, der dem folgenden ähnelt:

   {
       "Id": 1.7139061374865E13
     }
     

Beispiel: Vorgang für SharingAgreements erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie SharingAgreements aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "Name": "altostrat.zendesk.com",
       "RemoteSubdomain": "altostrat"
     }
     

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des SharingAgreements-Vorgangs einen Wert, der dem folgenden ähnelt:

   {
       "Id": 1.7142672288273E13
     }
     

Beispiel – Vorgang zum Erstellen von Nutzern

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Users aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "Email": "cloudysanfrancisco@gmail.com",
       "Name": "Altostrat Team"
     }
     

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des Users-Vorgangs einen Wert, der dem folgenden ähnelt:

   {
       "Id": 1.7156912480273E13
     }
     

Beispiel – Vorgang zum Erstellen von UserIdentities

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie UserIdentities aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "UserId": 3.84637722338E11,
       "Type": "email",
       "Value": "cloudysanfrancisco@gmail.com",
       "Verified": false,
       "Primary": true,
       "DeliverableState": "reserved_example",
       "Url": "https://d3valtostrat1625553311.zendesk.com/api/v2/users/384637722338/identities/368240277818.json"
     }
     

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UserIdentities-Vorgangs einen Wert, der dem folgenden ähnelt:

   {
       "Id": 1.6961185982353E13
     } 
     

Beispiel: Vorgang zum Erstellen von UserFields

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie UserFields aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "Title": "Support description",
       "Type": "text",
       "Key": "support_description"
     }
     

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UserFields-Vorgangs einen Wert, der dem folgenden ähnelt:

   {
       "Id": 1.7157236761873E13
     }
     

Beispiel: Update-Vorgang für Tickets

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Tickets aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "Subject": "Google_Altostrat_Zendesk Update",
       "RawSubject": "Google_Altostrat_Zendesk Update",
       "Description": "this ticket is related to googlecloud application integration update check",
       "RequesterId": 1.6854335860497E13
     }
     

5. Hier ist die entityId auf 35, 0 festgelegt. Klicken Sie zum Festlegen der „entityId“ auf entityId und geben Sie dann 35 in das Feld Standardwert ein.

   Anstelle der entityId können Sie auch die filterClause auf 35 festlegen.

   Wenn die Integration erfolgreich ist, hat das Feld connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

   {
         Id": 35.0
     }
     

Beispiel: Update-Vorgang für TicketForms

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie TicketForms aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "Name": "Ticketforms Updated",
       "DisplayName": "Altostrat_Issues1",
       "RawDisplayName": "Altostrat_Issues1"
     }
     

5. Hier ist die entityId auf 1.7137314972689E13 festgelegt. Klicken Sie zum Festlegen der entityId auf entityId und geben Sie dann 1.7137314972689E13 in das Feld Standardwert ein.

   Anstelle der entityId können Sie auch die filterClause auf 1.7137314972689E13 festlegen.

   Wenn Sie dieses Beispiel ausführen, wird in der Ausgabevariable connectorOutputPayload des Connector-Tasks eine Antwort ähnlich der folgenden zurückgegeben:

   {
         Id": 1.7137314972689E13
     }
     

Beispiel – Update-Vorgang für TicketFields

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie TicketFields aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "Description": "Updated description for testing"
     }
     

5. Hier ist die entityId auf 3.60022990118E11 festgelegt. Klicken Sie zum Festlegen der entityId auf entityId und geben Sie dann 3.60022990118E11 in das Feld Standardwert ein.

   Anstelle der entityId können Sie auch die filterClause auf 3.60022990118E11 festlegen.

   Wenn Sie dieses Beispiel ausführen, wird in der Ausgabevariable connectorOutputPayload des Connector-Tasks eine Antwort ähnlich der folgenden zurückgegeben:

   {
         Id": 3.60022990118E11
     }
     

Beispiel – Update-Vorgang für Nutzer

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Users aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "Name": "The Customer update",
       "Last Name": "Alex",
       "First Name": "Charlie"
     }
     

5. Die entityId ist hier auf 3.84625885158E11 festgelegt. Klicken Sie zum Festlegen der entityId auf entityId und geben Sie dann 3.84625885158E11 in das Feld Standardwert ein.

   Anstelle der entityId können Sie auch die filterClause auf 3.84625885158E11 festlegen.

   Wenn Sie dieses Beispiel ausführen, wird in der Ausgabevariable connectorOutputPayload des Connector-Tasks eine Antwort ähnlich der folgenden zurückgegeben:

   {
         Id": 3.84625885158E11
     }
     

Beispiel: Update-Vorgang für UserFields

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie UserFields aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "Title": "Support description updated",
       "Type": "text",
       "Key": "support_description"
     }
     

5. Hier ist die entityId auf 1.7157236761873E13 festgelegt. Klicken Sie zum Festlegen der entityId auf entityId und geben Sie dann 1.7157236761873E13 in das Feld Standardwert ein.

   Anstelle der entityId können Sie auch die filterClause auf 1.7157236761873E13 festlegen.

   Wenn Sie dieses Beispiel ausführen, wird in der Ausgabevariable connectorOutputPayload des Connector-Tasks eine Antwort ähnlich der folgenden zurückgegeben:

   {
         Id": 1.7157236761873E13
     }
     

Beispiel – Update-Vorgang für UserIdentities

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie UserIdentities aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "Verified": true
     }
     

5. Bei dieser Entität kann der Update-Vorgang mithilfe der Filterklausel und der zusammengesetzten Primärschlüssel ausgeführt werden. Daher ist „entityId“ nicht erforderlich.

Anstelle der entityId können Sie auch die filterClause auf UserId='384625885158' and Id='368234205078' festlegen.

Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

{
    "Id": 3.68234205078E11
  }
  

Beispiel: Löschvorgang für Tickets

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Tickets aus der Liste Entity aus.
3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
4. Hier ist die entityId auf 35, 0 festgelegt. Klicken Sie zum Festlegen der entityId im Bereich Aufgabeneingabe der Aufgabe Connectors auf entityId und geben Sie dann 35 in das Feld Standardwert ein.

Sie können den Löschvorgang für die folgenden Entitäten ausführen:

Ticketfelder, gesperrte Tickets, UserIdentities, Nutzerfelder und Nutzer

Zendesk-Verbindung in einer Integration verwenden

Nachdem Sie die Verbindung erstellt haben, ist sie sowohl in Apigee Integration als auch in Application Integration verfügbar. Sie können die Verbindung in einer Integration über die Aufgabe „Connectors“ verwenden.

• Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Apigee Integration finden Sie unter Connectors-Aufgabe.
• Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Application Integration finden Sie unter Connectors-Aufgabe.