export interface AnnotationInsertSpec {
|
alias: string;
|
placeholder: string;
|
tag: string;
|
}
|
|
export interface AnnotationInsertResult {
|
error?: string;
|
ok: boolean;
|
}
|
|
export interface FlowVersionPropertiesSpec {
|
newFlowVersionId: string;
|
revisionFlowVersionId: string;
|
}
|
|
/**
|
* This command is serialized into the ONLYOFFICE editor context. Keep it self-contained:
|
* it may access only Api and Asc.scope, not imports or closure state.
|
*/
|
export function insertAnnotationControlCommand(): string {
|
try {
|
const spec = Asc.scope.dmsQianpiyeInsert as AnnotationInsertSpec | undefined;
|
if (!spec || typeof spec.tag !== 'string' || !spec.tag || typeof spec.alias !== 'string'
|
|| typeof spec.placeholder !== 'string' || !spec.placeholder) {
|
throw new Error('签批页标注配置无效');
|
}
|
const document = Api.GetDocument();
|
if (!document || typeof document.GetAllContentControls !== 'function') {
|
throw new Error('当前编辑器不支持读取内容控件');
|
}
|
const before = document.GetAllContentControls().filter((control) => control.GetTag?.() === spec.tag);
|
if (typeof Api.CreateInlineLvlSdt !== 'function' || typeof Api.CreateRun !== 'function'
|
|| typeof Api.CreateParagraph !== 'function') {
|
throw new Error('当前编辑器不支持签批页标注控件');
|
}
|
|
const control = Api.CreateInlineLvlSdt();
|
const run = Api.CreateRun();
|
const paragraph = Api.CreateParagraph();
|
if (!control || !run || !paragraph || run.AddText?.(spec.placeholder) !== true
|
|| control.AddElement?.(run, 0) !== true || typeof paragraph.AddInlineLvlSdt !== 'function') {
|
throw new Error('创建签批页标注失败');
|
}
|
// AddInlineLvlSdt is a write-only API in ONLYOFFICE 9.4 and returns void.
|
paragraph.AddInlineLvlSdt(control);
|
if (control.SetTag?.(spec.tag) !== true || control.SetAlias?.(spec.alias) !== true
|
|| control.SetLock?.('unlocked') !== true) {
|
throw new Error('创建签批页标注失败');
|
}
|
if (typeof control.SetAppearance === 'function') {
|
control.SetAppearance('boundingBox');
|
}
|
if (typeof document.InsertContent !== 'function' || document.InsertContent([paragraph], true) !== true) {
|
throw new Error('插入签批页标注失败');
|
}
|
|
const after = document.GetAllContentControls().filter((item) => item.GetTag?.() === spec.tag);
|
if (after.length !== before.length + 1) {
|
throw new Error('签批页标注插入后校验失败');
|
}
|
return JSON.stringify({ ok: true });
|
} catch (error: unknown) {
|
return JSON.stringify({
|
ok: false,
|
error: error instanceof Error ? error.message : String(error),
|
});
|
}
|
}
|
|
/**
|
* Marks the version selection in the in-editor document. ONLYOFFICE 9.4 cannot delete custom
|
* properties, so the qianpiye save callback is responsible for the final server-side upsert.
|
*/
|
export function stageFlowVersionPropertiesCommand(): string {
|
try {
|
const spec = Asc.scope.dmsQianpiyeFlowVersionProperties as FlowVersionPropertiesSpec | undefined;
|
if (!spec || typeof spec.newFlowVersionId !== 'string' || !spec.newFlowVersionId
|
|| typeof spec.revisionFlowVersionId !== 'string' || !spec.revisionFlowVersionId) {
|
throw new Error('签批页流程版本配置无效');
|
}
|
const document = Api.GetDocument();
|
const properties = document?.GetCustomProperties?.();
|
if (!properties || typeof properties.Add !== 'function' || typeof properties.Get !== 'function') {
|
throw new Error('当前编辑器不支持保存签批页流程版本');
|
}
|
for (const [key, value] of [
|
['DMS_NEW_FLOW_VERSION_ID', spec.newFlowVersionId],
|
['DMS_EDIT_FLOW_VERSION_ID', spec.revisionFlowVersionId],
|
]) {
|
const existing = properties.Get(key);
|
if (existing === value) continue;
|
// Add can append a duplicate in ONLYOFFICE 9.4. The qianpiye save callback uses the last
|
// value as the requested selection, then writes one canonical property for each key.
|
if (properties.Add(key, value) !== true) throw new Error('保存签批页流程版本失败');
|
}
|
return JSON.stringify({ ok: true });
|
} catch (error: unknown) {
|
return JSON.stringify({
|
ok: false,
|
error: error instanceof Error ? error.message : String(error),
|
});
|
}
|
}
|
|
export function parseInsertResult(value: unknown): AnnotationInsertResult {
|
try {
|
const result: unknown = JSON.parse(String(value));
|
if (typeof result === 'object' && result !== null && !Array.isArray(result)
|
&& typeof (result as Record<string, unknown>).ok === 'boolean') {
|
const item = result as Record<string, unknown>;
|
return {
|
ok: item.ok as boolean,
|
...(typeof item.error === 'string' ? { error: item.error } : {}),
|
};
|
}
|
} catch {
|
// The command result is untrusted editor output; expose a normalized error below.
|
}
|
return { ok: false, error: '签批页标注命令返回无效' };
|
}
|
