5️⃣
Cinchy Platform Documentation
Cinchy v5.8
Cinchy v5.8
  • Data Collaboration Overview
  • Release notes
    • Release notes
      • 5.9 release notes
      • 5.8 Release Notes
      • 5.7 Release Notes
      • 5.6 Release Notes
      • 5.5 Release Notes
      • 5.4 Release Notes
      • 5.3 Release Notes
      • 5.2 Release Notes
      • 5.1 Release Notes
      • 5.0 Release Notes
  • Support
  • Glossary
  • FAQ
  • Deployment guide
    • Deploying Cinchy
      • Plan your deployment
        • Deployment architecture
          • Kubernetes architecture
          • IIS architecture
        • Deployment prerequisites
          • Single Sign-On (SSO) integration
            • Enable TLS 1.2
            • Configure ADFS
            • AD Group Integration
      • Kubernetes
        • Disable your Kubernetes applications
        • Change your file storage configuration
        • Configure AWS IAM for Connections
        • Use Self-Signed SSL Certs (Kubernetes)
        • Deploy the CLI (Kubernetes)
      • IIS
  • Upgrade guide
    • Upgrade Cinchy
      • Cinchy Upgrade Utility
      • Kubernetes upgrades
        • v5.1 (Kubernetes)
        • v5.2 (Kubernetes)
        • v5.3 (Kubernetes)
        • v5.4 (Kubernetes)
        • v5.5 (Kubernetes)
        • v5.6 (Kubernetes)
        • v5.7 (Kubernetes)
        • v5.8 (Kubernetes)
        • Upgrade AWS EKS Kubernetes version
        • Update the Kubernetes Image Registry
        • Upgrade Azure Kubernetes Service (AKS)
      • IIS upgrades
        • v4.21 (IIS)
        • v4.x to v5.x (IIS)
        • v5.1 (IIS)
        • v5.2 (IIS)
        • v5.3 (IIS)
        • v5.4 (IIS)
        • v5.5 (IIS)
        • v5.6 (IIS)
        • v5.7 (IIS)
        • v5.8 (IIS)
      • Upgrading from v4 to v5
  • Guides for using Cinchy
    • User Guide
      • Data Browser overview
      • The Admin panel
      • User preferences
        • Personal access tokens
      • Table features
      • Data management
      • Queries
      • Version management
        • Versioning best practices
      • Commentary
    • Builder Guide
      • Best practices
      • Create tables
        • Attach files
        • Columns
        • Data controls
          • Data entitlements
          • Data erasure
          • Data compression
        • Formatting rules
        • Indexing & partitioning
        • Linking data
        • Table and column GUIDs
        • System tables
      • Delete tables
        • Restore tables, columns, and rows
      • Saved queries
      • CinchyDXD
        • Overview
        • DXD workflow
        • Package the data experience
        • Install the data experience
        • Release package
        • Changelog
        • References
          • Cinchy DXD CLI reference
          • Data Experience Definitions table
          • Data Experience Reference table
      • Multilingual support
      • Integration guides
    • Administrator Guide
    • Additional guides
      • Monitor and Log on Kubernetes
        • Grafana
        • OpenSearch dashboards
          • Set up Alerts
        • Monitor via ArgoCD
      • Maintenance
      • Cinchy Secrets Manager
      • GraphQL (Beta)
      • System properties
      • Enable Data At Rest Encryption (DARE)
      • Application experiences
        • Network map
          • Custom node results
          • Custom results in the Network Map
        • Set up experiences
  • API Guide
    • API overview
      • API authentication
      • API saved queries
      • ExecuteCQL
      • Webhook ingestion
  • CQL
    • Overview
      • CQL examples
      • CQL statements overview
        • Cinchy DML statements
        • Cinchy DDL statements
      • Cinchy supported functions
        • Cinchy functions
        • Cinchy system values
        • Cinchy User Defined Functions (UDFs)
          • Table-valued functions
          • Scalar-valued functions
        • Conversion functions
        • Date and Time types and functions
          • Return System Date and Time values
          • Return Date and Time parts
          • Return Date and Time values from their parts
          • Return Date and Time difference values
          • Modify Date and Time values
          • Validate Date and Time values
        • Logical functions
        • Math functions
        • String functions
        • Geometry and Geography data type and functions
          • OGC methods on Geometry & Geography instances
          • Extended methods on Geometry & Geography instances
        • Full Text Search functions
        • Connections functions
        • JSON functions
    • CQL functions reference list
  • Meta-Forms
    • Introduction
    • Install Meta-Forms
      • Deploy Meta-Forms (Kubernetes)
      • Deploy Meta-Forms (IIS)
    • Forms data types
    • Meta-Forms Builder Guide
      • Create a dynamic meta-form with tables
      • Create a dynamic meta-form example with Form Designer
      • Add links to a form
      • Rich text editing in forms
  • Data syncs
    • Get started with data syncs
    • IIS installation
      • Install Connections
      • Install the Worker/Listener
      • Install the Connections CLI
    • Build data syncs
      • Data sync types
      • Design patterns
      • Sync actions
      • Columns and mappings
        • Calculated column examples
      • Advanced settings
        • Filters
        • Variables
        • Auth requests
        • Request headers
        • Post sync scripts
        • Pagination
      • Batch data sync example
      • Real-time sync example
      • Schedule a data sync
      • Connection functions
    • Data sync sources
      • Cinchy Event Broker/CDC
        • Cinchy Event Broker/CDC XML config example
      • Cinchy Table
        • Cinchy Table XML config example
      • Cinchy Query
        • Cinchy Query XML config example
      • Copper
      • DB2 (query and table)
      • Dynamics 2015
      • Dynamics
      • DynamoDB
      • File-based sources
        • Binary file
        • Delimited file
        • Excel
        • Fixed width file
        • Parquet
      • Kafka Topic
        • Kafka Topic example config
        • Apache AVRO data format
      • LDAP
      • MongoDB collection
        • MongoDB collection source example
      • Mongo event
      • MongoDB collection (Cinchy event)
      • MS SQL Server (query and table)
      • ODBC Query
      • Oracle (query and table)
      • Polling event
        • Polling event example config
      • REST API
      • REST API (Cinchy event)
      • SAP SuccessFactors
      • Salesforce Object (Bulk API)
      • Salesforce platform event
      • Salesforce push topic
      • Snowflake
        • Snowflake source example config
      • SOAP 1.2 web service
      • SOAP 1.2 web service (Cinchy Event Triggered)
    • Data sync destinations
      • Cinchy Table
      • DB2 table
      • Dynamics
      • Kafka Topic
      • MongoDB collection
      • MS SQL Server table
      • Oracle table
      • REST API
      • Salesforce
      • Snowflake table
      • SOAP 1.2 web service
    • Real-time sync stream sources
      • The Listener Config table
      • Cinchy Event Broker/CDC
      • Data Polling
      • Kafka Topic
      • MongoDB
      • Salesforce Push Topic
      • Salesforce Platform Event
    • CLI commands list
    • Troubleshooting
  • Other Resources
    • Angular SDK
    • JavaScript SQK
Powered by GitBook
On this page
  • CinchyDXD 2.0 DXD functions
  • Common arguments
  • Export
  • Install
  • CinchyDXD 1.7 commands
  • Actions
  • Common arguments
  • Export arguments
  • Install arguments
  • Keygen arguments
  • CinchyDXD 1.6 commands
  • Actions
  • Common arguments
  • Export arguments
  • Install arguments
  • Keygen arguments
  • CinchyDXD 1.5 commands
  • Actions
  • Common arguments
  • Export
  • Install
  • CinchyDXD 1.4 commands
  • Actions
  • Common arguments
  • Common
  • Export
  • Install
  1. Guides for using Cinchy
  2. Builder Guide
  3. CinchyDXD
  4. References

Cinchy DXD CLI reference

This section lists all available commands and their arguments for CinchyDXD.

CinchyDXD 2.0 DXD functions

Action
Description

export

Exports a Data Experience from a Cinchy source environment.

install

Installs a Data Experience in a Cinchy target environment.

keygen

Generates an encryption key file.

help

Displays this help text. To display help for an action, pass only that action.

version

Displays version information.

Common arguments

Option
Description
Requirement

-s

Full path to the Cinchy server without the protocol.

Required

-u

User ID for accessing Cinchy.

Required

-p

Clear text or encrypted password for the specified user.

Required

-t

Path to directory for storing temporary DXD files.

Required

Export

Command: .\CinchyDXD.ps1 export

Option
Description
Requirement

-g

The Data Experience Definition GUID.

Required

-o

Path to directory for Data Experience release export.

Required

-k

Path to the encryption key file for metadata encryption.

Optional

-c

Flag to keep the temp (work) directory when complete.

Optional

-start

The Export Step to start from.

Optional

-end

The Export Step to end on.

Optional

Install

Command: .\CinchyDXD.ps1 install

Option
Description
Requirement

-x

Path to directory containing the DX to be installed.

Required

-v

Data Experience Definition Version.

Required

-d

Path to directory for storing temporary Connection files.

Optional

-e

Prompt to continue on Connection and Model Loader errors.

Optional

-m

Do not stop on Model Loader errors.

Optional

-z

Display Connections output on completion.

Optional

-k

Path to the encryption key file for metadata decryption.

Optional

-skip

List of Tables and/or Table.Column(s) to skip during sync.

