SendGrid

Authentifizierung konfigurieren

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.

Aktionen

In diesem Abschnitt werden einige der vom Connector unterstützten Aktionen aufgeführt. Informationen zum Konfigurieren der Aktionen finden Sie unter Beispiele für Aktionen.

Aktion „SendMail2“

Bei dieser Aktion wird eine E-Mail mit einem Anhang gesendet.

Eingabeparameter der Aktion „E-Mail senden“

Ausgabeparameter der Aktion „E‑Mail senden“

Diese Aktion gibt eine Bestätigungsmeldung zurück, die angibt, ob die E‑Mail gesendet wurde.

Beispiele für Aktionen

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

Beispiel: E‑Mail senden

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion SendMail2 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:

   {
       "FromName": "Name",
       "FromEmail": "cloudysanfrancisco@gmail.com",
       "Subject": "[{\"value\": \"cymbalgroup.com\",\"type\": \"text/plain\"}]",
       "TemplateId": "d-c4bc730a0b094a3a9d9cabb7347b5edc",
       "Personalizations": "[{\"subject\": \"Test Subject3\",\"send_at\": 1698659820,\"from\": {\"name\": \"hi\",\"email\": \"email@gmail\"},\"to\":      
       [{\"email\": \"email@gmail.com\",\"name\": \"test\"}\n ]}]",
       "Content": "[{\"value\": \"abc@cdata.com\",\"type\": \"text/plain\"}]"
   }

Durch diese Aktion wird eine Bestätigungsmeldung zurückgegeben. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Aufgabe einen Wert, der dem folgenden ähnelt:

[{
"Success": "True"
}]

Beispiele für Entitätsvorgänge

In diesem Abschnitt wird beschrieben, wie Sie einige Entitätsvorgänge in diesem Connector ausführen.

Beispiel: Alle Kontakte auflisten

In diesem Beispiel werden alle Kontakte in der NMCContacts-Entität aufgelistet.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie NMCContacts aus der Liste Entity aus.
3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.
4. Optional können Sie im Bereich Aufgabeneingabe der Aufgabe Connectors das Ergebnisset filtern, indem Sie eine Filterklausel angeben. Beispiel: City='Bangalore' Mit den Logikoperatoren können Sie auch mehrere Filterbedingungen angeben. Zum Beispiel: City='Bangalore' and region='asia-south2'.

Beispiel: Datensatz abrufen

In diesem Beispiel wird ein Datensatz mit der angegebenen ID aus der NMCSegments-Entität abgerufen.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie NMCSegments aus der Liste Entity aus.
3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf EntityId und geben Sie dann 0d44bb3f-d28e-4bcf-aba2-c77be831ad46 in das Feld Standardwert ein.

   Dabei ist 0d44bb3f-d28e-4bcf-aba2-c77be831ad46 ein Primärschlüsselwert in der Entität NMCSegments.

Beispiel: Eintrag erstellen

In diesem Beispiel wird ein Datensatz in der Entität NMCSenders erstellt.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie NMCSenders 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:

   {
   "Nickname": "Test",
   "FromEmail": "test1@examplepetstore.com",
   "FromName": "testuser",   
   "ReplytoEmail": "test1@examplepetstore.com",  
   "Address": "NA", 
   "City": "NA", 
   "Country": "India"}

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

   {
   "Id": 5360940.0
   }

Beispiel: Eintrag erstellen

In diesem Beispiel wird ein Datensatz in der Entität NMCLists erstellt.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie NMCLists 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": "TEST_CON_LIST1699262238224",
   "ContactCount": 3.0}

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

   {
   "Id": "d927f128-b718-447a-affe-417f1a8b3abd"}

Beispiel: Datensatz aktualisieren

In diesem Beispiel wird ein Datensatz in der Entität NMCSenders aktualisiert.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie NMCSenders 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:

   {
   "Nickname": "Test",
   "FromEmail": "test2@examplepetstore.com",
   "FromName": "testuser",   
   "ReplytoEmail": "test2@examplepetstore.com",  
   "Address": "NA", 
   "City": "NA", 
   "Country": "India"}

5. Klicken Sie auf entityId und geben Sie dann 5360940.0 in das Feld Standardwert ein.

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

   {
   "Id":"5360940.0"
   }

Beispiel: Eintrag löschen

In diesem Beispiel wird der Datensatz mit der angegebenen ID in der Entität NMCSegments gelöscht.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie NMCSegments aus der Liste Entity aus.
3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf entityId und geben Sie dann c58b9151-7279-428a-bac2-12b4bf2b48b0 in das Feld Standardwert ein.