Abgehende Einzeltabellendatenbankaktivitäten

Dieser Abschnitt enthält die Prozeduren zum Konfigurieren der folgenden abgehenden Einzeltabellendatenbankaktivitäten.

Diese Aktivitäten lauten: Bei den Aktivitäten Zeilen aktualisieren und Zeilen löschen integriert die Integrationseinheit die Datenbanktabelle, um zu ermitteln, welche Spalten in der Tabelle Primärschlüsselspalten sind. Wenn die Aktivität Zeilen aktualisieren oder Zeilen löschen während der Ausführung gestartet wird, verwendet die Integrationseinheit den Wert der eingehenden Variablen, in der die Primärschlüsselnummer enthalten ist, um die Zeilen zu ermitteln, die aktualisiert oder gelöscht werden sollen.
Beispiel: Die Spalte PK wird in der Datenbank als Primärschlüsselspalte für die Datenbanktabelle definiert. Das Kontrollkästchen Verwenden wird für die Spalte PK in der Task Tabelle auswählen der Prüfliste der Aktivität Zeilen löschen ausgewählt. Im Teilfenster 'Eingaben zuordnen' der Aktivität Zeilen löschen wird die Variable myIncomingPK dem Element PK zugeordnet, wie in Abbildung 1 dargestellt:
Abbildung 1. myIncomingPK wird dem Element PK der Zeile zugeordnet
Wenn die Variable myIncomingPK während der Ausführung den Wert 3 hat, wird die Zeile mit dem PK-Wert 3 aus der Tabelle gelöscht (siehe Abbildung 2):
Abbildung 2. Die Zeile mit dem Primärschlüsselwert 3 wird gelöscht
Wenn in der Task Tabelle auswählen der Prüfliste keine Primärschlüsselspalten angegeben sind, müssen Sie mindestens eine Spalte angeben, die als Primärschlüssel fungieren soll. Geben Sie die fungierende(n) Primärschlüsselspalte(n) im Dialogfeld 'Primärschlüssel konfigurieren' an, das geöffnet wird, wenn Sie in der Task Tabelle auswählen der Prüfliste der Aktivitäten Zeilen löschen und Zeilen aktualisieren auf Schlüssel klicken. Wenn keine Primärschlüssel in der Datenbanktabelle angegeben oder als fungierende Primärschlüssel im Dialogfeld 'Primärschlüssel konfigurieren' ausgewählt werden, wirkt sich die Einfügungs- oder Aktualisierungsoperation auf alle Zeilen der Datenbanktabelle aus.

Sie können im Dialogfeld 'Primärschlüssel konfigurieren' auch zusätzliche Spalten angeben, die als Primärschlüsselspalten fungieren sollen. Sie können beispielsweise in der Tabelle der obigen Abbildung definieren, dass die Spalte Name zusätzlich zu der Primärspalte PK, die in der Datenbank als Primärschlüsselspalte definiert wurde, als Primärschlüsselspalte fungieren soll.

Abgehende Einzeltabellendatenbankaktivität zur Orchestrierung hinzufügen

  1. Erstellen oder öffnen Sie eine Orchestrierung. Eine grafische Darstellung der Orchestrierung wird angezeigt.
  2. Wählen Sie die Registerkarte Aktivitäten aus und erweitern Sie den Ordner Datenbank.
  3. Ziehen Sie die gewünschte abgehende Einzeltabellendatenbankaktivität (Zeilen einfügen, Zeilen löschen oder Zeilen aktualisieren) auf die Orchestrierung.
  4. Wählen Sie die Aktivität aus.

Datenbankendpunkt erstellen, auswählen oder bearbeiten

  1. Klicken Sie auf die Task Endpunkt auswählen in der Prüfliste und wählen Sie eine der folgenden Aktionen aus:
    • Wählen Sie einen vorhandenen Endpunkt aus:
      1. Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
      2. Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK. Springen Sie zu der Prozedur "Aktivität konfigurieren".
    • Wählen Sie einen vorhandenen Endpunkt und bearbeiten Sie den Endpunkt:
      1. Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
      2. Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK.
      3. Klicken Sie auf Bearbeiten. Das Teilfenster 'Endpunkt bearbeiten' wird angezeigt.
    • Erstellen Sie einen Endpunkt: Wählen Sie Neu aus. Das Teilfenster 'Endpunkt erstellen' wird angezeigt.
  2. Erstellen oder bearbeiten Sie einen HTTP-Endpunkt (siehe HTTP-Endpunkt erstellen oder bearbeiten).

