Commande DELETE

Supprime un élément de projet Analytics, un champ d'un format de table, une variable, une ou plusieurs entrées d'historique de la table, une relation entre des tables ou un fichier dans un dossier Windows. Supprime aussi une colonne d'une vue.

Syntaxe

Objectif

Syntaxe

Pour supprimer un élément de projet Analytics

DELETE type_élément nom_élément <OK>

Pour supprimer un champ d'un format de table

DELETE nom_champ <OK>

Pour supprimer une colonne d'une vue

DELETE COLUMN nom_vue nom_champ <ALL> <OK>

Pour supprimer une ou toutes les variables

DELETE {nom_variable|ALL} <OK>

Pour supprimer l'historique de la table Analytics active

DELETE HISTORY <conserver_entrées_historique> <OK>

Pour supprimer une relation entre deux tables

DELETE RELATION <nom_table_enfant|nom_relation> <OK>

Pour supprimer un fichier

DELETE nom_fichier <OK>

Pour supprimer toutes les notes d'enregistrement, et le champ NoteEnregistrement généré automatiquement, de la table ouverte

DELETE NOTES <OK>

Paramètres

Nom Description
type_élément nom_élément

Type et nom de l'élément à supprimer.

Indiquez l'un des types d'élément suivants :

  • FOLDER le dossier de projet indiqué et l'intégralité de son contenu
  • FORMAT le format de table spécifiée, l'ensemble de ses vues et ses index et relations associés

    Tous les autres formats de table concernant la table associée sont conservés.

    Le fichier de données (.fil) associé au format de table n'est pas supprimé si l'option Supprimer le fichier de données avec la table n'est pas sélectionnée dans l'onglet Table de la boîte de dialogue Options (Outils >Options).

    Vous pouvez également utiliser la commande SET DELETE_FILE {ON|OFF} dans un script ou dans la ligne de commande pour activer ou désactiver cette option. Pour plus d'informations, consultez la section Commande SET.

    Attention

    Redoublez de prudence lorsque vous activez l'option Supprimer le fichier de données avec la table. Il se peut que ce soit le fichier de données d'origine qui soit supprimé avec le format de table !

    Les fichiers de données sont supprimés de manière définitive. Ils ne sont pas envoyés dans la Corbeille de Windows.

  • REPORT la vue spécifiée

    Vous ne pouvez pas supprimer une vue si elle est active.

  • COLUMN la colonne spécifiée
  • SCRIPT (ou BATCH) le script indiqué
  • WORKSPACE l'environnement de travail spécifié
  • INDEX l'index spécifié
  • NOTES toutes les notes d'enregistrement de la table ouverte, et le champ NoteEnregistrement du format de table
nom_champ ALL

Supprimer un champ

Nom du champ à supprimer dans le format de table Analytics actif.

Vous pouvez supprimer un champ d'un format de table, même si le champ est inclus dans la vue actuelle.

Remarque

Vous ne pouvez pas supprimer un champ référencé par un champ calculé, sauf si vous supprimez d'abord le champ calculé.

Supprimer une colonne

Nom de la colonne qui doit être supprimée dans la vue indiquée.

Remarque

Utilisez le nom de champ physique, pas le nom d'affichage de la colonne.

  • ALL inclus supprime toutes les occurrences de la colonne dans la vue
  • ALL ignoré supprimer la première (tout à gauche) occurrence de la colonne de la vue
nom_vue Nom de la vue dans laquelle une colonne doit être supprimée.
nom_variable |ALL

Nom de la variable à supprimer. Utilisez ALL pour supprimer toutes les variables.

Si vous indiquez ALL, toutes les occurrences des types de variables suivants sont supprimées du projet :

  • variables système
  • variables temporaires définies par l'utilisateur
  • variables permanentes définies par l'utilisateur

Remarque

Vous ne pouvez pas supprimer une variable référencée par un champ calculé, sauf si vous supprimez d'abord le champ calculé.

HISTORY conserver_entrées_historique

Supprime toutes les entrées d'historique de la table, à l'exception du nombre d'entrées les plus récentes indiqué par conserver_entrées_historique.

Omettez conserver_entrées_historique pour supprimer toutes les entrées.

RELATION nom_table_enfant | nom_relation>

Supprime toute relation qui n'a aucune relation associée ni aucun champ associé référencé dans la vue active ou dans un champ calculé actif.

Utilisez les options pour indiquer quelle relation supprimer :

  • nom_table_enfant à utiliser si la relation n'a pas de nom précis (nom par défaut lorsqu'une relation est créée)
  • nom_relation à utilise si la relation a été spécifiquement nommée lors de sa création. Sinon, utilisez nom_table_enfant

Si vous n'utilisez pas l'une de ces options, la dernière relation ayant été définie est supprimée.

nom_fichier

Nom d'un champ physique à supprimer.

Vous pouvez indiquer un chemin absolu ou relatif vers un fichier que vous souhaitez supprimer. Si le chemin d'accès contient des espaces, placez-le entre guillemets doubles.

OK

optionnel

Supprime les éléments sans présenter de boîte de dialogue de confirmation.

Exemples

Suppression d'un champ date

Vous supprimez le champ Date du format de table associé à la table Ar :

OPEN Comptes_clients
DELETE Date

Suppression de plusieurs colonnes d'une vue

Vous supprimez deux colonnes de la vue Rapport_AR associée à la table Ar. Vous spécifiez OK pour les deux commandes DELETE afin de ne pas afficher d'invite de confirmation lors de l'exécution du script :

OPEN Comptes_clients
DELETE COLUMN Rapport_AR Date OK
DELETE COLUMN Rapport_AR Date_Facture OK