@mcp-abap-adt / adt-strategies

自从adt-clients 36.0.0 下面每个电话都打给32个成员之一 采取 options.headers （create， update， updateMetadata， delete， checkDeletion， check， activate 其他的列在 请求自己的标头)传递请求自己的 Accept / Content-Type 对。 在这些样本中 headers 代表那一对，an IAdtHeaders （{ accept, contentType });成员准确地发送它。

的阅读和结论 @mcp-abap-adt/adt-clients： 一个ADT的答案变成了什么，以及它是否是一个失败-来自记录 ADT的答案。

为什么这是一个单独的包

adt-clients 解释 没有什么． 每个成员提出一个ADT请求 响应SAP发送的文档，除非您使用 阅读;它不评判任何东西，除非你通过 analyse 有了电话。这是 深思熟虑：你想要文件的哪一部分，以及答案是否为 失败，取决于你接触的对象类型和你在做什么 适合你的图书馆可能不适合别人。

这给那些还没有意见的人留下了很大的空白。这个包裹装满了 它有一个观点，作为一个整体陈述，建立在证据而不是品味的基础上。 自 adt-clients 23.0.0它持有 每一个 阅读和裁决，图书馆 用于单独应用：传输树，搜索命中，版本提要， 单元测试运行id， abapGit存储库，ATC和分析器形状， 包删除和发布判决。 迁移- 23. - md 将每个旧行为映射到替代它的策略。

两个轴，两个力矩。 一、 结果 当你建立一个 实现-结果集中每个成员一个槽 adt-clients 出口 对于它(transportDocuments， utilDocuments,……)。一个 错误 给出了策略 随着每一次呼唤，as options.analyse：

import { transportDocuments } from '@mcp-abap-adt/adt-clients';
import {
  analyseDeletion,
  transportSearchConfigurations,
  transportTree,
} from '@mcp-abap-adt/adt-strategies';

const requests = client.getRequest({
  ...transportDocuments,
  list: transportTree,
  searchConfigurations: transportSearchConfigurations,
});

await client.getPackage().delete({ packageName: 'ZPKG' }, { headers, analyse: analyseDeletion });

import { analyseActivation, asItCame } from '@mcp-abap-adt/adt-strategies';

const answer = await client
  .getClass()
  .activate({ className: 'ZCL_X' }, { headers, analyse: analyseActivation });

if (!answer.ok) {
  for (const message of answer.getError().messages) {
    console.error(`[${message.type}] ${message.text}`);
  }
}

为什么不能是一个规则

ADT没有单一的说不的方式。从录音中 corpus/adt/ （answers/ 和 debugger/)在此存储库的adt-clients目录下：

一起读最后三行。问一个端点家庭的问题， 根据对象类型有两种回答方式。一项与地位密切相关的规则 沉默地错过第一个，并报告一个已取的名字为空闲。

里面有什么？

误差轴。 每个文档表单都有一个策略 analyseActivation， analyseCheck， analyseDeletion， analyseValidation， analyseUnitTest， analyseException， analysePublication， analyseCdsTestDoubles - - - - - - analyseAny，它在根元素上进行分派 当表格事先不知道，并且为一个问题构建了五个： analyseMessageClassMessage(msgno)， analyseObjectProperties， analyseUnitTestStart， analysePublicationLock， analyseDebuggeeEnd， analyseDebuggerFreed 和 analyseUnsupportedStatus(statuses, what).

每个人回答一个。 IAdtMessageFailure：合同的 IAdtError 加上每 文档中的消息，已规范化。SAP以三种方式表达了其严重性，并进行了传播 一个T100键正好在其中一个表单中；读数会使来电者变平 匹配 type === 'E' 不需要知道他们用的是哪艘航母。

为什么一项战略会这么说

其中有几个问题的存在是因为SAP解决了一些问题，而不是它的意思 一个 403 要忽略的服务绑定的LOCK （analysePublicationLock)，内心的拒绝 200 （analysePublication， analyseActivation， analyseDeletion）. 为什么 analysePublicationLock Exists是in ERRATA.md -在这个包裹中发货，并保存在广告客户在 文档/使用/ ERRATA.md.

整个表面

结果轴 -每一个 IResultStrategy 对于an的一个槽 adt-clients 结果集:

从答案中读出的代码是an IAdtAnsweredObject (因为0.16.0)。这个 从答案中获取类型代码的读数 readSearchHits / utilSearchHits， readNodeStructure / utilNodeContents， utilInactiveObjects， utilWhereUsedReferences 还有跟踪读数程序 的ADT类型表查找一次 @mcp-abap-adt/interfaces-adt (每一种变体：答案不说明是哪一种 释放发送它)和回答 { type: AdtTypeCode } 对于一个代码，一个表保存， { unknownType: string } -文本与ADT发送的完全一样-对于任何其他。 answeredObject(text) 对于读取代码本身的消费者来说，这是查找吗？

import { answeredObject } from '@mcp-abap-adt/adt-strategies';

const object = answeredObject('CLAS/OC');
if (object.type !== undefined) {
  // a code of the tables: act on it
} else {
  console.warn(`not a code the library serves: ${object.unknownType}`);
}

在表单已知的地方使用命名策略。 analyseAny 答案 null 对于一个它不能识别的文件 null 这里的意思是“不失败”——所以 一个没有人写过阅读材料的表格被认为是成功的。

A阅读答案 null 两种不同的东西：非文本的文件 拒绝，和一份文件的形式不是它写的。一个需要的来电者 区分调用特定的读取而不是调度程序。

所有的结果读数都不是默认值。 adt-clients 回答了 文档;塑造它是消费者的决定-哪些领域，什么目的- 这些都是按名称提供给想要图书馆形状的消费者 用来强加大多数读数都回答了一个它们不能回答的文件的空形状 阅读-判断文件是 analyse老师的工作，而不是阅读。两个扔的时候 文档没有 tm:root： transportTree 和 transportCreated,因为 空树或空请求将报告不存在的内容。 adt-clients 让读取异常以自身的形式出现。

违约是如何合理的

每一种策略都要根据它所依据的记录答案进行测试 和 必须把它同记录在案的成功区分开来。这种配对就是 要点：在大多数这些端点上，拒绝和成功共享一个状态，所以 如果读数同时指向两个方向，那么它看起来是正确的，但什么也没有识别出来。

没有SAP系统。语料库是固定装置。

表的一行在第一次写的时候是错的——一个表被列出来了 在验证下，语料库在第一次运行时拒绝了它：一个表回答 400 对于例外文档，则不是 <SEVERITY>ERROR</SEVERITY>． 这就是 此包的参数在一行中。

执照

lgpl - 3.0。