Spalten in der Quellendatenbanktabelle auswählen, die die Integrationseinheit bei der Ausführung auf Änderungen abfragt

  1. Klicken Sie in der Prüfliste auf Tabelle auswählen. Das Teilfenster 'Tabelle auswählen' wird angezeigt.
  2. Klicken Sie auf Durchsuchen..., um die Datenbanktabelle auszuwählen, die als Quelle für abgehende Nachrichten dienen soll. Das Dialogfeld 'Datenbanktabellen durchsuchen' wird angezeigt.
  3. Wählen Sie eine Tabelle aus der Liste aus und klicken Sie auf OK. Im Teilfenster 'Tabelle auswählen' werden Spalteninformationen zu der ausgewählten Tabelle angezeigt.
  4. Wenn sich die Zeichencodierung dieser Tabelle von der Codierung der Datenbank unterscheidet, müssen Sie mit einer der folgenden Optionen eine andere Codierung eingeben:
    • Wählen Sie in der Liste Codierung einen Standardcodierungstyp aus.  
    • Geben Sie Ihren Codierungstyp direkt ein, indem Sie in das Feld Codierung klicken und Ihren Codierungstyp eingeben.
    Damit wird die Codierung für alle Spalten der resultierenden Puffertabelle festgelegt.
    Anmerkung: Bestimmte Doppelbytezeichen werden bei Verwendung der Codierung SHIFT-JIS nicht umgewandelt. Weitere Informationen finden Sie unter Shift-JIS-Codierung verwenden.
  5. Standardmäßig sind alle Spalten in der Quellentabelle ausgewählt. Wählen Sie das Kontrollkästchen Verwenden ab, um eine Spalte aus der resultierenden Puffertabelle zu entfernen. Klicken Sie auf Alle verwenden, um wieder alle Spalten auszuwählen.
  6. Klicken Sie auf die Spaltenüberschrift, um die Zeilen nach dem Spaltenwert zu sortieren. Klicken Sie beispielsweise zum Sortieren der Zeilen nach ihrem Spaltennamen auf die Spaltenüberschrift Spaltenname. Rechts neben dem Namen der Spaltenüberschrift wird ein Pfeil angezeigt. Ein Aufwärtspfeil gibt an, dass die Spalte in alphabetischer Reihenfolge sortiert wird, nämlich von a bis z. Ein Abwärtspfeil gibt an, dass die Spalte in umgekehrter alphabetischer Reihenfolge sortiert wird, nämlich von z bis a. Klicken Sie auf den Pfeil, um die alphabetische Reihenfolge umzukehren.
  7. Nur für die Aktivität Aktualisierte Zeilen abrufen - Wenn die resultierende Puffertabelle sowohl die neuen als auch die ursprünglichen Werte der aktualisierten Spalten enthalten soll, müssen Sie die folgenden Schritte ausführen:
    1. Klicken Sie auf Alte Werte. Das Dialogfeld 'Spalten mit alten Werten für Aktualisierungen' wird angezeigt.
    2. Wählen Sie für die Datenbankspalten, deren ursprüngliche Werte Sie speichern wollen, das Kontrollkästchen Speichern aus.
    3. Sie können beim Speichern der ursprünglichen Werte die Standardnamen ändern, die den Spalten zugewiesen wurden. Doppelklicken Sie auf die entsprechende Zelle Name der Spalte zum Speichern alter Werte.
    4. Klicken Sie auf OK. Die ausgewählten Spalten werden mit dem Präfix old_ im Bereich Von Aktivität des Teilfensters 'Ausgaben zuordnen' angezeigt. Sie können im Teilfenster 'Ausgaben zuordnen' sowohl die neuen als auch die ursprünglichen Werte zuordnen.  
    Anmerkung: Weitere Informationen finden Sie in Spalten mit alten Werten für Aktualisierungen definieren.
  8. Ändern Sie bei Bedarf die Werte der Optionen Datentyp, Codierung oder Kann Nullwerte enthalten. Klicken Sie auf das Feld, um eine neue Auswahl zu treffen.
    • Datentyp - Der Standardwert ist der Datentyp der Spalte in der Quellendatenbanktabelle. Wenn sich der erforderliche Datentyp der Spalte in der Puffertabelle von dem Datentyp der Quellentabelle unterscheidet, müssen Sie einen anderen Datentyp auswählen. Klicken Sie dazu in der Zelle Datentyp und wählen Sie in der Liste einen anderen Datentyp aus. Sie müssen einen geeigneten Datentyp für die als UNSUPPORTED (nicht unterstützt) markierten Datentypen auswählen.
      Anmerkung: Bei dem Datentyp XMLTYPE in einer Oracle-Datenbank und den Datentypen MONEY in einer SQL Server-Datenbank ordnet Studio den korrekten Datentyp nicht automatisch zu, sodass Sie den entsprechenden Datentyp manuell auswählen müssen.
      Achtung: Sie müssen einen Datentyp auswählen, der mit dem Quellendatentyp kompatibel ist, um bei der Ausführung ungültige Daten zu vermeiden. Beispiel: Wählen Sie für die Puffertabelle nicht den Datentyp SMALLINT aus, wenn der Quellendatentyp INTEGER lautet, weil bei der Ausführung eine in einer Spalte vom Typ INTEGER gespeicherte große Zahl nicht korrekt in den Datentyp SMALLINT umgewandelt wird.
    • Größe - Die Größe der in der Tabelle definierten Spalte. Diese Größe wird aus der Datenbanktabelle abgerufen und ist nicht konfigurierbar.
    • Codierung - Der Standardwert ist die aktuelle Standardcodierung, die entweder auf Datenbankebene oder auf Tabellenebene festgelegt wurde. Wenn sich die erforderliche Codierung für die Spalte von der aktuellen Standardcodierung unterscheidet, müssen Sie eine andere Codierung auswählen. Klicken Sie dazu in der Zelle Codierung und wählen Sie in der Liste eine andere Codierung aus.  
    • Kann Nullwerte enthalten - Der Standardwert für die Spalte in der Quellendatenbanktabelle ist 'Kann Nullwerte enthalten'. Bei Spalten mit der Einstellung nullable=false muss das Kontrollkästchen Verwenden ausgewählt werden. Eine mit nullable=false markierte Spalte darf bei der Ausführung keinen Nullwert enthalten.
  9. Klicken Sie auf Zurücksetzen, um alle Spalteneigenschaften auf ihre Standardwerte zurückzusetzen. Dabei wird auch das Kontrollkästchen Verwenden für alle Spalten zurückgesetzt.
  10. Klicken Sie auf Aktualisieren, um die Liste der betreffenden Spalten auf den neuesten Stand der Quellendatenbank zu aktualisieren. Die zuletzt an der Quelle vorgenommenen Änderungen werden in diesem Teilfenster aktualisiert.
  11. Konfigurieren Sie den Abschnitt Zustellregeln für Datenbankaktivitäten angeben.
    Anmerkung: Wenn Sie in der Task Zustellregeln die Option Genau einmal auswählen, müssen Sie Steuertabellen erstellen, die während der Laufzeit von der Integrationseinheit verwendet werden. Sie erstellen die Steuertabellen, nachdem Sie die Orchestrierung von Studio auf der Integrationseinheit publiziert haben. Sie erstellen die Steuertabellen mithilfe der Webmanagementkonsole (WMC, Web Management Console), bevor Sie das Projekt implementieren.
    Anmerkung: Wenn Sie die Option Genau einmal auswählen, müssen Sie auch die Persistenz aktivieren. Weitere Informationen finden Sie unter Datenbankzugriff (Persistenz) aktivieren.
  12. Konfigurieren Sie die Wiederholungsoptionen. Weitere Informationen finden Sie unter Wiederholungsoptionen für eingehende Datenbankaktivitäten.

