Notificar as pessoas com comentários

Este exemplo mostra como adicionar comentários a uma célula, incluindo @mentioning um colega.

Cenário de exemplo

O líder da equipe mantém o agendamento de turnos. Eles atribuem uma ID do funcionário ao registro de turno. Se o líder da equipe quiser notificar o funcionário, ele adicionará um comentário que @mentions o funcionário. O funcionário é enviado por email com uma mensagem personalizada da planilha. Posteriormente, o funcionário pode exibir a pasta de trabalho e responder ao comentário por conveniência.

Solução

1. O script extrai informações de funcionários da planilha do funcionário.
2. Em seguida, o script adiciona um comentário (incluindo o email relevante do funcionário) à célula apropriada no registro de turno.
3. Os comentários existentes na célula são removidos antes de adicionar o novo comentário.

Instalação: Exemplo de arquivo do Excel

Esta pasta de trabalho contém os dados, objetos e formatação esperados pelo script.

Baixar a pasta de trabalho de exemplo

Código de exemplo: adicionar comentários

Adicione o script a seguir à pasta de trabalho de exemplo e experimente a amostra por conta própria!

function main(workbook: ExcelScript.Workbook) {
  // Get the list of employees.
  const employees = workbook.getWorksheet('Employees').getUsedRange().getTexts();

  // Get the schedule information from the schedule table.
  const scheduleSheet = workbook.getWorksheet('Schedule');
  const table = scheduleSheet.getTables()[0];
  const range = table.getRangeBetweenHeaderAndTotal();
  const scheduleData = range.getTexts();

  // Find old comments, so we can delete them later.
  const oldCommentAddresses = scheduleSheet.getComments().map(oldComment => oldComment.getLocation().getAddress());

  // Look through the schedule for a matching employee.
  for (let i = 0; i < scheduleData.length; i++) {
    const employeeId = scheduleData[i][3];

    // Compare the employee ID in the schedule against the employee information table.
    const employeeInfo = employees.find(employeeRow => employeeRow[0] === employeeId);
    if (employeeInfo) {
      const adminNotes = scheduleData[i][4];
      const commentCell = range.getCell(i, 5);

      // Delete old comments, so we avoid conflicts.
      if (oldCommentAddresses.find(oldCommentAddress => oldCommentAddress === commentCell.getAddress())) {
        const comment = workbook.getCommentByCell(commentCell);
        comment.delete();
      }

      // Add a comment using the admin notes as the text.
      workbook.addComment(commentCell, {
        mentions: [{
          email: employeeInfo[1],
          id: 0, // This ID maps this mention to the `id=0` text in the comment.
          name: employeeInfo[2]
        }],
        richContent: `<at id=\"0\">${employeeInfo[2]}</at> ${adminNotes}`
      }, ExcelScript.ContentType.mention);
    } else {
      console.log("No match for: " + employeeId);
    }
  }
}