CygNet DDS Transaction Viewer Utility

Devices > Device Utilities > DDS Transaction Viewer Utility

CygNet DDS Transaction Viewer Utility

The DDS Transaction Viewer utility (DdsViewer.exe) provides useful DDS device and transaction information.

The DDS Viewer utility is stored in the CygNet\Utilities directory (DdsViewer.exe) on the host server. To start the utility, use Windows Explorer to browse to the directory and double-click the program icon.

Note: You can also set up this utility to be installed and launched (started) via CygNet Client Installer so that the application can be version managed. See Version Management for instructions on how to do this.

For more information, see the subsections below:

CygNet DDS Viewer Properties
Export Transactions Option
Export Transaction Properties
Import or Export Devices and Transactions
View DEID Values Option
View DEID Values Properties

Click the following image to see an example DDS Transaction Viewer dialog box:

CygNet DDS Viewer Properties

The following table lists and describes the various properties of the CygNet DDS Viewer utility.

Property	Description
DDS Service	This drop-down menu enables you to select a DDS from the current domain.
Device Category	The category of the device to be selected. Valid device category options are: Comm Devices Remote Devices Import/Export Devices Template Devices
Devices	This field contains columns for all devices in the DDS from the selected device category.
Cat	Displays the category of the selected device type.
Device Identifier	Displays the name of the device as configured in the DDS.
Device Type	Displays the type of device as configured in the DDS.
Device Description	Displays the device description as configured in the DDS.
Device Revision	Software revision number of a remote device.
Key	The database key of the selected device.
Data Groups for	This field contains columns for all related data group information for a selected device.
Type	The name of the data group type as it appears in the selected device.
Ord	The ordinal of the data group.
Description	The data group description.
Key	The database key that holds the data in the record.
Transaction list for	This field lists basic transaction history for the selected data group. More complete history populates in the field at the bottom of the DDS Transaction Viewer dialog on a per-transaction basis.
Transaction Data	This field displays all transaction data for a selected device or displays the XML of a selected device template file. Select remote device transaction data on a per-data group basis.
Options	The following are options available under the Options drop-down: Dump Indexes: Enables you to dump all indexes for a selected DDS to a viewable list of keywords and other relevant information. Export Data Group Info: Enables you to export the following information from the selected DDS to a CSV file: DeviceId, DeviceType, DGType, DGOrd, MaxCount, and NumTxs. Export Transactions: Enables you to export all transactions for a selected time period for a selected remote device, communication device, import/export device, or data group. For more information, see Export Transactions Option and Import or Export Devices and Transactions. Import Transactions: Enables you to import transactions in a CSV from a designated location. For more information, see Import or Export Devices and Transactions. Parse XML: Enables you to parse EIE code into XML on a device-EIE or data group basis. View DEID Values: Enables you to view individual data group element transaction history. For more information, see View DEID Values Option. View Dev/Dg Specific Info: Enables the display of device EIE- and data group-specific information, like metadata. View Statistics for this DDS: Provides an information-rich report for the selected DDS. View Statistics for all DDSs: Provides a report for all DDSs on a selected domain. Stats include device totals and data group transactions totals.
Transaction Results	Displays transaction data and transaction export results.

Export Transactions Option

You can use the Export Transactions option to export all transactions for a selected time period for a selected remote device, communication device, import/export device, or data group.

Sample Export Transaction Dialog Box

Export Transaction Properties

The following table lists and describes the various properties of the Export Transaction option dialog box.

Property	Description
Transaction Headers	Select this option to view transaction headers information.
Transaction Data	Select this option to view transaction data information.
Set to Defaults	Use this button to select transaction headers for all devices and data groups by using wildcards (*). You cannot use this button to select transaction data.
Set to Selected	Use this button to select the transaction data or headers request to whichever item is highlighted in the Devices and Data Groups for fields.
Start Time	Use the selectors to choose the correct start time for your report.
End Time	Use the selectors to choose the correct end time for your report. Now sets the end time to the current time.
Export Only Successful Transactions	Select to export only successful transactions for the designated time span.
Export Only Most Recent Transaction per Data Group and Ordinal	Select to export only the latest transaction per data group and ordinal for the designated time span.
Export Transaction Data With References	Select to export transaction data with reference information for the specified transaction key.
Export Folder	Designate the destination of your export file. The default is CygNet \Utilities\DdsViewerResults\ExportTx.
Device Type Specifier	Use this field to indicate the device type.
Device ID Specifier	Use this field to identify device ID.
Data Group Type Specifier	Use this field to identify data group type.

Import or Export Devices and Transactions

You can transfer ownership of a site or transfer devices with transactions from one Site.Service to another by using the Export Transactions option.

To Export and Import Transactions from One Device to a Different Device

In the DDS Transaction Viewer, select the DDS, device category, device, and data group from which you want to export transactions.
Select Options > Export Transactions.
In the Export Transaction Headers dialog box, select Transaction Headers and choose Start Time, End Time, Export Folder, and any other desired parameters to fine tune the export (depending on whether Set to Defaults or Set to Selected is chosen).
Click Export. Results will display in the Transaction Export Results field in the DDS Transaction Viewer.
Browse to the designated Export Folder, open the exported .csv file header, and change the "DeviceId" from the source device to the destination device.

Note: Two transactions cannot have the same timestamp.

To export transaction data from the same data group(s), in the DDS Transaction Viewer, select Options > Export Transactions.
In the Export Transaction Headers dialog box, select Transaction Data and choose Start Time, and End Time to include the existing transactions.
Specify the same Export Folder where the transaction headers were exported, and if necessary, enter remaining parameters to match what was used for the transaction header export.
Click Export. There should be one .xml file for each transaction and one .csv file for all the headers.
In each transaction data file, change the "facility" and "device" attributes to match the destination facility and device associated with each data group. The "device" is the Device ID and the "facility" is the Facility ID associated with the data group.
Ensure that the selected data groups are instantiated in the destination device and that the ordinals match the data group ordinals of the original device.
In the DDS Transaction Viewer select Options > Import Transactions, browse to or type in the directory where you have the modified transactions and headers, click Import, and click Yes to the confirmation dialog. Results will display in the Transaction Import Results field in the DDS Transaction Viewer.

To Export and Import Transactions from the Same Device

Note: If you are moving DDS devices to another Site.Service in preparation to transfer ownership of a CygNet server or site, anything within that site that is not specifically in the license agreement for the other party may not function or may function erratically, or may produce invalid/incorrect results. The new owner must obtain a new host activation when acquiring ownership of the Site.Services. To avoid multiple host activations, it is most efficient to place the Site.Services on a "Permanent" machine before activation because a new host activation is required when moving a site to a new machine.

Note: Many services are individually licensed within a license agreement, such as a number of HSS and VHS services. Check with your account manager before purchasing a site with services for which you may not be licensed.

In the DDS Transaction Viewer, select the appropriate DDS and click Options > Export Transactions.
In the Export Transaction Headers dialog box, select Transaction Headers and choose Start Time, End Time, Export Folder, and any other desired parameters (depending on whether Set to Defaults or Set to Selected is chosen), and click Export.
In the DDS Transaction Viewer, select the DDS and click Options > Export Transactions.
In the Export Transaction Headers dialog box, select Transaction Data and set parameters for Start Time, End Time, and Export Folder, ensuring the headers and data are exported to the same directory, and click Export.
In CygNet Explorer > DDS, export the device and then import it to the new DDS.
In the DDS Transaction Viewer, select the new DDS and click Options > Import Transactions.
Browse to or type in the directory where the headers and data to be imported are located and click Import. All the DDS devices with their appropriate metadata and transactions should now be in the new DDS.

View DEID Values Option

You can use the View DEID Values option to view individual data group element transaction history.

Sample Data Element ID Values Dialog Box

View Data Group Element Values Properties

The following table lists and describes the various properties of the Data Element ID Values dialog box.

Property	Description
Device ID	Indicates the device ID of the device that contains the data group elements you want information about.
Data Group	Indicates the data group that contains the data group elements you want information about.
Ordinal	Indicates the data group ordinal that contains the data group elements you want information about.
DEIDs (CSV)	Lists the data group elements you require information about. Separate with commas.
Last Successful Tx	Select this option if you want information about the last successful transaction for the data group elements requested.
Tx Time Range	If you are not selecting only the latest successful transactions to view, designate a time span that includes all transactions for the designated data group elements.
Print	Click Print to send your results to a printer.