Delete Range

UiPath.MicrosoftOffice365.Activities.Excel.DeleteRange

Description

Usa a API Microsoft Graph Clear range (quando Shift é None) ou Delete range (quando Shift é Up ou Left) para excluir um intervalo de dados de célula (Range) de uma planilha de pasta de trabalho (Workbook) especificada (SheetName).

Escopos

Essa atividade requer os seguintes escopos:

• Arquivos.ReadWrite

OU

• Arquivos.ReadWrite.All

OU

• Sites.ReadWrite.All

Compatibilidade do projeto

Windows - Legado | Windows

Configuração

Propriedades

Comum

• NomeDeExibição — o nome de exibição da atividade. Essa propriedade é compatível com variáveis String e valores formatados de string.

Entrada

• Intervalo - O intervalo a ser excluído. Insira seu intervalo na notação de estilo A1. Por exemplo, se você tiver dados nas células A1:B5 e inserir "A1:B3", os dados nas células A1:B3 serão excluídos e os dados nas células A4:B5 permanecerão e serão deslocados de acordo com o valor de Deslocamento especificado. Esta propriedade oferece suporte a variáveis String e valores formatados em string.
• Nome da planilha - O nome da planilha a partir da qual os dados são excluídos.Essa propriedade é compatível com variáveis String e valores formatados de string.

• Shift - Indica como as células circundantes respondem quando o intervalo é excluído. Use a lista suspensa para selecionar uma das três opções:

  • Nenhum - Padrão. As células fora do intervalo especificado permanecem inalteradas e o intervalo de células excluído é deixado em branco.
  • Up - As células abaixo do intervalo são movidas para cima para preencher o intervalo de células excluído.
  • Esquerda - As células à direita do intervalo são movidas para a esquerda para preencher o intervalo de células excluído.
• Pasta de trabalho — a DriveItem do documento a ser modificada. Esse objeto pode ser recuperado usando a atividade Find Files And Folders . Use a variável de propriedade de saída das atividades Find Files and Folders (Primeiro ou Resultados) ou Create Workbook (Pasta detrabalho). Quando estiver usando a propriedade de saída Resultados da atividade Find Files and Folders , certifique-se de especificar qual item na matriz você deseja usar (por exemplo, myWorkbooks(0)).

Diversos

• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose. Este campo aceita valores booleanos.

Como funciona

As etapas a seguir e o diagrama de sequência de mensagens são um exemplo de como a atividade funciona desde o tempo de design (ou seja, as dependências da atividade e as propriedades de entrada/saída) até o tempo de execução.

1. Conclua as etapas.
2. Adicione a atividade Microsoft Office 365 Scope ao seu projeto.
3. Adicione uma atividade ou execute um processo externo que gere um objeto DriveItem (por exemplo, Find Files And Folders, Create Workbooke Copy Item).
4. Adicione a atividade Delete Range dentro da atividade Microsoft Office 365 Scope.
5. Insira valores para as propriedades de entrada.

6. Execute a atividade.

   • Seus valores de propriedade de entrada são enviados para a API ClearRange ou DeleteRange .