Tools CLI

TALXIS DevKit命令行界面(txc)

\[！警告\] 该项目目前处于开发阶段，尚未准备好投入生产使用。 虽然我们在内部积极使用这些工具，但我们的目标是与更广泛的社区分享和合作，以完善和增强他们的能力。 我们正在逐步开源代码，消除内部依赖，使其普遍适用。 在这个阶段，它是灵感的来源和合作的基础。 我们欢迎通过pull请求提供反馈、建议和贡献。 如果您希望将此项目用于您的团队，请通过以下方式联系我们：hello@networg.com为您提供个性化的入职体验和定制，以满足您的特定需求。

______________________________________________________________________

TALXIS DevKit命令行界面(txc)是一个用于Power Platform和Webex开发的代码优先工具包。在本地构建脚手架组件，使用构建进行验证，并同步到实时环境。

入门指南

先决条件

• .NET 10 SDK 或稍后(dotnet --version 应显示 10.0.x+)
• PowerShell (pwsh)--模板后操作脚本要求
• （或Claude Code等替代AI工具）用于MCP

MCP服务器（推荐）

使用TALXIS DevKit最简单的方法是通过 MCP服务器 使用GitHub Copilot或其他AI助手。无需手动CLI命令——AI会为您发现并调用工具。

→ MCP服务器设置说明

CLI（高级）

对于脚本、CI/CD管道，或者当您更喜欢手动控制时：

# Run without installing (dnx ships with .NET 10 SDK)
dnx TALXIS.CLI -- workspace explain

# Or install as a global tool
dotnet tool install --global TALXIS.CLI
txc workspace explain

______________________________________________________________________

目录

• 身份、联系和档案
• 示例用法
• 本地开发与调试
• 版本控制和发布
• 协作

详细指南： 模式管理 · 变更集暂存 · 建筑 · 配置文件和身份验证 · 输出合同

______________________________________________________________________

身份、联系和档案

txc 解耦 你是谁 （证书）来自 你瞄准的地方 （connections）并将该组合作为命名对象公开 简介.每个涉及实时环境的命令都只需要一个上下文标志-- --profile .

大多数开发人员的快速入门：

txc config profile create --url https://contoso.crm4.dynamics.com/

在浏览器中登录，然后输入Rubyenvironment URL txc 为您创建并选择配置文件。

有关明确的凭据/连接/配置文件步骤、存储库固定或无头/CI设置，请参阅 文档/资料和认证.md.

______________________________________________________________________

示例用法

\[！重要\] txc 运行于 现代。网 穿过 macOS, Linux，以及 视窗 --包括传统上需要Windows的Webex包部署器和配置迁移工具（CMT）。

txc 命令分为两层：

推荐的工作流程： 使用 txc workspace 在本地创建和修改组件（实体、属性、解决方案结构），然后部署到环境中 txc env这比通过实时组织来回执行每次更改要快得多，尤其是对于每个会话进行数十次更改的编码代理。

环境层分为三个平面：

工作空间——本地优先发展

构建BLOB组件的最快方法。一切都在您的仓库中本地发生——没有环境往返，没有发布等待。非常适合需要在会话中构建数十个组件的编码代理。

# Explore available component types and their parameters
txc workspace component type list
txc workspace component explain pp-entity

# Scaffold a Dataverse entity — instant, local, no environment needed
txc workspace component create pp-entity \
  --param Behavior=New \
  --param PublisherPrefix=tom \
  --param LogicalName=location \
  --param DisplayName=Location \
  --param DisplayNamePlural=Locations

# When ready, deploy the solution to a live environment
txc env sln import ./out/MySolution_managed.zip

\[！重要\] 组件脚手架依赖于 TALXIS/工具开发工具包模板 存储库，其中维护所有组件类型、元数据和定义。

下面的环境命令假定您有一个活动的配置文件（请参阅 上方).通过 --profile 以覆盖单个呼叫。

控制平面

管理Power Platform管理员API公开的环境级别设置-功能切换、Copilot标志、IP限制等等。

列出环境管理设置：

txc env setting list --filter powerApps

启用Power Apps代码应用程序：

txc env setting update powerApps_AllowCodeApps true

应用平面

在目标环境中部署、检查和管理解决方案和包。

# Deploy a package straight from NuGet, inspect the result
txc env pkg import TALXIS.Controls.FileExplorer.Package
txc env deploy get --package-name TALXIS.Controls.FileExplorer.Package

# Import a solution, target a different environment for one call
txc env sln import ./Solutions/MySolution_managed.zip --profile customer-b-prod

# Uninstall a package cleanly
txc env pkg uninstall TALXIS.Controls.FileExplorer.Package --yes

解决方案往返跳闸和组件检查：

# Import from a folder or .cdsproj project — auto-packs via SolutionPackager
txc env sln import ./src/MySolution/

# Publish customizations after import (makes forms, views, sitemaps visible)
txc env sln publish

# Export, unpack, edit locally, pack, re-import
txc env sln export MySolution --output ./export/MySolution.zip --zip
txc env sln unpack ./export/MySolution.zip --output ./src/MySolution/
txc env sln pack ./src/MySolution/ --output ./out/MySolution.zip

