SAP ASE (Sybase)

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

Beispiele für Aktionen

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

Beispiel: Tabelle erstellen

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   CREATE TABLE customqueries98(
        ID   INT ,
        NAME VARCHAR (20),
        AGE  INT,
        City  CHAR (25) ,
        SALARY   DECIMAL (18, 2)  );

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ eine neue Tabelle erstellen. Wenn die Aktion erfolgreich ist, gibt der Antwortparameter connectorOutputPayload des Execute Custom Query-Vorgangs eine leere Nutzlast zurück.

Beispiel: Tabelle ändern

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   ALTER TABLE customqueries98 ADD CONSTRAINT ID PRIMARY KEY (ID)

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ eine Tabelle ändern. Wenn die Aktion erfolgreich ist, gibt der Antwortparameter connectorOutputPayload des Execute Custom Query-Vorgangs eine leere Nutzlast zurück.

Beispiel: Tabelle kürzen

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   TRUNCATE TABLE customqueries99

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ eine Tabelle kürzen. Wenn die Aktion erfolgreich ist, wird im Antwortparameter connectorOutputPayload des Execute Custom Query-Vorgangs eine leere Nutzlast zurückgegeben.

Beispiel: Tabelle löschen

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   DROP TABLE customqueries99

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ eine Tabelle löschen. Wenn die Aktion erfolgreich ist, gibt der Antwortparameter connectorOutputPayload des Execute Custom Query-Vorgangs eine leere Nutzlast zurück.

Beispiel: SUM validieren

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   SELECT SUM(SALARY) as Total FROM EMPLOYEES

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ die SUMME der Aggregatfunktion validieren. Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der Execute Custom Query-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
  "Total": 7500.0
  }] 

Beispiel: AVG validieren

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   SELECT AVG(SALARY) as Average FROM EMPLOYEES

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ den Durchschnitt der Aggregatfunktion validieren. Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der Execute Custom Query-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
  "Average": 7500.0
  }] 

Beispiel: MAX validieren

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   SELECT MAX(SALARY) as Max_Salary FROM EMPLOYEES

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ den MAX-Wert der Aggregatfunktion validieren. Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der Execute Custom Query-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
  "Max_Salary": 7500.0
  }] 

Beispiel: MIN validieren

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   SELECT MIN(SALARY) as Min_Salary FROM EMPLOYEES

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ die MIN-Aggregatfunktion validieren. Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der Execute Custom Query-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
  "Min_Salary": 7500.0    
  }]

Beispiel: COUNT validieren

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   select count(*) from EMPLOYEES

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ die Anzahl der Aggregatfunktion validieren. Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der Execute Custom Query-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
  "": 1.0
  }]

Beispiel: Join und GroupBy verwenden

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   SELECT SmallMoney.amount, Sum(Testsybase.clone) AS Total
     FROM Testsybase
     INNER JOIN SmallMoney
     ON Testsybase.id = SmallMoney.id
     GROUP BY SmallMoney.amount;

In diesem Beispiel wird gezeigt, wie Sie eine benutzerdefinierte Abfrage mit Join und GroupBy ausführen. Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der Execute Custom Query-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
    "amount": 1122.56,
    "Total": 14.0
  }, {
    "amount": 123.4567,
    "Total": 11.0
  }, {
    "amount": 1123.45,
    "Total": 13.0
  }]

Beispiel: Join- und Abfrageparameter verwenden

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   SELECT e.payload,e.rest,ed.id FROM Testsybase e, Smallmoney ed where e.id=ed.id and ed.id=?

In diesem Beispiel wird gezeigt, wie Sie eine benutzerdefinierte Abfrage mit Join- und Abfrageparametern ausführen. Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der Execute Custom Query-Aufgabe einen Wert, der dem folgenden ähnelt:

 [{
    "payload": 5678.9,
    "rest": 13.6666,
    "id": 2.0
  }] 

Beispiel: GroupBy, Having und Count verwenden

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   select payload, count(payload) from Testsybase group by payload having count(payload)>=1

In diesem Beispiel wird gezeigt, wie Sie eine benutzerdefinierte Abfrage mit GroupBy, Having und Count ausführen. Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der Execute Custom Query-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
    "payload": 1234.56,
    "": 1.0
  }, {
    "payload": 2345.67,
    "": 1.0
  }, {
    "payload": 4352.78,
    "": 1.0
  }, {
    "payload": 6789.12,
    "": 1.0
  }]

Beispiel – Column Cast, LIKE und andere Operatoren verwenden

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   select e.id,e.clone from Testsybase e where e.payload>10 and e.rest LIKE '%1%' AND e.id<>3 order by e.id;

In diesem Beispiel wird gezeigt, wie eine benutzerdefinierte Abfrage mit Column Cast, LIKE und anderen Operatoren wie <> ausgeführt wird. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des Tasks Execute Custom Query einen Wert, der dem folgenden ähnelt:

