Amostras de código de suplemento do Office

  • Artigo

Esses exemplos de código são escritos para ajudá-lo a aprender como usar vários recursos ao desenvolver suplementos do Office.

Introdução

Os exemplos a seguir mostram como construir o Suplemento do Office mais simples com apenas um manifesto, página da web HTML e um logotipo. Esses componentes são as partes fundamentais de um Suplemento do Office. Para obter informações adicionais sobre os primeiros passos, consulte nossos primeiros passos e tutoriais.

Blazor WebAssembly

Se o plano de fundo de desenvolvimento estiver na criação de suplementos VSTO, os exemplos a seguir mostrarão como criar Suplementos Web do Office usando o .NET Blazor WebAssembly. Você pode manter grande parte do código no C# e no Visual Studio.

Excel

Name Descrição
Gerenciador de tipos de dados (versão prévia) Cria um suplemento do Excel que permite criar e explorar tipos de dados em suas pastas de trabalho. Os tipos de dados permitem que desenvolvedores de suplementos organizem estruturas de dados complexas como objetos, como valores de número formatado, imagens da Web e valores de entidade.
Abrir no Teams Crie uma nova planilha do Excel no Microsoft Teams contendo os dados que você definir.
Inserir um arquivo Excel externo e preenchê-lo com dados JSON Insira um modelo existente de um arquivo externo do Excel na pasta de trabalho do Excel aberta no momento. Em seguida, preencha o modelo com dados de um serviço Web JSON.
Crie guias contextuais personalizadas na faixa de opções Crie uma guia contextual personalizada na faixa de opções na interface do usuário do Office. O exemplo cria uma tabela e, quando o usuário move o foco dentro da tabela, a guia personalizada é exibida. Quando o usuário sai da tabela, a guia personalizada fica oculta.
Use os atalhos do teclado para ações do Suplemento do Office Configure um projeto de suplemento básico do Excel que utiliza atalhos de teclado.
Exemplo de função personalizada usando web worker Use web workers em funções personalizadas para evitar o bloqueio da interface do usuário do suplemento do Office.
Use técnicas de armazenamento para acessar dados de um suplemento do Office quando estiver offline Implemente o localStorage para habilitar a funcionalidade limitada do Suplemento do Office quando um usuário perder a conexão.
Padrão de lote de função personalizada Agrupe várias chamadas em uma única chamada para reduzir o número de chamadas de rede para um serviço remoto.

Outlook

Nome Descrição
Relatar emails de spam ou phishing no Outlook Mostra como criar uma solução integrada de relatório de spam que é facilmente detectável na faixa de opções de cliente do Outlook. Fornece ao usuário uma caixa de diálogo de processamento para relatar um email. Facilita salvar uma cópia do email relatado em um arquivo para enviá-la ao sistema de back-end para processamento adicional.
Criptografar anexos, processar os participantes da solicitação de reunião e reagir às alterações de data/hora do compromisso usando a ativação baseada em eventos do Outlook Use a ativação baseada em evento para criptografar anexos quando adicionados pelo usuário. Use também o tratamento de eventos para destinatários alterados em uma solicitação de reunião e alterações na data ou hora de início ou término em uma solicitação de reunião.
Identificar e marcar destinatários externos usando a ativação baseada em eventos do Outlook Use a ativação baseada em eventos para executar um suplemento do Outlook quando o usuário alterar os destinatários ao redigir uma mensagem. O suplemento também usa a API appendOnSendAsync para adicionar um aviso de isenção.
Defina sua assinatura usando a ativação baseada em eventos do Outlook Use a ativação baseada em eventos para executar um suplemento do Outlook quando o usuário criar uma nova mensagem ou compromisso. O suplemento pode responder a eventos, mesmo quando o painel de tarefas não está aberto. Ele também usa a API setSignatureAsync.
Verifique as categorias de cores de uma mensagem ou compromisso antes de ser enviada usando alertas inteligentes Use os Alertas Inteligentes do Outlook para verificar se as categorias de cores necessárias são aplicadas a uma nova mensagem ou compromisso antes de enviá-la.
Verificar o rótulo de confidencialidade de uma mensagem Use a API de rótulo de confidencialidade em um suplemento baseado em evento para verificar e aplicar o rótulo de confidencialidade Altamente Confidencial às mensagens de saída aplicáveis.
Relatar emails de spam ou phishing no Outlook (versão prévia) Crie um suplemento integrado de relatório de spam exibido em um local proeminente na faixa de opções do Outlook.

Word

