Jump to: navigation, search

Difference between revisions of "HowTo:Connect To Oracle With A Workflow"


(Example)
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{UBIK}} uses OLEDB to connecti to Oracle via TNS (Transparent Network Substrate), therefore it is necessary to configure the connection to the server on your local environment prior to connecting to an Oracle database.
+
{{UBIK}} uses OLEDB to connect to Oracle via TNS (Transparent Network Substrate), therefore it is necessary to configure the connection to the server on your local environment prior to connecting to an Oracle database.
  
 
= Instructions =
 
= Instructions =
# Configure the Oracle server in the TNS Names of your Oracle client:
+
<ol>
## Locate the file ''tnsnames.ora'' in the directory '''[ORACLESOFTWARE]\network\admin\'''
+
<li>Configure the Oracle server in the TNS Names of your Oracle client:
## Configure the connection and call it (like in this example TESTDB):<br/><pre><source lang="text">
+
* Locate the file ''tnsnames.ora'' in the directory '''[ORACLESOFTWARE]\network\admin\'''
 +
* Configure the connection and call it (like in this example TESTDB):<br/>
 +
<source lang="text">
 
TESTDB=
 
TESTDB=
 
  (DESCRIPTION =
 
  (DESCRIPTION =
Line 14: Line 16:
 
  )
 
  )
 
)
 
)
</source></pre>
+
</source>
#: Use the [[CreateOLEOracleScope (Activity)]] activity to configure the connection via the arguments:
+
</li>
 +
<li>Use the [[Activity:CreateOLEOracleScope (Activity)]] activity to configure the connection via the arguments:</li>
 
#* the Oracle database '''DataSource'''
 
#* the Oracle database '''DataSource'''
 
#* the '''InitialCatalog'''
 
#* the '''InitialCatalog'''
 
#* '''UserName''' and '''Password'''
 
#* '''UserName''' and '''Password'''
# Use the [[CreateOLETableScope (Activity)]] activity or a [[CreateOLEQueryScope (Activity)]] to define the table you want to fetch data from. Set the tablename in the '''DisplayName''' argument.
+
<li>Use the [[Activity:CreateOLETableScope (Activity)]] activity or a [[Activity:CreateOLEQueryScope (Activity)]] to define the table you want to fetch data from. Set the tablename in the '''DisplayName''' argument.</li>
# Use a '''ForEach<DataRow>''' activity to iterate over the records fetched from the table.
+
<li>Use a '''ForEach<DataRow>''' activity to iterate over the records fetched from the table.</li>
# A column of the recordset (table) can be accessed by its index.
+
<li>A column of the recordset (table) can be accessed by its index.</li>
 +
</ol>
  
=Example Workflows=
+
=Example=
Connecting to an Oracle database and fetching data with the CreateOLETableScope activity<br />
+
Connecting to an Oracle database and fetching data with the [[Activity:CreateOLETableScope (Activity)]]<br />
 +
{{FileLink|oratest.uwf|Download Workflow example}}
 
[[File:ora_example_worfklow.JPG|440px|border|alt=Example Workflow|Example Workflow]]<br />
 
[[File:ora_example_worfklow.JPG|440px|border|alt=Example Workflow|Example Workflow]]<br />
[[File:oratest.uwf|220px|border|alt=Example Workflow|Example Workflow]]
 
<br/><br/><br/>
 
  
Connecting to oracle DB and reading data with a CreateOLEQueryScope: [[File:example_workflow_sql_statement.uwf|220px|border|alt=Example SQL Statement Workflow|Example SQL Statement Workflow]]
+
Connecting to oracle DB and reading data with a CreateOLEQueryScope
<br/>
+
{{FileLink|example_workflow_sql_statement.uwf|Download Workflow example using a SQL Statement}}
  
 
+
[[Category:How-To|Connect To Oracle With A Workflow]]
[[Category:OLE]]
+
[[Category:OLE|Connect To Oracle With A Workflow]]
[[Category:Workflow]]
+
[[Category:How-To]]
+

Latest revision as of 09:17, 20 May 2015

UBIK® uses OLEDB to connect to Oracle via TNS (Transparent Network Substrate), therefore it is necessary to configure the connection to the server on your local environment prior to connecting to an Oracle database.

[edit]

Instructions

  1. Configure the Oracle server in the TNS Names of your Oracle client:
    • Locate the file tnsnames.ora in the directory [ORACLESOFTWARE]\network\admin\
    • Configure the connection and call it (like in this example TESTDB):
    TESTDB=
     (DESCRIPTION =
       (ADDRESS_LIST =
         (ADDRESS = (PROTOCOL = TCP)(Host =AUGTESTORACLE.cloudapp.net)(Port = 1521))
       )
     (CONNECT_DATA =
       (SERVICE_NAME = UBIKTEST)
     )
    )
  2. Use the CreateOLEOracleScope (Activity) activity to configure the connection via the arguments:
      • the Oracle database DataSource
      • the InitialCatalog
      • UserName and Password
  3. Use the CreateOLETableScope (Activity) activity or a CreateOLEQueryScope (Activity) to define the table you want to fetch data from. Set the tablename in the DisplayName argument.
  4. Use a ForEach<DataRow> activity to iterate over the records fetched from the table.
  5. A column of the recordset (table) can be accessed by its index.

Example

Connecting to an Oracle database and fetching data with the CreateOLETableScope (Activity)
IC FileLink Download.png Download Workflow example Example Workflow

Connecting to oracle DB and reading data with a CreateOLEQueryScope IC FileLink Download.png Download Workflow example using a SQL Statement