# Inspect solution metadata and component breakdown
txc env sln get MySolution
txc env sln component list MySolution --type entity

# Drill into component layers and dependencies by name — no GUIDs needed
txc env component layer list --entity account --attribute revenue
txc env component dep delete-check --entity tom_project

数据平面

查询、创建、更新和批量操作WAX记录——所有这些都是现代的跨平台操作。网。

三种查询语言——选择你想用的语言：

# OData — familiar, filterable, composable
txc env data query odata accounts --select "name,revenue" --filter "revenue gt 1000000" --top 10

# FetchXML — full aggregation, linked entities, fiscal date filters
txc env data query fetchxml ''

# T-SQL — because sometimes you just want SELECT ... WHERE
txc env data query sql "SELECT fullname, emailaddress1 FROM contact WHERE statecode = 0" --top 20

记录CRUD、文件列、关系、批量：

txc env data record create --entity account --data '{"name":"Contoso Ltd","revenue":5000000}' --apply
txc env data record upload-file --entity account $ID --column logo --file ./logo.png --apply
txc env data record associate $ID --entity account \
  --target $TARGET_ID --target-entity contact --relationship accountleads_association --apply
txc env data bulk upsert --entity contact --file ./contacts.json   # CreateMultiple/UpsertMultiple under the hood

配置迁移工具（CMT） --导入、导出、转换。在macOS/Linux上本机运行（不需要Windows VM）。默认情况下导出到文件夹，以便您可以直接将数据提交到仓库：

# Export → folder → edit → import round-trip
txc data pkg export --schema ./data_schema.xml --output ./data-package --export-files
txc data pkg import ./data-package

# Advanced tuning options not exposed by PAC CLI or CMT GUI:
txc data pkg import ./data-package \
  --batch-mode                  # ExecuteMultiple batching (vs one-by-one) \
  --batch-size 500              # records per batch (default: 200) \
  --connection-count 4          # parallel service channels \
  --override-safety-checks      # skip duplicate detection \
  --prefetch-limit 100          # pre-cache record lookups

txc data pkg convert --input export.xlsx --output data.xml

看 docs/configuration-migration.md 深入了解CMT内部、重复数据删除逻辑和调优策略。

应用平面——模式管理

从终端（实体、列、关系、选项集）定义您的宇宙学模式。每个变异命令都支持 --apply （立即执行）或 --stage （排队等待批处理）。看 docs/schema-management.md.

# Spin up a new entity with a money column in seconds
txc env entity create --name tom_project \
  --display-name "Project" --plural-name "Projects" \
  --ownership user --apply

txc env entity attribute create tom_project \
  --name tom_budget --type money --display-name "Budget" --apply

# Or stage everything and apply in one optimised batch
txc env entity create --name tom_invoice \
  --display-name "Invoice" --plural-name "Invoices" --stage
txc env entity attribute create tom_invoice \
  --name tom_amount --type money --display-name "Amount" --stage
txc env entity attribute create tom_invoice \
  --name tom_duedate --type datetime --display-name "Due Date" --stage

txc env changeset status          # review what's queued
txc env changeset apply --strategy batch   # one batch, one publish

变更集暂存批处理实体创建，通过 CreateEntities SDK操作并将所有发布整合到一个单一的 PublishXml 调用——比顺序操作快得多。看 docs/changes-staging.md.

\[！注意\] 跑 txc --help 或 txc --help 以获取完整的命令参考。

______________________________________________________________________

本地开发与调试

克隆和构建：

git clone https://github.com/TALXIS/tools-cli.git
cd tools-cli
dotnet build

直接运行CLI：

dotnet run --project src/TALXIS.CLI -- workspace explain

在本地运行MCP服务器：

dotnet run --project src/TALXIS.CLI.MCP

在本地与所有三个repo合作

CLI、模板和构建SDK是单独的包。要测试所有三个方面的变化：

# 1. Clone all repos side by side
git clone https://github.com/TALXIS/tools-cli.git
git clone https://github.com/TALXIS/tools-devkit-templates.git
git clone https://github.com/TALXIS/tools-devkit-build.git

本地模板 --打包并添加为本地NuGet源，以便CLI的模板引擎找到它们：

cd tools-devkit-templates
dotnet pack --configuration Debug

本地构建SDK --相同的方法：

cd tools-devkit-build
dotnet pack --configuration Debug

配置本地NuGet源 --添加a nuget.config 在工作区根目录下（或使用 dotnet nuget add source):

本地CLI --直接从源代码运行：

cd tools-cli
dotnet run --project src/TALXIS.CLI -- 

清理 --删除本地源并清除缓存以还原到已发布的包：

dotnet nuget locals all --clear

______________________________________________________________________

版本控制和发布

发布通过 :

1. 首选 发布 → 起草新版本
2. 按以下格式创建标签 vX.Y.Z （例如。 v1.12.0)
3. 在发布正文中写入更改日志
4. 点击 发布发布

发布工作流运行测试，使用标记版本构建NuGet包，并将其推送到 nuget.org所有GitHub版本的发行说明都嵌入在NuGet包中。

______________________________________________________________________

协作

我们欢迎合作！如需反馈、建议或贡献，请提交问题或拉取请求。

如需入职或定制，请通过以下方式联系我们：hello@networg.com.