Guia de scripting do ACL versão 14.1

Comando DELETE

Exclui um item de projeto do Analytics, um campo de um layout da tabela, uma variável, uma ou mais entradas de histórico de tabela, uma relação entre tabelas ou um arquivo em uma pasta do Windows. Além disso, remove uma coluna de uma exibição.

Propósito

Sintaxe

Para excluir um item de projeto do Analytics

DELETE tipo_item nome_item <OK>

Para excluir um campo de um layout da tabela

DELETE nome_campo <OK>

Para remover uma coluna em uma exibição

DELETE COLUMN nome_exibiçao nome_campo <ALL> <OK>

Para excluir uma variável ou todas as variáveis

DELETE {nome_variável|ALL} <OK>

Para excluir o histórico da tabela atual do Analytics

DELETE HISTORY <manter_entradas_histórico> <OK>

Para excluir um relacionamento entre duas tabelas

DELETE RELATION <nome_tabela_filha|nome_relacionamento> <OK>

Para excluir um arquivo

DELETE nome_arquivo <OK>

Para excluir todas as notas de registro e o campo NotaDoRegistro da tabela aberta

DELETE NOTES <OK>
Nome Descrição
tipo_item nome_item

O tipo e o nome do item a excluir.

Especifique um dos tipos de item de a seguir:

  • FOLDER a pasta de projeto especificada e todo o seu conteúdo
  • FORMAT o layout da tabela especificado, todas as suas exibições, e seus índices e relacionamentos associados

    Todos os outros layouts de tabelas da tabela associada são mantidos.

    O arquivo de dados (.fil) associado ao layout da tabela não é excluído a menos que a opção Excluir arquivo de dados com tabela esteja marcada na guia Tabela na caixa de diálogo Opções (Ferramentas > Opções).

    Você também pode usar o comando SET DELETE_FILE {ON|OFF} em um script ou na linha de comando para ativar ou desativar essa opção. Para obter mais informações, consulte Comando SET.

    Cuidado

    Tome cuidado ao ativar a opção Excluir arquivo de dados com tabela. Pode ser um arquivo de dados original, que será excluído junto com o layout da tabela.

    Os arquivos de dados são excluídos imediatamente. Esses arquivos excluídos não são enviados para a lixeira do Windows.

  • REPORT a exibição especificada

    Você não pode excluir uma exibição que está ativa no momento.

  • COLUMN a coluna especificada
  • SCRIPT ou BATCH o script especificado
  • WORKSPACE a área de trabalho especificada
  • INDEX o índice especificado
  • NOTES todas as notas de registro da tabela aberta e o campo NotaDoRegistro do layout da tabela
nome_campo ALL

Excluir um campo

O nome do campo a ser excluído do layout da tabela atual do Analytics.

Você pode excluir um campo de um layout de tabela mesmo se o campo estiver incluído na exibição atual.

Nota

Você não pode excluir um campo ao qual um campo calculado faz referência, a menos que exclua antes o campo calculado.

Remover uma coluna

O nome da coluna a ser removida da exibição especificada.

Nota

Use o nome do campo físico e não o nome de exibição da coluna.

  • ALL incluído remove todas as ocorrências da coluna na exibição
  • ALL omitido remove a primeira (mais à esquerda) ocorrência da coluna na exibição
nome_exibição O nome da exibição de onde a coluna será removida.
nome_variavel | ALL

O nome da variável a excluir. Use ALL para excluir todas as variáveis.

Se você especificar ALL, todas as ocorrências dos seguintes tipos de variáveis serão excluídas do projeto:

  • variáveis do sistema
  • variáveis temporárias definidas pelo usuário
  • variáveis permanentes definidas pelo usuário

Nota

Você não pode excluir uma variável ao qual um campo calculado faz referência, a menos que exclua antes o campo calculado.

HISTORY manter_entradas_histórico

Exclui todas as entradas de histórico da tabela, exceto o número de entradas mais recentes especificado por manter_entradas_histórico.

Omita manter_entradas_histórico para excluir todas as entradas.

RELATION <nome_tabela_filha | nome_relacionamento>

Exclui qualquer relacionamento que não tenha relacionamentos dependentes e que não tenha campos relacionados referenciados na exibição ativa ou no campo calculado ativo.

Use as opções para especificar a relação a ser excluída:

  • nome_tabela_filha use quando o relacionamento não foi nomeado explicitamente (nome padrão quando um relacionamento é criado)
  • nome_relacionamento use quando o relacionamento foi nomeado especificamente quando foi criado. Caso contrário, use nome_tabela_filha

Se você não usar nenhuma das opções, será excluída o último relacionamento definido.

nome_arquivo

O nome de um arquivo físico a ser excluído.

Também é possível especificar um caminho de arquivo absoluto ou relativo para um arquivo que deseje excluir. Se o caminho possuir espaços, coloque-o entre aspas.

OK

opcional

Exclui itens sem apresentar uma caixa de diálogo de confirmação.

Exclusão de um campo de data

Exclua o campo Data do layout da tabela associado à tabela Ar:

OPEN Ar
DELETE Data

Exclusão de várias colunas de uma exibição

Exclua duas colunas da exibição Relatório_AR associada à tabela AR. Especifique OK para ambos os comandos DELETE para que nenhuma solicitação de confirmação seja exibida quando o script for executado:

OPEN Ar
DELETE COLUMN Relatório_AR Data OK
DELETE COLUMN Relatório_AR Data_fatura OK