Name Descrição
Obter, editar e definir conteúdo OOXML em um documento do Word com um suplemento do Word Este exemplo mostra como obter, editar e definir conteúdo OOXML em um documento do Word. O complemento de exemplo fornece um bloco de rascunho para obter o Office Open XML para seu próprio conteúdo e testar seus próprios trechos de código editados do Office Open XML.
Importar um modelo de documento Word com um suplemento Word Mostra como importar modelos em um documento Word.
Carregar e gravar Open XML no seu suplemento do Word Este exemplo de suplemento mostra como adicionar uma variedade de tipos de conteúdos avançados a um documento do Word usando o método setSelectedDataAsync com tipo de coerção ooxml. O suplemento também oferece a capacidade de mostrar a marcação do Office Open XML para cada tipo de conteúdo de exemplo na página.
Gerenciar citações com seu suplemento Word Mostra como gerenciar citações em um documento Word.

Autenticação, autorização e logon único (SSO)

Nome Descrição
Nome do exemplo Descrição
---------------- --------------------------------------------------------
Suplemento do Office com SSO usando autenticação de aplicativo aninhado Mostra como usar MSAL.js NAA (autenticação aninhada de aplicativo) em um Suplemento do Office para acessar APIs do Microsoft Graph para o usuário conectado. O exemplo exibe o nome e o email do usuário conectado. Ele também insere os nomes dos arquivos da conta do Microsoft OneDrive do usuário no documento.
Suplemento do Outlook com SSO usando autenticação aninhada de aplicativo Mostra como usar MSAL.js NAA (autenticação aninhada de aplicativo) em um Suplemento do Outlook para acessar APIs do Microsoft Graph para o usuário conectado. O exemplo exibe o nome e o email do usuário conectado. Ele também insere os nomes dos arquivos da conta do Microsoft OneDrive do usuário em um novo corpo de mensagem.
Usar o SSO com ativação baseada em eventos em um suplemento do Outlook Mostra como usar o SSO para acessar os dados do Microsoft Graph de um usuário de um evento disparado em um suplemento do Outlook.
Suplemento de amostra do Outlook de logon único (SSO) Use o recurso SSO do Office para fornecer ao suplemento acesso aos dados do Microsoft Graph.
Obtenha dados do OneDrive usando Microsoft Graph e msal.js em um suplemento do Office Crie um suplemento do Office, como um aplicativo de página única (SPA) sem back-end, que se conecta ao Microsoft Graph e acesse pastas de trabalho armazenadas no OneDrive for Business para atualizar uma planilha.
Autenticação do suplemento do Office para o Microsoft Graph Aprenda a criar um suplemento do Microsoft Office que se conecte ao Microsoft Graph e acesse pastas de trabalho armazenadas no OneDrive for Business para atualizar uma planilha.
Autenticação do suplemento do Outlook para Microsoft Graph. Crie um suplemento do Outlook que se conecte ao Microsoft Graph e acesse pastas de trabalho armazenadas no OneDrive for Business para redigir uma nova mensagem de email.
Suplemento do Office de Logon único (SSO) com ASP.NET Use a API getAccessToken em Office.js para dar ao suplemento acesso aos dados do Microsoft Graph. Este exemplo é criado no ASP.NET.
Suplemento Office dee Logon único (SSO) com Node.js Use a API getAccessToken em Office.js para dar ao suplemento acesso aos dados do Microsoft Graph. Este exemplo é construído em Node.js.

Office

Nome Descrição
Salvar configurações personalizadas no suplemento do Office Salve configurações personalizadas dentro de um Suplemento do Office. O suplemento armazena dados como pares de valor-chave, usando a API JavaScript para saco de propriedades do Office, cookies de navegador, armazenamento da Web (localStorage e sessionStorage) ou armazenando os dados em um div oculto no documento.

Tempo de execução compartilhado

Nome Descrição
Compartilhe dados globais com um tempo de execução compartilhado Configure um projeto básico que usa o tempo de execução compartilhado para executar código para botões da faixa de opções, painel de tarefas e funções personalizadas em um único tempo de execução do navegador.
Gerencie a faixa de opções e a interface do usuário do painel de tarefas e execute o código no documento aberto Crie os botões contextuais da faixa de opções que são ativados com base no estado do seu suplemento.

Amostras adicionais

Nome Descrição
Use uma biblioteca compartilhada para migrar seu suplemento do Visual Studio Tools para Office para um suplemento da web do Office Fornece uma estratégia para reutilização de código ao migrar de suplementos do VSTO para suplementos do Office.
Integre uma função do Azure à sua função personalizada do Excel Integre funções do Azure com funções personalizadas para mover para a nuvem ou integrar serviços adicionais.
Amostras de código DPI dinâmico Uma coleção de amostras para lidar com alterações de DPI em suplementos COM, VSTO e Office.

Próximos passos

Junte-se ao Programa de Desenvolvedores do Microsoft 365 para obter recursos e informações para ajudá-lo a criar soluções para a plataforma Microsoft 365, incluindo recomendações personalizadas para suas áreas de interesse.

Você também pode se qualificar para uma assinatura de desenvolvedor gratuita que é renovável por 90 dias e vem configurada com dados de exemplo; para obter detalhes, confira as perguntas frequentes.