[{
    "id": 1.0,
    "clone": 10.0
  }, {
    "id": 2.0,
    "clone": 99.0
  }, {
    "id": 4.0,
    "clone": 14.0
  }]

Beispiel: Funktion ausführen, indem Eingaben in die Integration eingegeben werden

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   SELECT dbo.MultiplyNumbers(5, 10) AS Result

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ eine Funktion ausführen, indem Sie Eingaben in die Integration einfügen. Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der Execute Custom Query-Aufgabe einen Wert, der dem folgenden ähnelt:

 [{
    "Result": 50.0
  }] 

Beispiel: Funktion erstellen, indem Eingaben in die Integration eingegeben werden

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   CREATE FUNCTION MultiplyNumbersTest1
     (@num1 INT, @num2 INT) 
     RETURNS INT AS RETURN @num1 * @num2

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ eine Funktion erstellen, indem Sie Eingaben in die Integration einfügen. Wenn die Aktion erfolgreich ist, gibt der Antwortparameter connectorOutputPayload des Execute Custom Query-Vorgangs eine leere Nutzlast zurück.

Beispiel: Prozedur ausführen, indem Eingaben in der Integration bereitgestellt werden

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Datenzuordnung auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in Feld Input ein:

   {
     "@EmpID": 1.0
     } 
     

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ eine Prozedur ausführen, indem Sie in der Integration eine Eingabe angeben. Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der Execute Custom Query-Aufgabe einen Wert, der dem folgenden ähnelt:

 [{
    "EmpID": 1.0,
    "LastName": "Test",
    "FirstName": "Bcone",
    "Address": "Noida",
    "City": "UP"
  }] 
  

Beispiel: Prozedur erstellen, indem Eingaben in die Integration eingegeben werden

1. Wählen Sie im Dialogfeld Configure Connector die Option Region, Connection and Actions aus.
2. Wählen Sie Execute Custom Query aus den Aktionen aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe von Connector auf Edit Custom Script und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Custom Query ein:

   CREATE PROCEDURE SelectAllEmployees2 @EmpID int
     AS
     SELECT * FROM Employees WHERE EmpID = @EmpID

In diesem Beispiel wird gezeigt, wie Sie mit „Benutzerdefinierte Abfrage ausführen“ eine Prozedur erstellen, indem Sie Eingaben in die Integration einfügen. Wenn die Aktion erfolgreich ist, gibt der Antwortparameter connectorOutputPayload des Execute Custom Query-Vorgangs eine leere Nutzlast zurück.

Beispiele für Entitätsvorgänge

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

Beispiel: Alle Datensätze auflisten

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

Beispiel: Datensatz aus einer Entität abrufen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie „numbers_table“ aus der Liste Entity aus.
3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf „Get single numbers_table“ fest. Klicken Sie zum Festlegen der Entitäts-ID im Abschnitt Data Mapper des Data Mapping auf Open Data Mapping Editor. Geben Sie dann 1.0 in das Feld Input Value ein und wählen Sie „EntityId“ als lokale Variable aus.

Beispiel: Eintrag erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie „numbers_table“ aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Data Mapper der Aufgabe auf den OpenDataMapping-Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld field: ein:

   {
   "bigint_column": 1.2345678901234516E16,
   "usmallint_column": 124.0,
   "numeric_column": 987.664,
   "real_column": 67.88999938964847,
   "uint_column": 125.0,
   "ubigint_column": 1.2345678901234516E16,
   "decimal_column": 124.459,
   "smallint_column": 16.0,
   "int_column": 125.0,
   "floatn_column": 154.45,
   "tinyint_column": 127.0,
   "id": 20.0
   }

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

   {
   "Success": true 
   }
   

Example - Update a record

1. In the Configure connector task dialog, click Entities.
2. Select numbers_table from the Entity list.
3. Select the Update operation, and then click Done.
4. Set the entity ID to Update a numbers_table. To set the entity ID, in the Data mapper section of the Tasks, click entityId and then enter 20.0 in the given field.
5. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

    
   {
   "uint_column": 128.0,
   "floatn_column": 154.95
   }

Wenn Sie dieses Beispiel ausführen, wird bei Erfolg eine leere Nutzlast zurückgegeben.

Beispiel: Daten aus einer Tabelle löschen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie „numbers_table“ aus der Liste Entity aus.
3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf „Delete numbers_table“ fest. Klicken Sie zum Festlegen der Entitäts-ID im Abschnitt Data Mapper des Data Mapping auf Open Data Mapping Editor. Geben Sie dann 2.0 in das Feld Input Value ein und wählen Sie „EntityId“ als lokale Variable aus.