Documentation
KILL
usage
<KILL [throw-exception="true"]>
<element ID="number"/>
</KILL>
parameters
ID: unique identifier of the element
throw-exception : if the command fails throws a PHP exception instead of returning a XML error message
returns
<MESSAGE/>
Dans Nectil, il n'est pas possible, avec la commande DELETE, d'effacer un élément si d'autres éléments ont des dépendances vers lui.
Si l'on veut "oublier" ces dépendances et réellement détruire l'élément, on va utiliser la commande KILL.
Comme pour la commande DELETE, pour détruire un élément avec KILL, il est nécessaire de connaître :
- son module (contact, media, group, etc)
- son ID (identifiant unique)
Ex: <KILL><MEDIA ID="34"/></KILL>
Destruction d'après recherche
comme pour la commande DELETE, il est possible d'utiliser la commande KILL avec une recherche sur la dB.
Pour cela, au lieu de spécifier l'ID de l'élément en attribut, vous allez placer à l'intérieur du noeud donnant le module, un noeud WHERE dans lequel vous indiquerez les critères de la recherche.
Ex:
<KILL>
<MEDIA>
<WHERE>
<DESCRIPTIONS>Théâtre</DESCRIPTIONS>
</WHERE>
</MEDIA>
</KILL>
Cette requête va détruire tous les médias comprenant le mot théâtre dans leurs descriptions.
Les critères de recherche utilisent la même syntaxe que pour une commande SEARCH.
NB: Il est vivement conseillé de tester la recherche d'effectuer la destruction proprement dite, pour être sûr que votre recherche est correcte.