Attività database in entrata per tabella singola

Durante il runtime, le attività database in entrata per tabella singola eseguono il polling, per controllare se si è verificata un'operazione del database sulle righe nelle colonne specificate di una tabella di database, ad un intervallo di tempo specificato.

Questa sezione contiene le procedure per la configurazione delle seguenti attività database in entrata per tabella singola: La Figura 1 mostra il trasferimento dei dati di esempio nell'evento trigger UPDATE e l'attività Acquisisci righe aggiornate:
Figura 1. Esempio trigger UPDATE
Dopo la pubblicazione dell'orchestrazione con un'attività database in entrata nel dispositivo di integrazione, è necessario creare la tabella di buffer e i trigger, utilizzando la WMC (Web Management Console) prima che l'orchestrazione venga distribuita. Per il database Oracle, è necessario, inoltre, creare una sequenza mediante la WMC.

Errore al runtime - Nessuna attività per tale operazione

Se un'orchestrazione accede ad una tabella di buffer che contiene una riga per un'attività che attualmente non è presente nell'orchestrazione, l'orchestrazione ha esito negativo e viene riportato il seguente errore durante il runtime:
The buffer table contains the OperType operation but there is no activity in the orchestration for that operation.
Dove OperType è il tipo di operazione; ad esempio, INSERT. I valori della colonna IH_OPERATION_NAME nella tabella di buffer per l'orchestrazione devono essere congruenti con le attività del database nell'orchestrazione. Ad esempio, se una riga nella tabella di buffer contiene il valore: INSERT nella colonna  IH_OPERATION_NAME, ma l'orchestrazione non contiene un'attività Acquisisci righe inserite, viene riportato questo errore. Ogni orchestrazione deve disporre di una tabella di buffer separata. Inoltre, i trigger nella tabella di origine devono essere congruenti con le operazioni del database specificate nella tabella di buffer. Ad esempio, se l'orchestrazione contiene solo un'attività Acquisisci righe aggiornate in entrata singola, la tabella di database di origine deve contenere solo un trigger UPDATE.

Aggiunta di un'attività database in entrata per tabella singola all'orchestrazione

  1. Creare o aprire un'orchestrazione. Viene visualizzata una rappresentazione grafica dell'orchestrazione.
  2. Selezionare la scheda Attività ed espandere la cartella Database.
  3. Trascinare l'attività database in entrata per tabella singola desiderata (Acquisisci righe inserite, Acquisisci righe eliminate o Acquisisci righe aggiornate) nell'orchestrazione.
  4. Selezionare l'attività.

Creazione, selezione o modifica di un endpoint del database

  1. Fare clic sull'attività Seleziona endpoint dall'Elenco di controllo e scegliere una delle seguenti azioni:
    • Selezionare un endpoint esistente:
      1. Selezionare Sfoglia. Viene visualizzato Esplora progetto.
      2. Selezionare un endpoint esistente e fare clic su OK. Passare alla procedura "Configura l'attività".
    • Selezionare un endpoint esistente e modificare l'endpoint:
      1. Selezionare Sfoglia. Viene visualizzato Esplora progetto.
      2. Selezionare un endpoint esistente e fare clic su OK.
      3. Fare clic su Modifica. Viene visualizzato il pannello Modifica endpoint.
    • Creare un nuovo endpoint: Selezionare Nuovo. Viene visualizzato il pannello Crea endpoint.
  2. Creare o modificare un endpoint HTTP, consultare Creazione o modifica di un endpoint HTTP.