Zieldatenbanktabelle für die Aktivität angeben

  1. Klicken Sie in der Prüfliste auf Tabelle auswählen. Das Teilfenster 'Tabelle auswählen' wird angezeigt.
  2. Klicken Sie auf Durchsuchen..., um die Zieldatenbanktabelle auszuwählen. Das Dialogfeld 'Datenbanktabellen durchsuchen' wird angezeigt.
  3. Wählen Sie eine Tabelle aus der Liste aus und klicken Sie auf OK. Im Teilfenster 'Tabelle auswählen' werden Spalteninformationen zu der ausgewählten Tabelle angezeigt.
  4. Wenn sich die Zeichencodierung dieser Tabelle von der Codierung der Datenbank unterscheidet, müssen Sie mit einer der folgenden Optionen eine andere Codierung eingeben:
    • Wählen Sie in der Liste Codierung einen Standardcodierungstyp aus.  
    • Geben Sie Ihren Codierungstyp direkt ein, indem Sie in das Feld Codierung klicken und Ihren Codierungstyp eingeben.
    Damit wird die Codierung für alle Spalten der resultierenden Puffertabelle festgelegt.
    Anmerkung: Bestimmte Doppelbytezeichen werden bei Verwendung der Codierung SHIFT-JIS nicht umgewandelt. Weitere Informationen finden Sie unter Shift-JIS-Codierung verwenden.
  5. Standardmäßig sind alle Spalten in der Quellentabelle ausgewählt. Wählen Sie das Kontrollkästchen Verwenden ab, um eine Spalte aus der resultierenden Puffertabelle zu entfernen. Ist eine Spalte nicht ausgewählt, wird sie nicht im Teilfenster 'Eingaben zuordnen' angezeigt und während der Ausführung nicht aktualisiert. Klicken Sie auf Alle verwenden, um wieder alle Spalten auszuwählen.
  6. Klicken Sie auf die Spaltenüberschrift, um die Zeilen nach dem Spaltenwert zu sortieren. Klicken Sie beispielsweise zum Sortieren der Zeilen nach ihrem Spaltennamen auf die Spaltenüberschrift Spaltenname. Rechts neben dem Namen der Spaltenüberschrift wird ein Pfeil angezeigt. Ein Aufwärtspfeil gibt an, dass die Spalte in alphabetischer Reihenfolge sortiert wird, nämlich von a bis z. Ein Abwärtspfeil gibt an, dass die Spalte in umgekehrter alphabetischer Reihenfolge sortiert wird, nämlich von z bis a. Klicken Sie auf den Pfeil, um die alphabetische Reihenfolge umzukehren.
  7. Ändern Sie bei Bedarf die Werte der Optionen Datentyp, Codierung oder Kann Nullwerte enthalten. Klicken Sie auf das Feld, um eine neue Auswahl zu treffen.
    • Datentyp - Der Standardwert ist der Datentyp der Spalte in der Quellendatenbanktabelle. Wenn sich der gewünschte Datentyp der Spalte in der Puffertabelle von dem Datentyp der Quellentabelle unterscheidet, müssen Sie einen anderen Datentyp auswählen. Klicken Sie dazu in der Zelle Datentyp und wählen Sie in der Liste einen anderen Datentyp aus. Sie müssen einen geeigneten Datentyp für die als UNSUPPORTED (nicht unterstützt) markierten Datentypen auswählen.
      Anmerkung: Bei dem Datentyp XMLTYPE in einer Oracle-Datenbank und den Datentypen MONEY in einer SQL Server-Datenbank ordnet Studio den korrekten Datentyp nicht automatisch zu, sodass Sie den entsprechenden Datentyp manuell auswählen müssen.
      Achtung: Sie müssen einen Datentyp auswählen, der mit dem Quellendatentyp kompatibel ist, um bei der Ausführung ungültige Daten zu vermeiden. Beispiel: Wählen Sie für die Puffertabelle nicht den Datentyp SMALLINT aus, wenn der Quellendatentyp INTEGER lautet, weil bei der Ausführung eine in einer Spalte vom Typ INTEGER gespeicherte große Zahl nicht korrekt in den Datentyp SMALLINT umgewandelt wird.
    • Größe - Die Größe der in der Tabelle definierten Spalte. Diese Größe wird aus der Datenbanktabelle abgerufen und ist nicht konfigurierbar.
    • Codierung - Der Standardwert ist die aktuelle Standardcodierung, die entweder auf Datenbankebene oder auf Tabellenebene festgelegt wurde. Wenn sich die gewünschte Codierung für die Spalte von der aktuellen Standardcodierung unterscheidet, müssen Sie eine andere Codierung auswählen. Klicken Sie dazu in der Zelle Codierung und wählen Sie in der Liste eine andere Codierung aus.  
    • Kann Nullwerte enthalten - Der Standardwert für die Spalte in der Quellendatenbanktabelle ist 'Kann Nullwerte enthalten'. Bei Spalten mit der Einstellung nullable=false muss das Kontrollkästchen Verwenden ausgewählt werden. Eine mit nullable=false markierte Spalte darf bei der Ausführung keinen Nullwert enthalten.
  8. Klicken Sie auf Zurücksetzen, um alle Spalteneigenschaften auf ihre Standardwerte zurückzusetzen. Dabei wird auch das Kontrollkästchen Verwenden für alle Spalten zurückgesetzt.
  9. Klicken Sie auf Aktualisieren, um die Liste der betreffenden Spalten auf den neuesten Stand der Quellendatenbank zu aktualisieren. Die zuletzt an der Quelle vorgenommenen Änderungen werden in diesem Teilfenster aktualisiert.
  10. Nur für die Aktivität Zeilen aktualisieren - Wählen Sie das Kontrollkästchen Zeile einfügen, falls noch nicht vorhanden aus, wenn die Aktivität Zeilen aktualisieren während der Ausführung zunächst versuchen soll, die angegebene Zeile zu aktualisieren und sie, falls nicht vorhanden, in die Datenbanktabelle einzufügen.  
  11. Nur für die Aktivität Zeilen aktualisieren - Wenn Sie sowohl die neuen als auch die ursprünglichen Werte in der Datenbank speichern wollen, müssen Sie die folgenden Schritte ausführen:
    1. Klicken Sie auf Alte Werte. Das Dialogfeld 'Spalten mit alten Werten für Aktualisierungen' wird angezeigt.
    2. Wählen Sie für die Datenbankspalten, deren ursprüngliche Werte Sie speichern wollen, das Kontrollkästchen Speichern aus.
    3. Sie können die Standardnamen ändern, die den Spalten zugewiesen wurden, in denen die ursprünglichen Werte bei der Ausführung gespeichert werden. Doppelklicken Sie auf die entsprechende Zelle Name der Spalte zum Speichern alter Werte.
    4. Klicken Sie auf OK. Die ausgewählten Spalten werden mit dem Präfix old_ im Bereich 'An Aktivität' des Teilfensters 'Ausgaben zuordnen' angezeigt. Sie können im Teilfenster 'Ausgaben zuordnen' sowohl die neuen als auch die ursprünglichen Werte zuordnen.  
    Anmerkung: Weitere Informationen finden Sie in Spalten mit alten Werten für Aktualisierungen definieren.
  12. Nur für die Aktivität Zeilen aktualisieren oder Zeilen löschen - Führen Sie die folgenden Schritte aus, um neben bereits von der Datenbank definierten Primärschlüsselspalten fungierende Primärschlüsselspalten anzugeben:
    1. Klicken Sie auf Schlüssel. Das Dialogfeld 'Primärschlüssel konfigurieren' wird angezeigt.
    2. Klicken Sie auf eine Spalte und anschließend auf >>, um diese Spalte als fungierende Primärschlüsselspalte festzulegen.
    3. Klicken Sie auf OK.
    Anmerkung: Wenn in der Task Tabelle auswählen der Prüfliste keine (von der Datenbank definierten) Primärschlüsselspalten angegeben wurden, müssen Sie mindestens eine Spalte angeben, die als Primärschlüsselspalte fungieren soll.
    Wiederholen Sie diesen Schritt, um weitere fungierende Primärschlüsselspalten anzugeben.
  13. Konfigurieren Sie den Abschnitt Zustellregeln für Datenbankaktivitäten angeben.
    Anmerkung: Wenn Sie in der Task Zustellregeln die Option Genau einmal auswählen, müssen Sie Steuertabellen erstellen, die während der Laufzeit von der Integrationseinheit verwendet werden. Sie erstellen die Steuertabellen, nachdem Sie die Orchestrierung von Studio auf der Integrationseinheit publiziert haben. Sie erstellen die Steuertabellen mithilfe der Webmanagementkonsole (WMC, Web Management Console), bevor Sie das Projekt implementieren.
    Anmerkung: Wenn Sie die Option Genau einmal auswählen, müssen Sie auch die Persistenz aktivieren. Weitere Informationen finden Sie unter Datenbankzugriff (Persistenz) aktivieren.
  14. Konfigurieren Sie die Wiederholungsoptionen. Weitere Informationen finden Sie unter Wiederholungsoptionen für abgehende Datenbankaktivitäten.

