Questa sezione contiene le procedure per la configurazione delle seguenti attività database in uscita
per tabella singola.
Tali attività includono:
- Inserisci righe - Questa attività rileva i dati dalla variabile o dalle variabili associate ai parametri di input dell'attività e inserisce tali dati come righe nella tabella di database specificata.
- Aggiorna righe - Questa attività rileva i dati dalla variabile o dalle variabili associate ai parametri di input dell'attività e aggiorna le righe della tabella di database specificata con questi nuovi dati.
- Elimina righe - Questa attività rileva i dati dalla variabile o dalle variabili associate ai parametri di input dell'attività ed elimina le righe della tabella di database specificata in base a questi dati.
Per le attività
Aggiorna righe ed
Elimina righe, il dispositivo di integrazione integra la tabella di database per determinare quali colonne nella tabella sono colonne delle chiavi primarie. Quando, durante il runtime, vengono avviate le attività
Aggiorna righe o
Elimina righe, il dispositivo di integrazione utilizza il valore della variabile in entrata che contiene il numero della chiave primaria, per determinare quali righe aggiornare o eliminare.
Ad esempio, la colonna
PK è definita nel database come colonna della chiave primaria per la tabella di database.
La casella di spunta
Utilizza è selezionata per la colonna
PK nell'attività
Seleziona tabella dell'
Elenco di controllo per l'attività
Elimina righe. Nel pannello Associa input dell'attività
Elimina righe, la variabile denominata
myIncomingPK è associata all'elemento
PK della riga, come mostrato nella
Figura 1:
Figura 1. myIncomingPK è associata all'elemento PK della riga
Durante il runtime, se il valore della variabile
myIncomingPK è uguale a 3, la riga con
PK uguale a 3 viene eliminata dalla tabella, come mostrato nella
Figura 2:
Figura 2. La riga con la chiave primaria uguale a 3 viene eliminata
Se nessuna colonna della chiave primaria è specificata nell'attività
Seleziona tabella dell'
Elenco di controllo, specificare almeno una colonna che funzioni come la chiave primaria. Specificare la colonna o le colonne che fungono da chiave primaria, utilizzando la finestra di dialogo Configura chiavi primarie, disponibile facendo clic su
Chiavi nell'attività
Seleziona tabella dell'
Elenco di controllo per le attività
Elimina righe e
Aggiorna righe. Se nella finestra di dialogo Configura chiavi primarie non viene specificata o selezionata, nella tabella di database, alcuna chiave primaria, l'operazione di eliminazione o di aggiornamento interesserà tutte le righe della tabella di database.
Inoltre, è possibile utilizzare la finestra di dialogo Configura chiavi primarie per specificare colonne supplementari che devono funzionare come colonne delle chiavi primarie. Ad esempio, per la tabella nella figura precedente, è possibile definire che la colonna Nome funzioni come colonna della chiave primaria insieme alla colonna primaria PK definita nel database come colonna della chiave primaria.
Aggiunta di un'attività database in entrata per tabella singola all'orchestrazione
- Creare o aprire un'orchestrazione. Viene visualizzata una rappresentazione grafica
dell'orchestrazione.
- Selezionare la scheda Attività ed espandere la cartella
Database.
- Trascinare l'attività database in entrata
per tabella singola desiderata (Inserisci righe, Elimina righe o Aggiorna righe) nell'orchestrazione.
- Selezionare l'attività.
Creazione, selezione o modifica di un endpoint del database
- Fare clic sull'attività Seleziona endpoint dall'Elenco di controllo e
scegliere una delle seguenti azioni:
- Selezionare un endpoint esistente:
- Selezionare Sfoglia. Viene visualizzato Esplora progetto.
- Selezionare un endpoint esistente e fare clic su OK.
Passare alla procedura "Configura l'attività".
- Selezionare un endpoint esistente e modificare l'endpoint:
- Selezionare Sfoglia. Viene visualizzato Esplora progetto.
- Selezionare un endpoint esistente e fare clic su OK.
- Fare clic su Modifica. Viene visualizzato il pannello Modifica endpoint.
- Creare un endpoint: selezionare Nuovo. Viene visualizzato il pannello
Crea endpoint.
- 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
- Fare clic su Seleziona tabella dall'Elenco di controllo.
Viene visualizzato il pannello Seleziona tabella.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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:
- Fare clic su Valori precedenti. Viene visualizzata la finestra di dialogo Colonne valori precedenti per aggiornamenti.
- Selezionare la casella di spunta Memorizza per le colonne di database di cui si desidera salvare i valori originali.
- È 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Configurare le opzioni dei tentativi. Per ulteriori informazioni,
consultare Opzioni dei tentativi per le attività database in entrata.
Specifica della tabella di database di destinazione per l'attività
- Fare clic su Seleziona tabella dall'Elenco di controllo.
Viene visualizzato il pannello Seleziona tabella.
- Fare clic su Sfoglia... per selezionare la tabella di database di destinazione. Viene visualizzata la finestra di dialogo Sfoglia tabelle di database.
- 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.
- 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.
- 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. Se una colonna non è selezionata, non viene visualizzata nel pannello Associa input e non viene aggiornata durante il runtime. Fare clic su Utilizza tutto per selezionare di nuovo tutte le colonne.
- 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.
- 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 viene 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.
- 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.
- 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.
- Solo per l'attività Aggiorna righe - Selezionare la casella di spunta Inserire la riga se non esiste già, se si desidera che, durante il runtime, l'attività Aggiorna righe prima tenti di aggiornare la riga specificata, ma, se la riga non esiste, la inserisca nella tabella di database.
- Solo per l'attività Aggiorna righe - se si desidera salvare sia i nuovi valori che i valori originali nel database, eseguire queste operazioni:
- Fare clic su Valori precedenti. Viene visualizzata la finestra di dialogo Colonne valori precedenti per aggiornamenti.
- Selezionare la casella di spunta Memorizza per le colonne di database di cui si desidera salvare i valori originali.
- È possibile modificare i nomi predefiniti assegnati alle colonne che memorizzano i valori originali durante il runtime. Fare doppio clic nella cella appropriata Nome colonna per memorizzare valore precedente.
- Fare clic su OK. Le colonne selezionate sono visualizzate nella sezione
A attività del pannello Associa output, precedute dalla stringa: old_.
È possibile associare sia i nuovi valori che i valori originali dal pannello Associa output.
- Solo per le attività Aggiorna righe o Elimina righe - Per specificare colonne che fungono da chiave primaria, oltre alle colonne delle chiavi primarie già definita dal database, eseguire queste operazioni:
- Fare clic su Chiavi. Viene visualizzata la finestra di dialogo Configura chiavi primarie.
- Per specificare una colonna in modo che funzioni come colonna della chiave primaria, fare clic sulla colonna e, quindi, su >>.
- Fare clic su OK.
Nota: se nessuna colonna della chiave primaria (secondo la definizione del database) è stata specificata nell'attività Seleziona tabella dell'Elenco di controllo, è necessario specificare almeno una colonna che funzioni come colonna della chiave primaria.
Ripetere questa operazione per specificare più colonne che fungono da chiave primaria.
- 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.
- Configurare le opzioni dei tentativi. Per ulteriori informazioni,
consultare Opzioni dei tentativi per le attività database in uscita.
Associazione dell'input dell'attività
- Selezionare l'attività Associa input
nell'Elenco di controllo.
I parametri di input per l'attività vengono visualizzati sotto l'elemento
row nel pannello A
attività. I parametri di input visualizzati nel pannello
Da attività corrispondono alle colonne selezionate nell'attività
Seleziona tabella. Se la casella di spunta
Esegui batch di più righe per messaggio è stata selezionata nelle
Regole di consegna, viene visualizzato il simbolo delle ricorrenze multiple accanto all'elemento row.
Nota: solo per l'attività Acquisisci righe aggiornate, se sono state selezionate delle colonne 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.
- Associare tutti i parametri di input. Per istruzioni generiche relative all'associazione, consultare
Creazione di un'associazione. È necessario associare tutti i parametri di input dell'attività.
Associazione dell'output dell'attività
- Selezionare l'attività Associa output nell'Elenco di controllo.
La casella di spunta
Acquisisci conteggi righe determina quali elementi vengono visualizzati nel pannello Associa output.
- Se la casella di spunta Acquisisci conteggi righe è deselezionata nelle Regole di consegna, il pannello Associa output è vuoto.
- Se la casella di spunta Acquisisci conteggi righe è selezionata nelle Regole di consegna, il pannello Associa output visualizza l'elemento rowCount.
Se è selezionata la casella di spunta Esegui batch di più righe per messaggio nelle Regole di consegna, viene visualizzato il simbolo delle ricorrenze multiple accanto all'elemento rowCount.
- Se viene visualizzato il parametro di output RowCount, associare il parametro di output RowCount, se lo si desidera.
Per istruzioni generiche relative all'associazione, consultare
Creazione di un'associazione. Non è necessario associare i parametri di output dell'attività.