Question

我几天前创建了this，其中我需要有关如何向所述文档添加自定义属性的帮助。

首先，我正在运行Word 1701（7766.2047）。

假设我有一个方法，我返回一个自定义属性。首先，我要检查是否已经创建了自定义属性。我会用一个简单的getItemOrNullObject（key）和..

来做到这一点

如果返回null然后只需创建它并将其返回
否则退回

据我所知，我需要返回context.sync（）。然后对于实际加载数据的对象？我做了太多的返回context.sync（）调用什么？

Word.run(function(context) {
  var customDocProps = context.document.properties.customProperties;
  context.load(customDocProps);
  return context.sync()
    .then(function() {
      var temp = customDocProps.getItemOrNullObject("X");
      return context.sync()
        .then(function() {
          if (!temp) {
            context.document.properties.customProperties.add("X", 1234);
            temp = customDocProps.getItemOrNullObject("X");
            return context.sync()
              .then(function() {
                return temp;
              });
          } else {
            return temp;
          }
        });
    });
});

下面的代码抛出一个'ReferenceError：'Word'在开始时未定义'，但如果我调试它就会在它中断之前运行

var customDocProps = context.document.properties.customProperties; context.load(customDocProps); return context.sync().{....}

还有一个问题。假设我想更新我的自定义属性，将：

Word.run(function (context) {
        context.document.properties.customProperties.add("X", 56789);
        return context.sync();
    });

用新的值覆盖旧值？

如果你读到这里，谢谢你！任何帮助表示赞赏。干杯！

Answer 1

感谢您提出这个问题。

你的代码是正确的，除了一个小细节：所有* getItemOrNullObject方法都 NOT 返回一个JavaScript null，所以你的＆＃34; if（！temp）＆＃34;声明无法按预期工作。如果要验证存在，则需要调用if（temp.isNullObject）。

还有几点建议：

customProperties.add（）语义是，如果该属性确实存在，它将被替换。因此，如果您想创建或更改属性，则不需要检查它是否存在。如果你想读取它的当前值。这回答了你的第二个问题。
如果您对加载单个属性感兴趣，我会为您的代码提供简化且更有效的建议。

＆＃13;

  Word.run(function (context) {
    var myProperty = context.document.properties.customProperties.getItemOrNullObject("X");
    context.load(myProperty);
    return context.sync()
      .then(function () {
        if (myProperty.isNullObject) {
          //this means the Custom Property does not exist....
          context.document.properties.customProperties.add("X", 1234);
          console.log("Property Created");
          return context.sync();
        }
        else
          console.log("The property already exists,  value:" + myProperty.value);
      })
  })
  .catch(function (e) {
      console.log(e.message);
    })

＆＃13;

我们将更新文档，因为这似乎令人困惑。

谢谢！

Answer 2

我使用这些功能来获取或设置自定义属性

// sets a custom property on the current Word file
function setDocProperty (propName, propValue, callback) {
  Word.run(context => {
    context.document.properties.customProperties.add(propName, propValue)
    return context.sync()
      .then(() => {
        callback(null)
      })
      .catch(e => {
        callback(new Error(e))
      })
  })
}

// gets a custom property from the current Word file
function getDocProperty (propName, callback) {
  Word.run(context => {
    var customDocProps = context.document.properties.customProperties
    // first, load custom properties object
    context.load(customDocProps)
    return context.sync()
      .then(function () {
        // now load actual property
        var filenameProp = customDocProps.getItemOrNullObject(propName)
        context.load(filenameProp)
        return context.sync()
          .then(() => {
            callback(null, filenameProp.value)
          })
          .catch(err => {
            callback(new Error(err))
          })
      })
      .catch(err => {
        callback(new Error(err))
      })
  })
}

您可以这样使用它们：

setDocProperty('docId', 28, () => {
  console.log('property set') 
})

getDocProperty('docId', (err, value) => {
  if (err) {
    console.log('Error getting property', err)
  } else {
    console.log('the property is ' + value)
  }
})

（适用于Office的JavaScript API 1.3）自定义属性GetItemOrNull

2 个答案: