Gravar linha

UiPath.MicrosoftOffice365.Activities.Excel.WriteRowConnections

Description

Grave uma linha em um arquivo do Excel selecionado usando uma Linha de Array ou uma Linha de Dados. Você pode mapear campos individuais para colunas de destino usando a opção Campos individuais em Linha de dados.

Escopos

Essa atividade requer os seguintes escopos:

• Sites.ReadWrite.All

Compatibilidade do projeto

Windows | Multiplataforma

Configuração

• Conexão do Microsoft Outlook 365 — A conexão para a conta do Microsoft 365 que será usada na atividade.

• Pasta de trabalho — A pasta de trabalho do Excel que será usada. O método para especificar a pasta a ser recuperada: Seletor de pasta, Inserir ID, Inserir URL.

  • Exemplo de pasta de trabalho — O modelo de pasta de trabalho que será usado. O campo fica visível após clicar em Usar modelo de pasta de trabalho . Navegue pelas pastas do OneDrive e selecione uma pasta de trabalho. No Studio Desktop, a opção está disponível na página Veja mais menu de botões ao lado de Tipo de intervalo. Para saber mais, consulte Trabalho com modelos.

  • Opção Seletor de arquivo/pasta : clique na pasta para navegar pelos arquivos/pastas do OneDrive ou do SharePoint e selecionar uma planilha. Essa opção aceita entrada como IResource.

    • Use o menu do botão Ver mais para usar uma variável ou selecione a opção Recarregar dados da pasta se você tiver modificado suas pastas e precisar recuperar os dados mais recentes.

  • Insira a opção de ID :

    • ID da pasta de trabalho — O ID da pasta de trabalho de interesse. Esse campo é compatível com entrada do tipo String.
    • Endereço do site do SharePoint — O URL do site do SharePoint que contém o arquivo ou pasta. Esse campo aceita entrada do tipo String .Abra seu site do SharePoint em um navegador e copie seu URL, por exemplo, https://yourcompany.sharepoint.com/sites/ProductOfficial.
    • Biblioteca de documentos do SharePoint — A biblioteca de documentos dentro do site do SharePoint indicado que contém o arquivo ou pasta. Esse campo é compatível com entrada de tipo String. Abra a guia Documentos em seu site do SharePoint e copie o URL, por exemplo, https://yourcompany.sharepoint.com/sites/ProductOfficial/Shared%20Documents/Forms/AllItems.aspx.

  • Opção Insira Url:

    • URL da pasta de trabalho — O URL da pasta de trabalho de interesse. Esse campo é compatível com entrada de tipo String. Recupere o URL abrindo o arquivo em um navegador.
• Intervalo - O intervalo a ser escrito. Você pode gravar intervalos personalizados usando a notação A1 completa. Este campo é pré-preenchido com informações recuperadas da pasta de trabalho selecionada ou exemplo de pasta de trabalho. Essa propriedade é compatível com variáveis String e valores formatados de string.

  • Selecione a opção Atualizar intervalos se você tiver modificado suas planilhas e precisar recuperar os dados mais recentes.

  • Selecione a opção Atualizar campos se você tiver modificado sua pasta de trabalho e precisar recuperar os dados mais recentes.

• Como escrever - Especifica como adicionar os dados ao intervalo especificado. As opções disponíveis são:
  • Substituir - Substitui quaisquer dados anteriores que existam. Grava a linha no lugar exato. Se for selecionado um intervalo com várias células, grava na primeira linha.
    • Posição da linha - A posição de índice da linha onde a atividade substitui a linha. O índice pode ser usado iterando nas linhas do intervalo usando Read Range ou For Each Row. Inicia a partir de 0.
  • Acrescentar - Indica como adicionar os dados ao intervalo indicado. Grava os dados na primeira linha vazia encontrada e insere uma nova linha deslocando células para baixo.
    Observação: atualmente, a anexação de dados não é compatível com intervalos nomeados.
  • Inserir - Insere uma linha e grava na linha recém-inserida.
    Observação: se Tem cabeçalhos for definido como True, a primeira linha no intervalo será considerada o cabeçalho e a posição 0 da linha será a próxima linha.
• O que escrever - Os dados em uma TabelaDeDados que serão gravados em uma pasta de trabalho. As opções disponíveis são:
  • Linha de dados - Use uma Linha de dados como dados de entrada.
  • Linha de matriz - Use uma Linha de matriz como dados de entrada.
  • Campos individuais - Mapear dados para campos de destino individuais. Usando campos individuais, você grava diretamente nas colunas especificadas. As colunas que não são especificadas não são limpas e mantêm os dados antigos.
• Linha de dados a gravar / Linha de array a ser gravada — Os dados em uma LinhaDeDados ou LinhaDaMatriz que serão gravados na pasta de trabalho.
• Tem cabeçalhos - Se estiver selecionado, os cabeçalhos das colunas são gerados pela leitura do cabeçalho do intervalo. Essa propriedade aceita valores booleanos. A opção padrão é Off. Esse campo é exibido se você selecionar a opção O que escrever - Campos individuais .
• Gerenciar colunas individuais de destino — selecione campos adicionais para o objeto atual. Esse campo é exibido se você selecionar a opção O que escrever - Campos individuais .

Observação:

Chamadas de API em lote são compatíveis com essa atividade quando usadas em: For Each Email, For Each Row in Workbook, For Each File or Folder.

Limitação conhecida

Ocorrerá um erro se você usar Gravar linha/Gravar intervalo com a opção Acrescentar e o intervalo de destino for uma planilha que contém uma tabela vazia no início (sem outros dados). A atividade tenta inserir uma linha na planilha, no início da tabela, mas a API do Graph retorna um erro.

Exemplo

Consulte também:

• Excel atividades on-line
• Gravar coluna
• Write Cell
• Add Sheet