Criação e leitura de apresentações
PowerPoint (PPTX)powerpoint.open_presentationAbre arquivo .pptx
Abre um arquivo .pptx e guarda a apresentação na variável usada pelos demais comandos. Não precisa do PowerPoint instalado.
Exemplo: Abra C:\Modelos\resultado_mensal.pptx em {presentation}.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Arquivo PowerPoint * | Arquivo | ||
| Salvar resultado na variável * | Variável de saída | presentation |
Resultado: guardado na variável presentation (Objeto).
powerpoint.create_presentationCria nova apresentação
Cria uma apresentação nova, em branco (16:9 ou 4:3) ou a partir de um modelo com o visual da empresa.
Exemplo: Crie {presentation} a partir de modelo_empresa.pptx.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Modelo (opcional) | Arquivo | ||
| Tela larga (16:9) | Sim/Não | Sim | |
| Salvar resultado na variável * | Variável de saída | presentation |
Resultado: guardado na variável presentation (Objeto).
powerpoint.add_slideAdiciona slide com layout
Acrescenta um slide com o layout escolhido, título e tópicos (um por linha), e pode guardar o número do slide criado.
Exemplo: Adicione um slide title_content com o título "Vendas de {mes}" e os destaques do mês.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Apresentação * | Variável | presentation | |
| Layout | Opção | Título e conteúdo | Opções: Slide de título, Título e conteúdo, Cabeçalho de seção, Duas partes de conteúdo, Somente título, Em branco |
| Título | Texto | ||
| Conteúdo (um tópico por linha) | Texto (várias linhas) | ||
| Salvar o número do slide na variável | Variável de saída |
Resultado: guardado na variável escolhida (Número).
powerpoint.add_text_boxInsere texto em um slide
Insere uma caixa de texto num slide (0 = o último), com posição e tamanho em centímetros, fonte e alinhamento.
Exemplo: Escreva "Atualizado em {data}" no canto inferior do último slide.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Apresentação * | Variável | presentation | |
| Slide (0 = o último) | Número | 0 | 1 = primeiro slide; 0 = o último (normalmente o que acabou de ser criado) |
| Texto * | Texto (várias linhas) | ||
| Tamanho da fonte | Número | 18 pt | |
| Negrito | Sim/Não | Não |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Esquerda | Número | 2 cm | |
| Topo | Número | 2 cm | |
| Largura | Número | 20 cm | |
| Altura | Número | 3 cm | |
| Alinhamento | Opção | Esquerda | Opções: Esquerda, Centro, Direita, Justificado |
powerpoint.add_imageInsere imagem em um slide
Insere uma imagem num slide, na posição e largura informadas em centímetros.
Exemplo: Insira {grafico_png} no slide 2 com 22 cm de largura.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Apresentação * | Variável | presentation | |
| Slide (0 = o último) | Número | 0 | 1 = primeiro slide; 0 = o último (normalmente o que acabou de ser criado) |
| Imagem * | Arquivo |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Esquerda | Número | 2 cm | |
| Topo | Número | 2 cm | |
| Largura (vazio = original) | Número |
powerpoint.add_tableInsere tabela em um slide
Insere uma tabela num slide a partir de uma lista de linhas ou tabela de dados (DataFrame).
Exemplo: Adicione {top10_clientes} como tabela no último slide.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Apresentação * | Variável | presentation | |
| Slide (0 = o último) | Número | 0 | 1 = primeiro slide; 0 = o último (normalmente o que acabou de ser criado) |
| Dados * | Texto | DataFrame, lista de dicionários ou lista de listasEx.: {df} | |
| Primeira linha com o cabeçalho | Sim/Não | Sim |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Esquerda | Número | 2 cm | |
| Topo | Número | 4 cm | |
| Largura | Número | 25 cm |
powerpoint.add_chartInsere gráfico
Cria um gráfico nativo do PowerPoint (colunas, barras, linhas ou pizza) a partir de dados, editável depois no PowerPoint.
Exemplo: Adicione um gráfico de linhas com {vendas_por_mes} e o título "Evolução das vendas".
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Apresentação * | Variável | presentation | |
| Slide (0 = o último) | Número | 0 | 1 = primeiro slide; 0 = o último (normalmente o que acabou de ser criado) |
| Dados * | Texto | Dicionário {categoria: valor}, ou tabela (DataFrame/lista) com as categorias na 1ª coluna e os valores nas demaisEx.: {vendas_por_uf} | |
| Gráfico | Opção | Colunas | Opções: Colunas, Barras, Linhas, Pizza |
| Título | Texto |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Esquerda | Número | 2 cm | |
| Topo | Número | 4 cm | |
| Largura | Número | 20 cm | |
| Altura | Número | 12 cm |
powerpoint.read_slidesLê conteúdo dos slides
Lê o texto de todos os slides (títulos e caixas de texto) como lista, um item por slide.
Exemplo: Leia os slides de {presentation} e confira se algum ainda tem "[PREENCHER]".
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Apresentação * | Variável | presentation | |
| Salvar resultado na variável * | Variável de saída | slides | Lista de {number, title, texts, notes} |
Resultado: guardado na variável slides (Lista).
powerpoint.save_presentationSalva o arquivo
Salva a apresentação no mesmo arquivo ou num novo caminho.
Exemplo: Salve como resultado_{mes}.pptx na pasta compartilhada.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Apresentação * | Variável | presentation | |
| Salvar como (vazio = o mesmo arquivo) | Arquivo |