Selezione delle colonne nella tabella di database di origine in cui il dispositivo di integrazione esegue il polling delle modifiche durante il runtime

  1. Fare clic su Seleziona tabella dall'Elenco di controllo. Viene visualizzato il pannello Seleziona tabella.
  2. Fare clic su Sfoglia... per selezionare la tabella di database che deve funzionare da origine per i messaggi in entrata. Viene visualizzata la finestra di dialogo Sfoglia tabelle di database.
  3. Selezionare una tabella dall'elenco e fare clic su OK. Vengono visualizzate le informazioni relative alla colonna per la tabella selezionata, nel pannello Seleziona tabella.
  4. Se la codifica dei caratteri per tale tabella è diversa dalla codifica per il database, immettere un'altra codifica utilizzando una delle seguenti opzioni:
    • Dall'elenco Codifica, selezionare uno dei tipi di codifica predefiniti.  
    • Immettere il tipo di codifica direttamente, facendo clic nel campo Codifica e digitando il tipo di codifica.
    In tal modo, viene impostata la codifica per tutte le colonne della tabella di buffer risultante.
    Nota: alcuni caratteri double-byte non vengono convertiti mediante la codifica SHIFT-JIS. Per ulteriori informazioni, consultare Utilizzo della codifica Shift-JIS.
  5. Per impostazione predefinita, tutte le colonne nella tabella di origine sono selezionate. Deselezionare la casella di spunta Utilizza per rimuovere una colonna dalla tabella di buffer risultante. Fare clic su Utilizza tutto per selezionare di nuovo tutte le colonne.
  6. Fare clic nell'intestazione della colonna per ordinare le righe in base al valore della colonna. Ad esempio, per ordinare le righe in base al nome della colonna, fare clic sull'intestazione Nome colonna della colonna. Viene visualizzata una freccia sulla destra del nome di intestazione della colonna. Una freccia verso l'alto indica che la colonna è ordinata in ordine alfabetico, a cominciare dalla a fino alla z. Una freccia verso il basso indica che la colonna è ordinata in ordine alfabetico inverso, a cominciare dalla z fino alla a. Fare clic sulla freccia per invertire l'irdine alfabetico.
  7. Solo per l'attività Acquisisci righe aggiornate - se si desidera che la tabella di buffer risultante contenga sia i nuovi valori che i valori originali delle colonne aggiornate, eseguire queste operazioni:
    1. Fare clic su Valori precedenti. Viene visualizzata la finestra di dialogo Colonne valori precedenti per aggiornamenti.
    2. Selezionare la casella di spunta Memorizza per le colonne di database di cui si desidera salvare i valori originali.
    3. È possibile modificare i nomi predefiniti assegnati alle colonne per memorizzare i valori originali. Fare doppio clic sulla cella appropriata Nome colonna per memorizzare valore precedente.
    4. Fare clic su OK. Le colonne selezionate sono visualizzate in Da attività del pannello Associa output, precedute dalla stringa: old_. È possibile associare sia i nuovi valori che i valori originali dal pannello Associa output.  
    Nota: per ulteriori informazioni, consultare Definizione delle colonne per valori precedenti negli aggiornamenti.
  8. Se necessario, modificare le impostazioni dei valori Tipo di dati, Codifica o Valore null supportato. Fare clic nel campo per effettuare una nuova selezione.
    • Tipo di dati - Viene utilizzato, come impostazione predefinita, il tipo di dati della colonna nella tabella di database di origine. Se il tipo di dati richiesto per la colonna nella tabella di buffer è diverso dal tipo di dati della tabella di origine, selezionare un tipo di dati diverso, facendo clic nella cella Tipo di dati e selezionando un altro Tipo di dati dall'elenco. Per i tipi di dati contrassegnati come NON SUPPORTATI, è necessario selezionare un tipo di dati appropriato.
      Nota: per il tipo di dati XMLTYPE in un database Oracle e i tipi di dati MONEY in un database SQL Server, Studio non associa automaticamente il tipo di dati corretto, quindi è necessario selezionare manualmente il tipo di dati appropriato.
      Attenzione: è necessario selezionare un tipo di dati compatibile con il tipo di dati di origine, per evitare dati non validi durante il runtime. Ad esempio, non selezionare il tipo di dati SMALLINT per la tabella di buffer se il tipo di dati di origine è INTEGER, in quanto, durante il runtime, un numero elevato memorizzato in una colonna INTEGER non verrà correttamente convertito nel tipo di dati SMALLINT.
    • Dimensione — La dimensione della colonna definita nella tabella. Tale dimensione viene richiamata dalla tabella di database e non può essere configurata.
    • Codifica - Viene utilizzata la codifica predefinita corrente, impostata a livello del database o a livello della tabella. Se la codifica richiesta per la colonna è diversa dalla codifica predefinita corrente, selezionare un'altra codifica facendo clic nella cella Codifica e selezionando un'altra Codifica dall'elenco.  
    • Valore null supportato - Viene utilizzata, come impostazione predefinita, la stessa specifica di supporto del valore null della colonna nella tabella di database di origine. La casella di spunta Utilizza deve essere selezionata per le colonne in cui nullable=false. Una colonna contrassegnata come nullable=false non può contenere un valore null durante il runtime.
  9. Fare clic su Reimposta per reimpostare tutte le proprietà della colonna sui valori predefiniti. In tal modo, viene anche reimpostata la casella di spunta Utilizza per tutte le colonne.
  10. Fare clic su Aggiorna per aggiornare l'elenco di colonne in riferimento allo stato più recente del database di origine. Le modifiche all'origine recenti vengono aggiornate in questo pannello.
  11. Configurare Specifica delle regole di consegna per le attività database.
    Nota: se si seleziona l'opzione Una sola volta nell'attività Regole di consegna, è necessario creare le tabelle di controllo utilizzate dal dispositivo di integrazione durante il runtime. Le tabelle di controllo vengono create dopo la pubblicazione dell'orchestrazione da Studio nel dispositivo di integrazione. Le tabelle di controllo vengono create mediante la WMC (Web Management Console) prima di distribuire il progetto.
    Nota: se si seleziona l'opzione Una sola volta, è necessario abilitare la persistenza. Per ulteriori informazioni, consultare Abilitazione della persistenza.
  12. Configurare le opzioni dei tentativi. Per ulteriori informazioni, consultare Opzioni dei tentativi per le attività database in entrata.

Associazione dell'output dell'attività

  1. Selezionare l'attività Associa output nell'Elenco di controllo.

    I parametri di output per l'attività vengono visualizzati sotto l'elemento rows nel pannello Da attività. I parametri di output visualizzati nel pannello Da attività corrispondono alle colonne selezionate nell'attività Seleziona tabella. Se è selezionata l'opzione Batch in Regole di consegna, viene visualizzato il simbolo di ricorrenze multiple vicino all'elemento row.

    Nota: solo per l'attività Acquisisci righe aggiornate, se alcune colonne sono state selezionate nella finestra di dialogo Colonne valori precedenti per aggiornamenti (nell'attività Seleziona tabella), vengono visualizzati anche questi parametri di output supplementari (preceduti, per impostazione predefinita, dalla stringa: old_), sotto l'elemento rows. È necessario associare tutte le colonne di valori precedenti visibili nel pannello Associa output.
  2. Associare i parametri di output richiesti alla variabile o alle variabili. Per istruzioni generiche relative all'associazione, consultare Creazione di un'associazione. Non è necessario associare i parametri di output per queste attività.
    Nota: dopo la pubblicazione dell'orchestrazione con un'attività database in entrata nel dispositivo di integrazione, è necessario creare la tabella di buffer, utilizzando la WMC (Web Management Console) prima che l'orchestrazione venga distribuita.