Eingabe der Aktivität zuordnen

  1. Wählen Sie die Task Eingaben zuordnen in der Prüfliste aus.
    Die Eingabeparameter der Aktivität werden im Fenster 'An Aktivität' unter dem Element Zeile angezeigt. Die im Teilfenster 'Von Aktivität' angezeigten Eingabeparameter entsprechen den Spalten, die Sie in der Task Tabelle auswählen ausgewählt haben. Wurde in der Task Zustellregeln das Kontrollkästchen Mehrere Zeilen pro Nachricht im Stapelbetrieb verarbeiten ausgewählt, wird neben dem Element 'Zeile' das Symbol für mehrere Vorkommen angezeigt.
    Anmerkung: Nur für die Aktivität Aktualisierte Zeilen abrufen - Wenn im Dialogfeld 'Spalten mit alten Werten für Aktualisierungen' (in der Task Tabelle auswählen) Spalten ausgewählt wurden, werden diese zusätzlichen Ausgabeparameter (standardmäßig mit dem Präfix old_) ebenfalls unter dem Element 'Zeilen' angezeigt.  
  2. Ordnen Sie alle Eingabeparameter zu. Allgemeine Anweisungen zur Zuordnung finden Sie unter Zuordnung erstellen. Sie müssen alle Eingabeparameter der Aktivität zuordnen.