Optional

-c

Flag to keep the temp (work) directory when complete.

Optional

-start

The Install Step to start from.

Optional

-end

The Install Step to end on.

Optional

-y

Force install if release already exists in the target.

Optional

CinchyDXD 1.7 commands

Actions

Action
Description

export

Exports a Data Experience from a Cinchy source environment.

install

Installs a Data Experience in a Cinchy target environment.

keygen

Generates an encryption key file.

help

Displays this help text. To display help for an action, pass only that action.

version

Displays version information.

Common arguments

Parameter
Description
Requirement

-s (Cinchy Server)

Full path to the Cinchy server without the protocol.

Required

Export arguments

Parameter
Description
Requirement

-u (Username)

User ID for accessing Cinchy. Required when not using a Personal Access Token.

Optional

-p (Password)

Clear text password or Personal Access Token. If using a token, do not provide -u.

Required

-g (DXD Guid)

The Data Experience Definition Guid.

Required

-v (DXD Version)

The Data Experience Definition Version.

Required

-o (DXD Output Directory)

Path where CinchyDXD will create the Data Experience release export.

Required

-k (Encryption Key File)

Path to the encryption key file for encrypting metadata.

Optional

-w (Write Binary Files to Cinchy)

Flag to save release files into Cinchy.

Optional

-x (CinchyDXD Temp Directory)

Flag to prevent cleanup of the output temp directory.

Optional

-start (Start Step)

Export Step to start from.

Optional

-end (End Step)

Export Step to end on.

Optional

Install arguments

Parameter
Description
Requirement

-u (Username)

User ID for accessing Cinchy.

Required

-p (Password)

Clear text password of the specified user.

Required

-d (Connections Temp Directory)

Path for storing temporary files to support sync.

Optional

-e (Pause On Errors)

Prompt to continue on Connection and Model Loader errors.

Optional

-m (Ignore Model Errors)

Do not stop on ModelLoader errors.

Optional

-z (Display Sync Output)

Displays the Connections output on completion.

Optional

-k (Encryption Key File)

Path to the encryption key file for decrypting metadata.

Optional

-skip (Skip Sync)

Comma delimited list of Tables and/or Table.Column(s) to skip.

Optional

-start (Start Step)

Install Step to start from.

Optional

-end (End Step)

Install Step to end on.

Optional

-y (Force Install)

Force install if release already exists in target.

Optional

Keygen arguments

Parameter
Description
Requirement

-o (DXD Output Directory)

Path where the encryption key file will be created. Used for encrypting and decrypting metadata during DXD Export and Import.

Required

CinchyDXD 1.6 commands

Actions

Action
Description

export

Exports a Data Experience from a Cinchy source environment.

install

Installs a Data Experience in a Cinchy target environment.

keygen

Generates an encryption key file.

help

Displays this help text. To display help for an action, pass only that action.

version

Displays version information.

Common arguments

Parameter
Description
Requirement

-s (Cinchy Server)

Full path to the Cinchy server without the protocol.

Required

Export arguments

Parameter
Description
Requirement

-u (Username)

User ID for accessing Cinchy. Required when not using a Personal Access Token.

Optional

-p (Password)

Clear text password or Personal Access Token. If using a token, do not provide -u.

Required

-g (DXD Guid)

The Data Experience Definition Guid.

Required

-v (DXD Version)

The Data Experience Definition Version.

Required

-o (DXD Output Directory)

Path where CinchyDXD will create the Data Experience release export.

Required

-k (Encryption Key File)

Path to the encryption key file for encrypting metadata.

Optional

-w (Write Binary Files to Cinchy)

Flag to save release files into Cinchy.

Optional

-x (CinchyDXD Temp Directory)

Flag to prevent cleanup of the output temp directory.

Optional

-start (Start Step)

Export Step to start from.

Optional

-end (End Step)

Export Step to end on.

Optional

Install arguments

Parameter
Description
Requirement

-u (Username)

User ID for accessing Cinchy.

Required

-p (Password)

Clear text password of the specified user.

Required

-d (Connections Temp Directory)

Path for storing temporary files to support sync.

Optional

-e (Pause On Errors)

Prompt to continue on Connection and Model Loader errors.

Optional

-m (Ignore Model Errors)

Do not stop on ModelLoader errors.

Optional

-z (Display Sync Output)

Displays the Connections output on completion.

Optional

-k (Encryption Key File)

Path to the encryption key file for decrypting metadata.

Optional

-ps (Post Install Scripts)

Path to directory with CQL scripts to execute post-install.

Optional

-pr (Pre Install Scripts)

Path to directory with CQL scripts to execute pre-install.

Optional

-skip (Skip Sync)

Comma delimited list of Tables and/or Table.Column(s) to skip.

Optional

