Differences

This shows you the differences between two versions of the page.

--- versago3:dataview_setup [2022/09/07 11:01]
dlee
+++ versago3:dataview_setup [2023/07/14 12:38] (current)
dlee [Stored Procedure]
@@ Line 26: / Line 26: @@
   * **List or Chart** format is the default “row & column” presentation.
   * **Enable Paging** is used in conjunction with **Page Count** if you want to ensure that a specific number of records are displayed on each page.
-  * The **Schedule** presents the data view in a calendar format. See the **//[[versago:calendar_report_configuration|Schedule]]//** page for additional configuration information.
+  * The **Schedule** format presents the data view in a calendar. See the **//[[versago3:dataview_schedule#Schedule]]//** page for additional configuration information.
 ==== Connection ====
-* **Database** is the database connection to be used for the report.  See the **//[[versago:database_connection_configuration|Database Connections Configuration]]//** page for information on configuring database connections.
+  * Select the **Connection Name** from the list of configured connections. See the **//[[versago3:connections|Connections]]//** page for information on configuring database connections.
-      * When a connection is selected, the associated database name is displayed in the “Database Name” field.
+      * When a connection is selected, the associated database name is displayed to the right.
-  * **Data Source Type** are the various ways to obtain data from a database. The values displayed in the **Data Source** area will vary depending on the selected Report Object Type.  See the **//[[report_object_types|Report Data Source Types]]//** page for information on how the different types are used.
+  * Select the **Data Source Type**
+===== Data Source Types =====
+{{  :versago3:dv_setup02.png?200  |}}
+==== SQL Query ====
+When this option is selected, a SELECT SQL statement can be entered manually or pasted from another source such as SQL Server Management Studio.
+{{  :versago3:dv_setup03.png?direct  |}}
+  * Enter the SELECT statement in the “Editor” area.
+  * Click [**Execute**] to validate the statement.
+  * Standard SQL error messages will be displayed if errors are encountered.
+  * If the statement is correct, the first 50 records of the dataset are displayed in the “Results” area.
+=== SQL Statement Restrictions ===
+  * An **Order By** clause cannot be used except in cases where the statement contains a TOP operator. The ordering (sorting) is handled by the data view's Field Display settings
+  * **Computed values** in the SQL statement must be assigned an alias.
+==== B1 Query ====
+This option should only be used with connections to SAP Business One. This option allows to select user queries built in SAP Business One.
+==== Stored Procedure ====
+In some rare instances it may be necessary to use an SQL Stored Procedure as the data source. This approach is not recommended if any other option is available.
+Store procedure parameters must be configured in the **//[[versago3:dataview_filters|Filters]]//** page.
+<WRAP center round important 100% >
+**Stored Procedure Limitations**
+</WRAP>
+Versago uses the view sys.dm_exec_describe_first_result_set_for_object to determine the store procedure's result set schema.
+However, there are limitations with the system view that restricts the use of some store procedures in Versago.
+The limitations include the use of temp tables and dynamic sql in the store procedure.
+Use the following query to determine if your store procedure will be suitable to be used as a Versago data source:
+<code>
+SELECT name, system_type_name
+FROM sys.dm_exec_describe_first_result_set_for_object(OBJECT_ID(@StoredProcedureName), 0)
+</code>
+====View====
+This option allows the use of a database View as the data source
+==== Crystal Report ====
+A Data View can be configured to display a Crystal Report. When this option is selected, the Crystal Report definition file is uploaded to the Versago site and used as the presentation method.
+<WRAP center round important 80% >
+The data source used in the Crystal Report definition **must** be the same as that of the Versago Data View connection.
+</WRAP>
+  * Select Crystal Report as the data source type.
+  * A dialog box is presented where a Crystal Report definition file (.RPT) can be selected.
+The Crystal Report source file is copied from the original location to the folder “C:\Program Files (x86)\TWBS\Versago\Websites\Versago Administration Web Site\Reports.” A number is prefixed to the file name to ensure it uniqueness. If the Crystal Report needs to be modified, you can either modify this file or modify it elsewhere and re-register the new version in Versago.
+---
+=====**Need to review**=====
+===SQL Server===
+When designing a Crystal Report that will use a __SQL Server__ database as its data source, the report connection type must be **OLE DB (ADO)**. This connection type has three options for the data provider: **SQL Native Client**, **Microsoft OLE DB Driver for SQL Server**, and **Microsoft OLE DB Provider for SQL Server**.  Any of these options should work with Versago.
+===HANA===
+When designing a Crystal Report that will us a __HANA__ database as its data source, the report connection type be **ODBC (RDO)**.  **{{ :versago:b1h_90_ht_setupdsforcrl.pdf |This document }}** explains how to configure this type of connection for use with HANA.  Two options are described in the document.  Be sure to use the **B1CRHPROXY32** option.  Here is a sample connection string to use as a starting point.
+<code>
+DRIVER={B1CRHPROXY32};SERVERNODE=<YourServer>:30015;DATABASE=<YourDB>
+</code>
+Replace <YourServer> and <YourDB> (without the < > symbols) with the appropriate values.
+----
+**[[versago3:dataview#Add/Edit Data View]]**
+**[[versago3:Home|Home]]**

Wiki

User Tools

Site Tools

Differences

Page Tools