使用Office Scripts修改Excel网页版柱状图指定列颜色时遇内部错误

问题重现 #

使用Office Scripts修改Excel网页版柱状图指定数据点颜色时，全系列颜色设置可正常执行：

function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getWorksheet("mySheet")
  const chart = sheet.getChart("myChart")
  const series = chart.getSeries()[0]

  series.getFormat().getFill().setSolidColor("red")
}

但指定单个数据点时，在const point = series.getPoints()[i]行触发内部错误：ChartSeries getPoints: There was an internal error while processing the request.，报错代码：

function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getWorksheet("mySheet")
  const chart = sheet.getChart("myChart")
  const series = chart.getSeries()[0]

  const i = 2
  const point = series.getPoints()[i]
  point.getFormat().getFill().setSolidColor("red")
}

已简化测试环境（新建仅含目标图表及对应数据的工作簿），问题仍存在；且脚本在Excel桌面版可正常运行，仅网页版出现异常。

解决方案 #

方法1：使用getItemAt()方法访问数据点 #

替换直接数组索引的方式，改用Office Scripts官方推荐的getItemAt()方法获取指定索引的数据点：

function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getWorksheet("mySheet")
  const chart = sheet.getChart("myChart")
  const series = chart.getSeries()[0]

  const i = 2
  const point = series.getPoints().getItemAt(i)
  point.getFormat().getFill().setSolidColor("red")
}

方法2：先获取数据点集合再操作 #

若方法1仍有问题，可先将数据点集合存入变量，再通过getItemAt()访问：

function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getWorksheet("mySheet")
  const chart = sheet.getChart("myChart")
  const series = chart.getSeries()[0]

  const i = 2
  const pointCollection = series.getPoints()
  const point = pointCollection.getItemAt(i)
  point.getFormat().getFill().setSolidColor("red")
}

原因说明 #

该问题属于Excel网页版Office Scripts的特定内部处理bug，直接通过数组索引访问数据点时会触发内部请求异常。使用getItemAt()方法是官方规范的索引访问方式，可规避此问题。

内容的提问来源于stack exchange，提问作者shrimp