Добавление изображений в книгу

В этом примере показано, как работать с изображениями с помощью сценария Office в Excel.

Сценарий

Изображения помогают с фирменной символикой, визуальной идентификацией и шаблонами. Они помогают сделать книгу больше, чем просто гигантский стол.

В первом примере изображение копируется с одного листа на другой. Это можно использовать для размещения логотипа вашей компании в одном и том же положении на каждом листе.

Во втором примере изображение копируется из URL-адреса. Его можно использовать для копирования фотографий, хранящихся коллегой в общей папке, в связанную книгу. Обратите внимание, что этот пример не может быть адаптирован для работы с локальным файлом образа, так как он не поддерживается сценариями Office.

Настройка: пример файла Excel

Эта книга содержит данные, объекты и форматирование, ожидаемые скриптом.

Скачивание примера книги

Пример кода: копирование изображения на разных листах

Добавьте следующий скрипт в пример книги и попробуйте его самостоятельно!

/**
 * This script transfers an image from one worksheet to another.
 */
function main(workbook: ExcelScript.Workbook)
{
  // Get the worksheet with the image on it.
  let firstWorksheet = workbook.getWorksheet("FirstSheet");

  // Get the first image from the worksheet.
  // If a script added the image, you could add a name to make it easier to find.
  let image: ExcelScript.Image;
  firstWorksheet.getShapes().forEach((shape, index) => {
    if (shape.getType() === ExcelScript.ShapeType.image) {
      image = shape.getImage();
      return;
    }
  });

  // Copy the image to another worksheet.
  image.getShape().copyTo("SecondSheet");
}

Пример кода: добавление изображения из URL-адреса в книгу

Важно!

Этот пример не будет работать в Power Automate из-за fetch вызова.

async function main(workbook: ExcelScript.Workbook) {
  // Fetch the image from a URL.
  const link = "https://raw.githubusercontent.com/OfficeDev/office-scripts-docs/master/docs/images/git-octocat.png";
  const response = await fetch(link);

  // Store the response as an ArrayBuffer, since it is a raw image file.
  const data = await response.arrayBuffer();

  // Convert the image data into a base64-encoded string.
  const image = convertToBase64(data);

  // Add the image to a worksheet.
  workbook.getWorksheet("WebSheet").addImage(image);
}

/**
 * Converts an ArrayBuffer containing a .png image into a base64-encoded string.
 */
function convertToBase64(input: ArrayBuffer) {
  const uInt8Array = new Uint8Array(input);
  const count = uInt8Array.length;

  // Allocate the necessary space up front.
  const charCodeArray = new Array(count) as string[];
  
  // Convert every entry in the array to a character.
  for (let i = count; i >= 0; i--) { 
    charCodeArray[i] = String.fromCharCode(uInt8Array[i]);
  }

  // Convert the characters to base64.
  const base64 = btoa(charCodeArray.join(''));
  return base64;
}