-start (Start Step)

Install Step to start from.

Optional

-end (End Step)

Install Step to end on.

Optional

-y (Force Install)

Force install if release already exists in target.

Optional

Keygen arguments

Parameter
Description
Requirement

-o (DXD Output Directory)

Path where the encryption key file will be created. Used for encrypting and decrypting metadata during DXD Export and Import.

Required

CinchyDXD 1.5 commands

Actions

Action
Description

export

Exports a Data Experience from a Cinchy source environment.

install

Installs a Data Experience in a Cinchy target environment.

help

Displays this help text. To display help for an action, pass only that action.

version

Displays version information.

Common arguments

Parameter
Description
Requirement

-s (Cinchy Server)

Full path to the Cinchy server without the protocol.

Required

-u (Username)

User ID for accessing Cinchy.

Required

-p (Password)

Clear text or encrypted password of the specified user.

Required

Export

Parameter
Description
Requirement

-g (DXD Guid)

The Data Experience Definition Guid.

Required

-v (DXD Version)

The Data Experience Definition Version.

Required

-o (DXD Output Directory)

Path where CinchyDXD will create the Data Experience release export.

Required

-w (Write Binary Files to Cinchy)

Flag to save release files into Cinchy.

Optional

-x (CinchyDXD Temp Directory)

Flag to prevent cleanup of the output temp directory.

Optional

-start (Start Step)

Export Step to start from.

Optional

-end (End Step)

Export Step to end on.

Optional

Install

Parameter
Description
Requirement

-d (Connections Temp Directory)

Path for storing temporary files to support sync.

Optional

-e (Pause On Errors)

Prompt to continue on Connection and Model Loader errors.

Optional

-m (Ignore Model Errors)

Do not stop on ModelLoader errors.

Optional

-z (Display Sync Output)

Displays the Connections output on completion.

Optional

-ps (Post Install Scripts)

Path to directory with CQL scripts to execute post-install.

Optional

-start (Start Step)

Install Step to start from.

Optional

-end (End Step)

Install Step to end on.

Optional

-y (Force Install)

Force install if release already exists in target.

Optional

CinchyDXD 1.4 commands

Actions

Action
Description

export

Exports a Data Experience from a Cinchy source environment.

install

Installs a Data Experience in a Cinchy target environment.

encrypt

Generate an encrypted string.

help

Displays this help text. To display help for an action, pass only that action.

version

Displays version information.

Common arguments

Common

Parameter
Description
Requirement

export

Exports a Data Experience from a Cinchy source environment.

Required

-h (https)

Flag for https connections to Cinchy.

Optional

-s (Cinchy Server)

Full path to the Cinchy server without the protocol.

Required

-sso (CinchySSO Server)

Full path to the CinchySSO server without the protocol.

Optional

-u (Username)

User ID for accessing Cinchy.

Required

-p (Password)

Clear text or encrypted password of the specified user.

Required

-c (CinchyCLI Directory)

Path to the Cinchy CLI.

Required

-d (CinchyCLI Temp Directory)

Path for storing temporary files.

Required

-e (CinchyCLI EXE)

Flag to use Cinchy.CLI.exe. Cinchy.CLI.dll is the default.

Optional

-g (DXD Guid)

Data Experience Definition Guid.

Required

-v (DXD Version)

Data Experience Definition Version.

Required

-o (DXD Output Directory)

Path where CinchyDXD will create the Data Experience release export.

Required

-w (Write Binary Files to Cinchy)

Flag to save release files into Cinchy.

Optional

-x (CinchyDXD Temp Directory)

Flag to prevent cleanup of the output temp directory.

Optional

-start (Start Step)

Export Step to start from.

Optional

-end (End Step)

Export Step to end on.

Optional

Export

Parameter
Description
Requirement

-g (DXD Guid)

The Data Experience Definition Guid.

Required

-v (DXD Version)

The Data Experience Definition Version.

Required

-o (DXD Output Directory)

Path where CinchyDXD will create the Data Experience release export.

Required

-w (Write Binary Files to Cinchy)

Flag to save release files into Cinchy.

Optional

-x (CinchyDXD Temp Directory)

Flag to prevent cleanup of the output temp directory.

Optional

-start (Start Step)

Export Step to start from.

Optional

-end (End Step)

Export Step to end on.

Optional

Install

Parameter
Description
Requirement

-ps (Post Install Scripts)

Path to directory with CQL scripts to execute post-install.

Optional

-start (Start Step)

Install Step to start from.

Optional

-end (End Step)

Install Step to end on.

Optional

-y (Force Install)

Force install if release already exists in target.

Optional

-z (Log syncdata)

Write CLI syncdata commands to the log.

Optional

PreviousReferencesNextData Experience Definitions table

Last updated 1 year ago