Office.js/Word Javascript API 中的 insertOoxml 方法中的错误

Question

如何报告 Office.js/Word javascript API 中的错误？

错误是，当尝试通过 range.insertOoxml(...) 或 context.document.body.insertOoxml(...) 插入类似锚的书签时，api 指示成功，但生成的文档确实如此没有书签。唯一的解决方法是在带有锚的段落之后插入一个附加段落。不幸的是，这会在正文中引入额外的换行符，从而破坏体验。

基本上，这会默默地失败......

<w:body>
<w:p>
<w:bookmarkStart w:id="0" w:name="bookmarkAnchor"/>
<w:bookmarkEnd w:id="0"/>
</w:p>
</w:body>

...但这有效....

<w:body>
<w:p>
<w:bookmarkStart w:id="0" w:name="bookmarkAnchor"/>
<w:bookmarkEnd w:id="0"/>
</w:p>
<w:p/> <--- this is a miserable workaround!
</w:body>

我很高兴上传一些显示问题的测试代码。

Answer 1

感谢您发送此问题。 这里有 3 个问题：

1. 首先，您的示例中描述的 XML 是 WordProcessingML，而不是 OOXML。 insertOoxml method 预计会收到完整的 Office Open XML。

2. 也就是说...我为您的示例找到了一个稍微不同的 OOXML 表示，它可以在不添加新段落的情况下工作，请参见下面的示例。

3. 为什么要使用书签？从开发人员的角度来看，使用它们超级不可靠，我强烈建议您改用内容控件。书签很容易被最终用户破坏。

好的，首先这里是我正在使用的标记：

<?xml version="1.0" standalone="yes"?>
<?mso-application progid="Word.Document"?>
<pkg:package xmlns:pkg="http://schemas.microsoft.com/office/2006/xmlPackage">
  <pkg:part pkg:name="/_rels/.rels" pkg:contentType="application/vnd.openxmlformats-package.relationships+xml" pkg:padding="512">
    <pkg:xmlData>
      <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
        <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="word/document.xml"/>
      </Relationships>
    </pkg:xmlData>
  </pkg:part>

  <pkg:part pkg:name="/word/document.xml" pkg:contentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml">
    <pkg:xmlData>
      <w:document  xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
        <w:body>
          <w:p w:rsidR="00000000" w:rsidRDefault="005C4C17">
            <w:bookmarkStart w:id="0" w:name="MyBookmark"/>
            <w:r>
              <w:t>provides</w:t>
            </w:r>
            <w:bookmarkEnd w:id="0"/>
          </w:p>
          <w:sectPr w:rsidR="00000000">
            <w:pgSz w:w="12240" w:h="15840"/>
            <w:pgMar w:top="1440" w:right="1440" w:bottom="1440" w:left="1440" w:header="720" w:footer="720" w:gutter="0"/>
            <w:cols w:space="720"/>
          </w:sectPr>
        </w:body>
      </w:document>
    </pkg:xmlData>
  </pkg:part>
</pkg:package>

这里是代码：

 function insertOOXMLwithBookmark() {

        Word.run(function (context) {
            var myOOXML = "<?xml version='1.0' standalone='yes'?> <?mso-application progid='Word.Document'?> <pkg:package xmlns:pkg='http://schemas.microsoft.com/office/2006/xmlPackage'> <pkg:part pkg:name='/_rels/.rels' pkg:contentType='application/vnd.openxmlformats-package.relationships+xml' pkg:padding='512'> <pkg:xmlData> <Relationships xmlns='http://schemas.openxmlformats.org/package/2006/relationships'> <Relationship Id='rId1' Type='http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument' Target='word/document.xml'/> </Relationships> </pkg:xmlData> </pkg:part> <pkg:part pkg:name='/word/document.xml' pkg:contentType='application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml'> <pkg:xmlData> <w:document xmlns:w='http://schemas.openxmlformats.org/wordprocessingml/2006/main'> <w:body> <w:p w:rsidR='00000000' w:rsidRDefault='005C4C17'> <w:bookmarkStart w:id='0' w:name='MyBookmark'/> <w:r> <w:t>provides</w:t> </w:r> <w:bookmarkEnd w:id='0'/> </w:p> <w:sectPr w:rsidR='00000000'> <w:pgSz w:w='12240' w:h='15840'/> <w:pgMar w:top='1440' w:right='1440' w:bottom='1440' w:left='1440' w:header='720' w:footer='720' w:gutter='0'/> <w:cols w:space='720'/> </w:sectPr> </w:body> </w:document> </pkg:xmlData> </pkg:part> </pkg:package>";

            context.document.getSelection().insertOoxml(myOOXML, "replace");
            return context.sync();

示例代码只是替换当前选择或将其添加到插入点（基本上是一个范围），但当然您可以在任何支持范围的对象中重用这个完全相同的方法 让我知道这是否适合您并祝您编码愉快！！！

顺便说一句，我写了一篇你可能会觉得有用的文章： http://dev.office.com/docs/add-ins/word/create-better-add-ins-for-word-with-office-open-xml