Site Management - Managed Datasources

Topic Contents [Hide]Topic Contents [Show]
  1. Add New DataSource
    1. Generate New DB
  2. DataSource Settings
    1. DataSource | Properties
    2. DataSource | Results Database

database The Managed Datasources grid blade contains the connection information for the CM4D Databases managed by a CM4D Site Database. You can create a new Managed Datasource, add an existing datasource, edit connection information and test connections. There can be one or more Managed Datasources within a Site, but a Managed Datasource cannot belong to more than one Site. Each Managed Datasource has its own settings relating to what/how data is generated for the CM4D Results database.

What is a CM4D Managed Datasource?What is a CM4D Managed Datasource?A CM4D database managed by the CM4D Site database that is used to store the actual measurement data and routines. You can implement multiple CM4D Databases. Different CM4D databases may be used to provide a logical separation of data activities. For example, your company may deploy a distinct CM4D Database for each product, model year, manufacturing facility, etc. How you utilize these databases is 100% customizable. The only thing that is required by CM4D is to define all of those databases within your CM4D Site Database and apply privileges and access to all users who need access to your CM4D data.

Managed Datasources created in Site Manger (desktop CM4D application) appear here on Refresh, and Datasources created here in the CM4D Config plug will appear in Site Manager the next time the desktop application is opened.

Actions Click the three dots more-vertical to open the menu of available actions for the selected row.
  • check-circle Open - Opens the Edit Datasource tabbed blade for the selected row.
  • trash Delete - Deletes the Datasource record from the Site. This operation does not delete the database object in SQL Server.
Datasource The label assigned to the Datasource. This may or may not be same as the label assigned as the database object in SQL Server.
Version The current schema version of the CM4D database. If no value is present, the database is new and must have scripts run before it can be used by CM4D.

Add New DataSource

New Datasources can be added to the Site by clicking the  plus Add button in the top right of the Site Management card. Enter the properties of the new Datasource in the form blade. The Add Datasource blade contains the same fields as the Datasource Properties blade, only in a more compact format.

  1. Click Add to create a new CM4D Database connection.
  2. In the Properties blade, enter the following information:
    1. Enter a name for the Datasource.
    2. Select a Site from the dropdown.
    3. Enter the database name.
    4. Set your authentication type.
  3. Click link-2 Check Connection.
    1. If successful, click Save.
    2. If connection failed, check that the information is entered correctly and try again.

Generate New DB

A new complete CM4D datasource can be generated for you when you add a new Managed Datasource.

When adding a Managed Datasource you have the option to generate a new database. By checking the box Generate new DB, a database object is created using the information entered in the Add Datasource blade when you click Save. Creating the database requires sufficient user privileges, whether it is the user logged in to Security Manager (Windows Authentication) or the user entered in the fields (SQL Authentication).

The new Datasource is added to the Site database automatically, but without any user access privileges/rights. Assign access to the new database to the appropriate Groups/Roles.

Assign Rights to Database via Groups in Site Manager (Desktop Application)

Assign Rights to Databases via Roles in ATS Security (Web Application)

For alternate methods of creating/maintaining CM4D databases, see the topic Database Utilities.

DataSource Settings

The Datasource blade contains the connection details and Results database settings for the Managed Datasource.

To open the properties blade, use the action menu more-vertical ( check-circle Open) or click directly on the grid row.

DataSource | Properties

The Properties tab contains the connection details for the CM4D database. Modify properties as needed, check the connection and save the changes.

link-2 Check Connection Once you have entered all required information, you can test the connection to the DataSource to verify that your information has been entered correctly.

If on save/check connection, the connection fails:

Check the information for accuracy/typos - server name, database name, user login (if SQL)

Check the authentication type is correct and is valid to access SQL Server

Database Name The label of the CM4D database, as defined in SQL Server.
DataSource Name A unique label to identify your CM4D datasource connection. This label is displayed in CM4D applications when selecting a datasource connection; it can be the same as the database name or something that would be more recognizable to users.
Generate new DB Enable this check box when adding a new Managed Datasource to the Site database. The user logged into the Configuration Manager must have sufficient privileges to run scripts in SQL Server.
Image Assign an image to the datasource.
Server name The name of the computer hosting the CM4D database. If using a named instance, include the instance name with the server name (servername\instancename).
Site Select a Site database from the dropdown. This is the Site that will manage the CM4D database. Typically, only one Site is used, but there may be more than one listed.
Windows Authentication Determines the connection security used by CM4D applications to connect to the CM4D database.
  • Windows Authentication - Enable checkbox.
  • SQL Authentication - Disable checkbox.
  SQL Authentication The following are only required if using SQL Authentication.
  SQL Username Enter the user name of the SQL Login. This user login is used by the CM4D desktop applications to access the database.
Password Enter the password for the SQL user.
Confirm Password Re-enter the SQL user password to confirm it is correct.

DataSource | Results Database

The Results Database tab contains settings related to how the Managed Datasource interacts with the Results Database, including excluding specific Routines and setting the Subgroups (default for the database or specific per Routine).

Configuration

This section allows you to enable the transfer of data from CM4D to the Results database and select which Routines, if any, are to be completely excluded from the results generation and data transfer. This is enabled by default.

See the topic Configure Results Exclusions for more information.

Subgroups

Each Routine or Subroutine is assigned a Subgroup Size that is used when calculating statistics. The Results database is precalculated data, so settings like Subgrouping are applied at the time the Sample enters the Results database.

If you need to modify the Subgroup settings, all Sample data that is already in the Results database is not effected by any change until the relevant Sample data is removed from the database and regenerated using the new configuration.

The subgroup settings can be applied at two levels:

See also:

Configure Subgroup Exceptions

Subgroups in the Results Database

Select one of the following settings according to the requirements of the data:

If you have ten samples with three different creation dates (Build One, Build Two, Build Three and Build Four were created on 14-05-2016, then Build Five, Build Six, Build Seven, Build Eight and Build Nine are created on 28-05-2016, and Build Ten is created on 28-06-2016) and the Maximum Subgroup Size is set to four, then the data will be grouped into multiple subgroups of up to four, because of the specific order of the samples loaded.

The minimum number of subgroups for calculating Cpk is three, and the minimum number of values needed to calculate Cpk is ten.

Subgroup Rules

Subgroups as related to statistical calculations; how subgroups are handled for calculating statistics. The subgroup settings and exceptions are applied when the results data is generated and the calculations are done. This means data subgroups are fixed and may give different calculations than CM4D Classic. Applications like Peruse rely on pre-calculated data, whereas in CM4D Classic/Interactive the calculations are done on the fly. Therefore, it is important to understand which rule set you want to have configured for the data going into your Results database, as this effects your final calculated values.

There are two options for determining how the statistics rules are calculated (although some rules share the same methods):

To see a comparison, click on the Rule name below:

See also:

Configure Subgroup Exceptions

Subgroups

DataSet Properties - Statistics Tab

Statistics Rules

Can we improve this topic?