Gravar linha

UiPath.MicrosoftOffice365.Activities.Excel.WriteRowConnections

Description

Escreva 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 que 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 Ver mais menu de botão ao lado de Tipo de intervalo. Para saber mais, consulte Trabalhar com modelos.

  • Opção de seletor 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 a opçã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 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 - A URL do site do SharePoint que contém o arquivo ou pasta. Este campo suporta a entrada de tipo String 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 do 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.

  • Insira a opção URL :

    • URL da pasta de trabalho — O URL da pasta de trabalho de interesse. Esse campo é compatível com entrada do tipo String . Recupere o URL abrindo o arquivo em um navegador.

• Intervalo - O intervalo a ser escrito. Grave 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 para iterar em cada linha ou nas linhas do intervalo usando o intervalo de leitura. 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:

  No momento, 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 array — use uma Linha de array 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 ser gravada / 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. Esta propriedade aceita valores booleanos. A opção padrão é Desligado. Esse campo será 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 será exibido se você selecionar a opção O que escrever - Campos individuais .

Observação:

O lote de chamadas de API é compatível com essa atividade quando usado dentro de: For Each Email, For Each Row in Workbook, For Each File or Folder.

Limitação conhecida

Ocorrerá um erro se você usar Write Row/Write Range 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