Operazioni sulle tabelle e sulle viste di interfaccia
L'adapter Microsoft BizTalk per Oracle E-Business Suite visualizza un set di operazioni standard (Selezionare, Inserire, Aggiornare ed Eliminare) per ogni tabella dell'interfaccia e l'operazione Select per ogni visualizzazione dell'interfaccia in Oracle E-Business Suite. Usando queste operazioni, è possibile eseguire le istruzioni SELECT, INSERT, UPDATE e DELETE qualificate da una clausola WHERE nella tabella dell'interfaccia di destinazione e l'istruzione SELECT qualificata da una clausola WHERE nella visualizzazione dell'interfaccia di destinazione. Queste operazioni sono chiamate anche operazioni DML (Data Manipulation Language).
Importante
Prima di poter eseguire operazioni sulle tabelle dell'interfaccia e sulle visualizzazioni dell'interfaccia, è necessario impostare il contesto delle applicazioni per questi artefatti nella scheda Oracle E-Business. Ciò avviene perché l'impostazione del contesto delle applicazioni facilita le transazioni sicure in Oracle E-Business Suite impostando le preferenze utente (ad esempio responsabilità, organizzazione e impostazioni della lingua) e il controllo di accesso per un artefatto. Per altre informazioni sul contesto delle applicazioni e su come impostarlo, vedere Impostare contesto applicazione.
Operazioni DML supportate
Nella tabella seguente vengono illustrate le operazioni DML supportate dall'adapter Oracle E-Business:
| Operazione | Descrizione |
|---|---|
| Selezione | Esegue un'operazione select nella tabella dell'interfaccia di destinazione o nella visualizzazione interfaccia in base a un elenco fornito di nomi di colonne e una stringa di filtro che specifica una clausola SQL WHERE. Il valore restituito per un'operazione Select è un set di risultati fortemente tipizzato che contiene le colonne e le righe specificate. |
| Insert | Esegue un'operazione Di inserimento nella tabella dell'interfaccia di destinazione. L'operazione Inserisci supporta l'inserimento di più record nella tabella dell'interfaccia di destinazione in base a un set di record fornito. Il valore restituito per un'operazione Di inserimento è il numero di righe inserite. InlineValue Per tutti i record di dati semplici in un'operazione di inserimento, è possibile scegliere di eseguire l'override del valore di un record specificando un valore per un attributo facoltativo denominato InlineValue. L'attributo InlineValue può essere usato per inserire valori calcolati in tabelle di interfaccia, ad esempio popolando la colonna chiave primaria usando una sequenza o inserendo la data di sistema (usando SYSDATE) in una colonna di data. Ad esempio, nell'istruzione INSERT seguente: <Insert xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/InterfaceTables/AR/AR_ARCHIVE_PURGE_INTERIM"> <RECORDSET> <InsertRecord xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/TableViewRecord/AR/AR_ARCHIVE_PURGE_INTERIM"> <TRNS_DATE InlineValue="sysdate">2008-06-21T15:52:19</TRNS_DATE> <EMPNAME>John</EMPNAME> </InsertRecord> </RECORDSET> </Insert>Anche se "2008-06-21T15:52:19" viene specificato come valore per TRNS_DATE, il valore dell'attributo InlineValue , "SYSDATE", (data di sistema) verrà inserito nella tabella dell'interfaccia di destinazione. Durante l'uso dell'attributo InlineValue: - Evitare di usare valori costanti per l'attributo InlineValue. Ad esempio, nell'istruzione INSERT, se si specifica <EMPNAME InlineValue="John"/> , verrà generato un errore. Questo perché il valore dell'attributo InlineValue viene passato come è a Oracle e in questo caso John viene passato a Oracle E-Business Suite, che non è il valore previsto (il valore previsto è 'John'). È necessario usare virgolette singole intorno al nome del dipendente. Ad esempio: <EMPNAME InlineValue="’John’"/>.- Se si vuole usare una query di selezione per l'attributo InlineValue, è necessario racchiudere l'istruzione SELECT tra parentesi e assicurarsi anche che la query seleziona recupera solo un singolo record. Ad esempio: <EMPNAME InlineValue="(SELECT NAME FROM MS_SAMPLE_EMPLOYEES WHERE ID=123)"/>.Nota: Se un elemento è contrassegnato come NOT NULL in Oracle E-Business Suite, è necessario specificare un valore per tale elemento anche se è stato specificato un valore inline. Se non si esegue questa operazione, la convalida dello schema avrà esito negativo. |
| Aggiornamento | Esegue un'operazione di aggiornamento nella tabella dell'interfaccia di destinazione. I record da aggiornare vengono specificati da una stringa di filtro che specifica una clausola SQL WHERE. I valori per l'aggiornamento vengono specificati in un record modello. Il valore restituito per un'operazione di aggiornamento è il numero di righe aggiornate. |
| Delete | Esegue un'operazione Delete nella tabella dell'interfaccia di destinazione in base a una clausola SQL WHERE specificata in una stringa di filtro. Il valore restituito per un'operazione Delete è il numero di righe eliminate. |
Dettagli importanti
L'adapter Oracle E-Business illustra lo stesso set di operazioni standard (Selezionare, Inserire, Aggiornare ed Eliminare) per ogni tabella e l'operazione Select per ogni visualizzazione nel database Oracle sottostante. Le operazioni DML precedenti sono valide anche per le tabelle e le viste del database Oracle sottostanti.
- Non è necessario impostare il contesto delle applicazioni per eseguire operazioni su tabelle e viste nel database Oracle. Tuttavia, per applicazioni Oracle E-Business Suite personalizzate, gli utenti possono o non registrare le tabelle di database di base come tabelle di interfaccia. Se una tabella di database non è registrata come tabella di interfaccia, è disponibile nel nodo Tabelle nel nodo Visualizzazione basata su artefatti o nel nodo Visualizzazione basata sullo schema in fase di progettazione durante l'uso del componente aggiuntivo del servizio adapter, Aggiungi creazione guidata metadati adapter o Plug-in di riferimento al servizio adapter.
Queste tabelle sono associate a un'applicazione Oracle E-Business. Pertanto, per qualsiasi operazione in queste tabelle, è necessario impostare il contesto dell'applicazione. Vedere Impostare ladescrizione del contesto dell'applicazione qui.
- Non è necessario impostare il contesto delle applicazioni per eseguire operazioni su tabelle e viste nel database Oracle. Tuttavia, per applicazioni Oracle E-Business Suite personalizzate, gli utenti possono o non registrare le tabelle di database di base come tabelle di interfaccia. Se una tabella di database non è registrata come tabella di interfaccia, è disponibile nel nodo Tabelle nel nodo Visualizzazione basata su artefatti o nel nodo Visualizzazione basata sullo schema in fase di progettazione durante l'uso del componente aggiuntivo del servizio adapter, Aggiungi creazione guidata metadati adapter o Plug-in di riferimento al servizio adapter.