Establishes a connection to a database.
Returns a CwDBConnection object.
The Get Database Connection function block can throw the CwDBConnectionFactoryException exception if an error occurs while trying to establish the database connection.
The Get Database Connection function block obtains a connection from the connection pool that the Connection Pool Name input specifies. This connection provides a way to perform queries and updates to the database associated with the connection. All connections in a particular connection pool are associated with the same database. The function block returns a CwDBConnection object through which you can execute queries and manage transactions.
By default, all connections use implicit transaction bracketing as their transaction programming model. To specify a transaction programming model for a particular connection, use the Get Database Connection with Transaction function block.
The connection is released when the collaboration object finishes execution. You can explicitly close this connection with the Release function block. You can determine whether a connection has been released with the Is Active function block. For more information, see Releasing a connection.
This function block is based on the BaseCollaboration.getDBConnection() method. For more information, see getDBConnection().