GetArlingtonValidationCoverageJSON

合规、文档检查

描述

返回本实例最近一次 ValidateArlingtonSyntax 或 ValidateArlingtonPipelineSyntax 调用的状态与覆盖情况

语法

Delphi

Function TPDFlib.GetArlingtonValidationCoverageJSON: WideString;

ActiveX

Function PDFlib::GetArlingtonValidationCoverageJSON() As String

DLL

const wchar_t* DLGetArlingtonValidationCoverageJSON(int InstanceID);
const char* DLGetArlingtonValidationCoverageJSONA(int InstanceID);

返回值

一个 JSON 对象，status 为 not-checked、passed、failed、incomplete 或 error

备注

即使验证方法返回零也要读取本报告：零可能表示没有发现问题，也可能表示验证根本无法启动

覆盖情况会区分已执行的规则、不受支持的规则与不适用于该文档的规则；计数针对的是不同的模型规则与文档路径组合，而不是模型中的所有行

不受支持的表达式会产生 ARLINGTON_UNSUPPORTED 问题与 incomplete 的覆盖结果，而不会悄悄暗示每条规则都已检查

因首个问题而停止的运行会记录自己提前停止，不会声称覆盖完整；已知失败仍会给出 failed 结果

模型、管线或输入无效会产生 error 状态；同时请检查 LastErrorCode 了解操作失败原因

报告会保留到同一实例的下一次 Arlington 验证调用；该 getter 不会重新运行验证，也不会更改选定的文档

DLL 宽指针在同一实例下一次返回宽字符串之前保持有效；A 变体返回 UTF-8，遵循对应的 ANSI 返回缓冲区生命周期

示例

IssuesID := PDF.ValidateArlingtonSyntax('input.pdf', '', ModelID, 0);
CoverageJSON := PDF.GetArlingtonValidationCoverageJSON;
if IssuesID <> 0 then
  PDF.ReleaseStringList(IssuesID);

另请参阅

LoadArlingtonModel、ValidateArlingtonSyntax、ValidateArlingtonPipelineSyntax、LastErrorCode