dsh-d365-kit 0.0.0-stage → 0.34.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +318 -0
- package/CHANGELOG.zh-CN.md +317 -0
- package/INSTALL.md +94 -0
- package/INSTALL.zh-CN.md +93 -0
- package/LICENSE +21 -0
- package/README.md +335 -2
- package/README.zh-CN.md +336 -0
- package/client.js +1818 -0
- package/cordis.patch.yml +44 -0
- package/docs/en/architecture.md +172 -0
- package/docs/en/checks.md +184 -0
- package/docs/en/installation.md +151 -0
- package/docs/en/permissions.md +161 -0
- package/docs/en/scenarios.md +202 -0
- package/docs/en/tools.md +665 -0
- package/docs/en/troubleshooting.md +131 -0
- package/docs/zh/architecture.md +172 -0
- package/docs/zh/checks.md +184 -0
- package/docs/zh/installation.md +151 -0
- package/docs/zh/permissions.md +161 -0
- package/docs/zh/scenarios.md +202 -0
- package/docs/zh/tools.md +665 -0
- package/docs/zh/troubleshooting.md +131 -0
- package/examples/prompts.en.md +206 -0
- package/examples/prompts.zh-CN.md +206 -0
- package/examples/waivers.example.json +20 -0
- package/icon.svg +6 -0
- package/index.js +142 -0
- package/lib/auth.js +181 -0
- package/lib/client.js +496 -0
- package/lib/code-check.js +549 -0
- package/lib/config.js +323 -0
- package/lib/contract-history.js +49 -0
- package/lib/contract.js +583 -0
- package/lib/csharp-check.js +493 -0
- package/lib/data-migrate.js +1318 -0
- package/lib/data-policy.js +78 -0
- package/lib/error-codes.js +80 -0
- package/lib/errors.js +81 -0
- package/lib/gitlab.js +161 -0
- package/lib/health.js +205 -0
- package/lib/migrate.js +732 -0
- package/lib/preflight.js +116 -0
- package/lib/refs.js +191 -0
- package/lib/resources.js +320 -0
- package/lib/retention-defaults.js +17 -0
- package/lib/retention.js +384 -0
- package/lib/runtime.js +232 -0
- package/lib/settings-http.js +512 -0
- package/lib/settings-store.js +371 -0
- package/lib/skill.js +76 -0
- package/lib/snapshot.js +149 -0
- package/lib/tool-code-check.js +133 -0
- package/lib/tool-configure.js +169 -0
- package/lib/tool-contract.js +376 -0
- package/lib/tool-data-sync.js +559 -0
- package/lib/tool-data-write.js +203 -0
- package/lib/tool-data.js +282 -0
- package/lib/tool-diff.js +484 -0
- package/lib/tool-environments.js +106 -0
- package/lib/tool-flows.js +540 -0
- package/lib/tool-health.js +127 -0
- package/lib/tool-invoke.js +284 -0
- package/lib/tool-layers.js +497 -0
- package/lib/tool-metadata.js +417 -0
- package/lib/tool-migrate.js +102 -0
- package/lib/tool-refs.js +206 -0
- package/lib/tool-reports.js +299 -0
- package/lib/tool-sync.js +430 -0
- package/lib/tool-trace.js +420 -0
- package/lib/tool-write.js +563 -0
- package/lib/waivers.js +83 -0
- package/lib/write-actions.js +1374 -0
- package/lib/write-policy.js +199 -0
- package/lib/write-store.js +167 -0
- package/locale/en.json +68 -0
- package/locale/zh.json +68 -0
- package/package.json +59 -4
- package/skills/d365-troubleshooting/SKILL.md +115 -0
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
# 权限与写入
|
|
2
|
+
|
|
3
|
+
**[English](../en/permissions.md)** | 简体中文
|
|
4
|
+
|
|
5
|
+
## 默认姿态
|
|
6
|
+
|
|
7
|
+
装好之后是**只读**:
|
|
8
|
+
|
|
9
|
+
- 元数据(实体、字段、表单、视图、插件、解决方案、层、站点地图…)由 `metadata.read` 控制,**默认开启**——没在配置里显式列出的环境视为已授权;
|
|
10
|
+
- **业务记录**默认读不到,需要按环境授权 `data.read`;
|
|
11
|
+
- 任何修改都需要按环境授权对应能力,且每次执行要人确认。
|
|
12
|
+
|
|
13
|
+
「能看什么」和「能改什么」放在同一份按环境的能力表里,因为这两件事本来就该一起管。页面上每个环境单独一块,用分隔线隔开。
|
|
14
|
+
|
|
15
|
+
## 能力表
|
|
16
|
+
|
|
17
|
+
配置在 `d365.config.json`:
|
|
18
|
+
|
|
19
|
+
```json
|
|
20
|
+
{
|
|
21
|
+
"write": {
|
|
22
|
+
"capabilityVersion": 2,
|
|
23
|
+
"environments": {
|
|
24
|
+
"dev": ["metadata.read", "data.read", "optionValue.add", "attribute.add", "view.columns"],
|
|
25
|
+
"sit": ["metadata.read", "data.read"],
|
|
26
|
+
"uat": []
|
|
27
|
+
},
|
|
28
|
+
"solutionUniqueName": "ContosoBase"
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
- 环境**没有条目** = 还没配过,保持默认(只开 `metadata.read`);
|
|
34
|
+
- 环境条目是**空数组** = 全部关掉,连元数据也读不到;
|
|
35
|
+
- `capabilityVersion` 由设置页保存时写入。旧文件(没有这个字段)里已有环境条目会被自动补上 `metadata.read`,也就是维持升级前的「元数据随时可读」行为。
|
|
36
|
+
|
|
37
|
+
| 能力 | 真实 HTTP 操作 | 分组 | 作用 |
|
|
38
|
+
| --- | --- | --- | --- |
|
|
39
|
+
| `metadata.read` | 元数据 `GET` | 元数据 | 读表/字段/表单/视图/插件/解决方案层(默认开启) |
|
|
40
|
+
| `data.read` | 业务数据 `GET` | 数据 | 读取业务记录 |
|
|
41
|
+
| `data.write` | `POST` / `PATCH` | 数据 | 新建或修改业务记录(高危,不含删除) |
|
|
42
|
+
| `optionValue.add` | `InsertOptionValue` | 选项集 | 新增选项值(全局或字段本地) |
|
|
43
|
+
| `optionValue.updateLabel` | `UpdateOptionValue` | 选项集 | 改选项标签 |
|
|
44
|
+
| `optionValue.delete` | `DeleteOptionValue` | 选项集 | **永久删除**选项值(高危) |
|
|
45
|
+
| `attribute.add` | `POST EntityDefinitions(...)/Attributes` | 字段 | 新增字段 |
|
|
46
|
+
| `attribute.update` | `PUT` 字段 URL(`MSCRM.MergeLabels`) | 字段 | 改显示名、描述、必填级别 |
|
|
47
|
+
| `attribute.delete` | `DELETE` 字段 URL | 字段 | **永久删除**字段及其数据(高危) |
|
|
48
|
+
| `entity.update` | `PUT` 实体 URL(`MSCRM.MergeLabels`) | 表 | 改表显示名与描述 |
|
|
49
|
+
| `view.columns` | `PATCH savedqueries(id)` | 视图 | 在系统视图里增删列(只改 `layoutxml`) |
|
|
50
|
+
| `layer.remove` | `RemoveActiveCustomizations` | 组件层 | **永久移除**组件最上面的未受管自定义层(高危;支持表、字段、选项集、表单、视图、流程、Web 资源、插件、自定义 API) |
|
|
51
|
+
| `message.invoke` | 任意 `POST` action | 消息 | 调一条 Dataverse 消息。消息由目标环境的插件实现,可能写数据、发通知或调外部系统(高危,每次调用都在对话里确认) |
|
|
52
|
+
|
|
53
|
+
设置页「权限」里按环境勾选,支持「复制到其他环境」。
|
|
54
|
+
|
|
55
|
+
## 三道闸,一处判定
|
|
56
|
+
|
|
57
|
+
判定收在 `lib/client.js` 一处,新增工具绕不过去——所有请求(含设置页里的「测试连接」)都从这里发出:
|
|
58
|
+
|
|
59
|
+
- **元数据读**:URL 的实体集名在元数据白名单(`EntityDefinitions`、`systemforms`、`savedqueries`、`webresourceset`、`solutions`、`msdyn_componentlayers`…)里,要求 `metadata.read`,报 `metadata-read-forbidden`;
|
|
60
|
+
- **业务数据读**:其余 `GET` 一律按业务数据拦截,要求 `data.read`,报 `data-read-forbidden`;
|
|
61
|
+
- **写**:非 `GET` 且不属于元数据消息(`PublishXml`、`InsertOptionValue`、`CreateAttribute`、`RemoveActiveCustomizations`…)的请求,先要求 `data.write`,否则报 `data-write-forbidden`;`d365_invoke` 的 `POST` 走 `message.invoke`(被拒绝时 `message-invoke-forbidden`),它的 `GET` function 仍是读,走 `data.read`;
|
|
62
|
+
|
|
63
|
+
拦截都发生在**取令牌之前**,不会把请求发到环境里。判定结果按环境缓存 2 秒,设置页改了权限后下一次工具调用就生效。
|
|
64
|
+
|
|
65
|
+
## 两步写入
|
|
66
|
+
|
|
67
|
+
### 第一步:生成计划(只读)
|
|
68
|
+
|
|
69
|
+
`plan-*` 会读现状、跳过无变化项,把操作写成计划文件(`.d365/pending-writes/`),返回操作列表。
|
|
70
|
+
|
|
71
|
+
| 计划 | 约束 |
|
|
72
|
+
| --- | --- |
|
|
73
|
+
| `plan-add-options` | 按 `\|` 前的代码去重;新值从当前最大值 +1 顺延;已存在的代码进 `skipped` |
|
|
74
|
+
| `plan-relabel` | 只把标签确实变化的项放进计划 |
|
|
75
|
+
| `plan-option-delete` | 必须 `acknowledge: true`;不存在的值进 `skipped`,已有记录引用时 Dataverse 会拒绝 |
|
|
76
|
+
| `plan-add-attribute` | 表必须存在、字段必须不存在;`SchemaName` 必须带发布者前缀 |
|
|
77
|
+
| `plan-update-attribute` | 只放真正变化的项 |
|
|
78
|
+
| `plan-delete-attribute` | 必须 `acknowledge: true`,否则直接拒绝 |
|
|
79
|
+
| `plan-update-entity` | 只改显示名 / 描述 |
|
|
80
|
+
| `plan-view-columns` | 按视图名定位系统视图(同名用 `entity` 区分);只改 `layoutxml` 的 cell 列表,不动筛选条件 |
|
|
81
|
+
|
|
82
|
+
局部选项集(字段自带的选项集)用 `entity` + `attribute` 指定,全局选项集用 `optionSet`。
|
|
83
|
+
|
|
84
|
+
### 第二步:执行(要人)
|
|
85
|
+
|
|
86
|
+
```
|
|
87
|
+
执行 mw04aul6-1ci6aa
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
agent 调 `d365_write action=execute planId=...`,会:
|
|
91
|
+
|
|
92
|
+
1. 读计划,检查状态必须是 `pending`;
|
|
93
|
+
2. 检查该环境**现在**仍持有这项能力;
|
|
94
|
+
3. 查环境是否正在导入/发布(见下);
|
|
95
|
+
4. 弹确认卡片:环境、目标、操作条数、前 10 条操作;含删除时额外提示不可恢复;
|
|
96
|
+
5. 点「批准执行」→ 逐条写入 → 后台发布 → 记审计。
|
|
97
|
+
|
|
98
|
+
也可以到设置页「计划」标签里审阅并执行(同样的二次红色确认)。两条入口共用同一套校验。
|
|
99
|
+
|
|
100
|
+
### 计划状态
|
|
101
|
+
|
|
102
|
+
`pending → running → done / failed`
|
|
103
|
+
|
|
104
|
+
第一次写入前就落 `running`,所以进程中途被杀不会留下一个「看起来还能点」的计划。非 `pending` 的计划,工具与设置页**都拒绝**执行和取消——写操作不是幂等的,重跑会重复提交已经生效的部分。要重做必须重新生成计划。
|
|
105
|
+
|
|
106
|
+
### 执行前检查
|
|
107
|
+
|
|
108
|
+
Dataverse 在导入或发布期间持有定制化锁。微软第一方更新就是以解决方案导入形式进来的,一个环境一天里很大一部分时间在做这件事——此时写入要么 `0x80071151`,要么一直等锁直到超时。
|
|
109
|
+
|
|
110
|
+
所以执行前查 `msdyn_solutionhistories` 里 `msdyn_endtime` 为空的行:
|
|
111
|
+
|
|
112
|
+
| 情况 | 行为 |
|
|
113
|
+
| --- | --- |
|
|
114
|
+
| 有记录且开始时间在 `busyWindowMinutes`(默认 120 分钟)内 | 拒绝执行,报出正在进行的操作(`environment-busy`) |
|
|
115
|
+
| 只有更早的记录(残留僵尸行) | 不阻塞,结果里提示一句 |
|
|
116
|
+
| 查不到表(没权限) | 跳过检查,结果注明没检查成 |
|
|
117
|
+
|
|
118
|
+
`force: true` 可跳过,只在确认是残留时用。
|
|
119
|
+
|
|
120
|
+
### 默认解决方案
|
|
121
|
+
|
|
122
|
+
每次元数据修改都记在某个**解决方案层**里。不指定时进活动默认层(Default Solution),导出解决方案带不走,下游表现为「字段不存在」。
|
|
123
|
+
|
|
124
|
+
所以建议填「变更默认解决方案」:一个**已存在的未受管**解决方案唯一名。计划阶段就校验——名字不存在报 `unknown-solution`,受管报 `managed-solution`,不用等到执行才失败。
|
|
125
|
+
|
|
126
|
+
### 发布范围
|
|
127
|
+
|
|
128
|
+
写完只发布**受影响的组件**:
|
|
129
|
+
|
|
130
|
+
- 选项集操作 → 对应选项集(本地选项集 → 所属表);
|
|
131
|
+
- 字段 / 表 / 视图操作 → 所属表。
|
|
132
|
+
|
|
133
|
+
负载形如:
|
|
134
|
+
|
|
135
|
+
```xml
|
|
136
|
+
<importexportxml>
|
|
137
|
+
<entities><entity>account</entity></entities>
|
|
138
|
+
<optionsets><optionset>contoso_taxcategoryos</optionset></optionsets>
|
|
139
|
+
</importexportxml>
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
一次发布是秒级到十几秒,而不是 `PublishAllXml` 把两千多张表重算一遍的分钟级操作。推不出受影响组件时才退回全量发布。发布在后台进行,结果写 `.d365/changes/publish-<planId>.json`;执行返回里会带 `publishState`(`skipped` / `running`)。
|
|
143
|
+
|
|
144
|
+
## 业务数据写入
|
|
145
|
+
|
|
146
|
+
`d365_data_write` 的三条约束:
|
|
147
|
+
|
|
148
|
+
- 需要 `data.write`,默认关闭;
|
|
149
|
+
- 只能写**一个**环境;
|
|
150
|
+
- 每次弹确认卡片,批准才发请求。
|
|
151
|
+
|
|
152
|
+
写入不需要发布(业务数据不是元数据)。审计只记字段名、不落值。没有删除。
|
|
153
|
+
|
|
154
|
+
## 安全边界
|
|
155
|
+
|
|
156
|
+
- **写接口只接受设置页**:`/write/policy`、`/write/cancel`、`/write/execute`、`/write/publish` 要求 `x-d365-meta-write: 1` 头。跨站页面要带这个头必须过 CORS 预检,而这些路由不回应预检;若请求里有 `Origin`,还必须同源。认证通道会把 URL 改写成 `http://dsh.internal` 并吞掉 `Origin`,所以不能只靠 Origin 判断。被拒的请求记 `.d365/write-guard.log`。
|
|
157
|
+
- **重试只对安全方法**:`GET`/`HEAD` 在网络错误与 5xx 上重试;`POST`/`PATCH`/`DELETE` 只在 **429**(服务端明确没执行)时重试。写入超时按「可能已生效」报错,让人去环境核对,而不是悄悄重发。
|
|
158
|
+
- **重新发布也要过门槛**:该环境必须仍持有当时那项能力,且先做一次空闲检查(忙时返回 409,而不是原始 429)。
|
|
159
|
+
- **取消与执行一样拒绝非 `pending`**:不会出现「页面说取消了、后台还在写」。
|
|
160
|
+
- **不可回滚**:元数据删除不可恢复,所以删除必须 `acknowledge: true`,卡片上还会单独提示。
|
|
161
|
+
- 写接口不提供批量脚本入口,也没有「跳过确认」的开关;`force` 只跳过空闲检查,不跳过确认。
|
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
# 使用场景
|
|
2
|
+
|
|
3
|
+
**[English](../en/scenarios.md)** | 简体中文
|
|
4
|
+
|
|
5
|
+
下面这些都是可以直接对 agent 说的话。工具参数在括号里,agent 会自己补。
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. 接手一个环境,先摸清楚
|
|
10
|
+
|
|
11
|
+
```
|
|
12
|
+
四个环境都连一下,看看各自在干什么。
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
d365_envs check=true
|
|
17
|
+
d365_health allEnvironments=true hours=24
|
|
18
|
+
d365_metadata resource=organization
|
|
19
|
+
d365_metadata resource=solutions top=10 orderby="installedon desc"
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
得到:每个环境是否连通、组织版本、挂起/失败作业、正在进行的导入发布、最近装了什么。
|
|
23
|
+
|
|
24
|
+
这是回答任何「环境里有没有 X」之前的第一步——避免把「没配置」误说成「环境里没有」。
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## 2. 这个字段能删吗
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
account 上的 contoso_customertier,现在还有哪些表单、视图、流程在用?顺便看下还有多少条记录带着值。
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
d365_refs kind=field entity=account attribute=contoso_customertier allEnvironments=true
|
|
36
|
+
d365_data action=group entity=account field=contoso_customertier top=10
|
|
37
|
+
d365_layers component=contoso_customertier componentType=Attribute entity=account
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
三份证据合起来:
|
|
41
|
+
|
|
42
|
+
- **引用**:17 张表单、64 个视图(列 62 / 筛选 50)、0 条流程/业务规则;
|
|
43
|
+
- **数据**:该字段有值的记录分布(空值单独一档);
|
|
44
|
+
- **层**:这个字段是谁加的、当前生效层是哪个解决方案——如果来自受管解决方案,本地删不掉,只能让发布方改。
|
|
45
|
+
|
|
46
|
+
删除本身是 `d365_write action=plan-delete-attribute ... acknowledge=true`,但通常先用这三份证据说服人。
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## 3. 两个环境为什么不一样
|
|
51
|
+
|
|
52
|
+
```
|
|
53
|
+
把 DEV 和 SIT 的表单、视图、字段各同步一份,然后告诉我差异,再解释 Account 表单为什么会不一样。
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
```
|
|
57
|
+
d365_sync environments=["dev","sit"] resources=["forms","views","solutions"] includeAttributes=true entities=["account"]
|
|
58
|
+
d365_diff base=dev head=sit resources=["forms","views","attributes"]
|
|
59
|
+
d365_layers component=Account componentType=SystemForm allEnvironments=true
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
`d365_diff` 给机械差异(哪些行新增/删除/改字段),`d365_layers` 给原因(谁覆盖了它、谁在最上层)。
|
|
63
|
+
|
|
64
|
+
噪声已经处理过:时间戳与 `*id` 列不参与比较,`organization` 默认跳过。表单内容差异大时,报告里的字段级 diff 比整段 XML 可读得多。
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## 4. 发布前评估一个解决方案
|
|
69
|
+
|
|
70
|
+
```
|
|
71
|
+
把 ContosoBase 从 DEV 发到 SIT 和 UAT,有什么风险?
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
```
|
|
75
|
+
d365_migrate action=assess source=dev solution=ContosoBase targets=["sit","uat"]
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
报告会回答:
|
|
79
|
+
|
|
80
|
+
- 目标有没有这个解决方案,源版本是不是更高;
|
|
81
|
+
- 每个组件在目标的最上层是谁,导入后哪些解决方案的定义会被压住(列出被遮蔽的解决方案,按组件数排序);
|
|
82
|
+
- 选项集的值会不会丢(源有、目标没有的值 = 严重;标签不一致 = 警告);
|
|
83
|
+
- 目标缺失的组件;
|
|
84
|
+
- 源是未受管时,导入后形成的层无法通过卸载解决方案清除。
|
|
85
|
+
|
|
86
|
+
真实案例:一个只含 1 个全局选项集的解决方案,评估结论可能是「0 严重、2 警告,但会让 7 个解决方案的定义失效」——真正要决策的不是丢不丢数据,而是**以后谁再导入一次 Contoso 的 patch,就会把这个层又盖回去**。
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## 5. 检查一个 MR 能不能发到 UAT
|
|
91
|
+
|
|
92
|
+
```
|
|
93
|
+
https://gitlab.example.com/contoso/powerapps/-/merge_requests/7759/diffs 这个 MR 发到 UAT 会不会有问题?
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
```
|
|
97
|
+
d365_code_check mergeRequest="https://gitlab.example.com/contoso/powerapps/-/merge_requests/7759/diffs" targets=["uat"]
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
输出三段:
|
|
101
|
+
|
|
102
|
+
- **阻断**:字段不在任何引用该库的表单上、实体不存在、删除的函数仍被 Handler 引用、C# 类型/步骤/镜像缺失;
|
|
103
|
+
- **警告**:字段只在部分表单上、程序集版本没提升、硬编码 GUID;
|
|
104
|
+
- **人工确认**:配置数据、secure configuration、权限、列名与普通键的歧义。
|
|
105
|
+
|
|
106
|
+
报告在 `.d365/reports/code-check-<MR>-<时间戳>.md`。
|
|
107
|
+
|
|
108
|
+
纯 C# 的 MR 也能跑:按工程目录推断程序集 → 精确匹配 → 查类型/步骤/镜像/过滤属性。程序集名只做精确匹配,猜错比不查更糟。
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
## 6. 补一批选项值
|
|
113
|
+
|
|
114
|
+
```
|
|
115
|
+
contoso_taxcategoryos 还缺 36 个税号类型,按 .d365/reports 里的清单补到 DEV。
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
```
|
|
119
|
+
d365_write action=plan-add-options environment=dev optionSet=contoso_taxcategoryos \
|
|
120
|
+
labels=["AD3|Andorra: Tax Register Number (NRT)", "..."]
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
计划返回操作列表(值从当前最大值 +1 顺延、已存在的代码进 skipped)。核对后:
|
|
124
|
+
|
|
125
|
+
```
|
|
126
|
+
执行 mw04aul6-1ci6aa
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
对话里弹卡片 → 批准 → 写入 → 只发布这个选项集。审计在 `.d365/changes/`,发布结果在 `.d365/changes/publish-<planId>.json`。
|
|
130
|
+
|
|
131
|
+
**其余环境不要重复手工追加**:随解决方案导入走,否则下次谁再导入受管 patch,手工加的层就被压掉了。
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## 7. 上游改了插件,下游缺什么
|
|
136
|
+
|
|
137
|
+
```
|
|
138
|
+
DEV 的插件注册,SIT 和 UAT 都跟上了吗?顺便看下表单引用的脚本有没有缺。
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
```
|
|
142
|
+
d365_contract action=drift source=dev targets=["sit","uat"] forms=true
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
典型结果(真实数据):86 条 = 程序集缺失 4、插件步骤缺失 72、类型缺失 8、表单库缺失 2。
|
|
146
|
+
`forms=false` 可跳过读 formxml;`handlers=true` 会下载脚本核对函数是否存在(慢,最多 400 个脚本/环境)。
|
|
147
|
+
|
|
148
|
+
确实允许的差异登记豁免:
|
|
149
|
+
|
|
150
|
+
```
|
|
151
|
+
d365_contract action=waive rule=form-library-missing env=sit \
|
|
152
|
+
object="/_static/_common/scripts/CommandbarActions.js" reason="该环境不用 SLA 对话框" days=30
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
下次跑同一组 `source → targets`,会给出「新增 N / 已消失 M」的趋势。
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## 8. 发布卡住了 / 现在能不能写
|
|
160
|
+
|
|
161
|
+
```
|
|
162
|
+
四个环境现在有正在跑的导入或发布吗?我想改点元数据。
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
```
|
|
166
|
+
d365_health allEnvironments=true
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
如果某个环境有正在进行的 `Publish` 或导入,任何写入都会 `0x80071151` 或等锁超时。等它结束再执行;`d365_write execute` 本身也会先查这一步,忙时直接拒绝而不是丢一个原始 429。
|
|
170
|
+
|
|
171
|
+
确认那条记录是残留(例如几天前中断的导入)时,才用 `force: true`。
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
|
|
175
|
+
## 9. 磁盘被产物撑大了
|
|
176
|
+
|
|
177
|
+
```
|
|
178
|
+
.d365 现在多大?哪些能清?
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
```
|
|
182
|
+
d365_reports action=list
|
|
183
|
+
d365_reports action=cleanup target=query # 默认只预演
|
|
184
|
+
d365_reports action=cleanup target=query dryRun=false
|
|
185
|
+
d365_reports action=compact # 把快照 JSON 压成单行
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
真实数据:四份全量快照约 540 MB,压成单行省 68 MB;单份快照里 `plugin_steps.json` 约 55 MB、`solution_components.json` 约 39 MB、`web_resources.json` 约 20 MB。
|
|
189
|
+
|
|
190
|
+
保留策略与自动清理见 [tools.md](tools.md#d365_reports) 与根目录 README。
|
|
191
|
+
|
|
192
|
+
---
|
|
193
|
+
|
|
194
|
+
## 组合用法
|
|
195
|
+
|
|
196
|
+
| 想问 | 组合 |
|
|
197
|
+
| --- | --- |
|
|
198
|
+
| 改这个字段安全吗 | `d365_refs` + `d365_data` + `d365_layers` |
|
|
199
|
+
| 这个版本能发吗 | `d365_health` + `d365_migrate` + `d365_contract` |
|
|
200
|
+
| 这个 MR 能合吗 | `d365_code_check` + `d365_refs` |
|
|
201
|
+
| 环境之间差在哪 | `d365_sync` + `d365_diff` + `d365_layers` |
|
|
202
|
+
| 为什么运行时报错 | `d365_refs`(字段/脚本引用)+ `d365_layers`(谁覆盖)+ `d365_health`(作业) |
|