Ausgabe der Aktivität zuordnen

  1. Wählen Sie die Task Ausgaben zuordnen in der Prüfliste aus.
    Mit dem Kontrollkästchen Anzahl der Zeilen abrufen wird bestimmt, was im Teilfenster 'Ausgaben zuordnen' angezeigt wird.
    • Wenn das Kontrollkästchen Anzahl der Zeilen abrufen in den Zustellregeln abgewählt wird, ist das Teilfenster 'Ausgaben zuordnen' leer.
    • Wenn das Kontrollkästchen Anzahl der Zeilen abrufen in den Zustellregeln ausgewählt wird, wird im Teilfenster 'Ausgaben zuordnen' das Element Anzahl der Zeilen angezeigt. Wird in der Task Zustellregeln das Kontrollkästchen Mehrere Zeilen pro Nachricht im Stapelbetrieb verarbeiten ausgewählt, wird neben dem Element Anzahl der Zeilen das Symbol für mehrere Vorkommen angezeigt.
  2. Wenn der Ausgabeparameter Anzahl der Zeilen angezeigt wird, können Sie den Ausgabeparameter Anzahl der Zeilen bei Bedarf zuordnen. Allgemeine Anweisungen zur Zuordnung finden Sie unter Zuordnung erstellen. Sie brauchen die Ausgabeparameter der Aktivität nicht zuzuordnen.