Heeft u ooit geprobeerd een tabel of kolom in Directus te hernoemen, dan kent u de pijn: Directus behandelt hernoemen als een structurele wijziging. Relaties, rechten, automatiseringen en uw hele applicatie kunnen in één klap breken. Jarenlang was dit een van de meestgevraagde functies in de Directus-community — zonder ingebouwde oplossing en zonder betrouwbare extensie.
Wij liepen bij vrijwel elk klantproject tegen precies dit probleem aan. Daarom bouwden wij een oplossing en publiceerden die gratis als open source, voor iedereen.
Het probleem: Directus kent geen veilig hernoemen
Hernoemt u een collectie of veld in Directus, dan maakt het systeem een nieuwe tabel of kolom aan en laat het de oude staan. Al uw refererende sleutels, eigen API-endpoints, weergave-instellingen en afhankelijke functionaliteit raken kapot. Die verwijzingen handmatig herstellen is foutgevoelig en tijdrovend — zeker bij grote databases met tientallen onderling verbonden collecties.
Dit is de Directus Safe Rename-extensie
Onze extensie directus-extension-safe-rename is een gratis open-source-extensie voor Directus waarmee u collecties en velden veilig hernoemt. Zij verwerkt alle interne verwijzingen, relatie-updates en rechtenkoppelingen automatisch.
Wat de extensie doet
De extensie zorgt ervoor dat bij het hernoemen van een collectie of veld:
- alle refererende sleutels naar de nieuwe naam worden bijgewerkt;
- rechten en beleidsregels behouden blijven;
- eigen endpoints en automatiseringen blijven werken;
- bestaande gegevens veilig worden meegenomen, zonder verlies;
- systeemcollecties en kritieke velden worden beschermd tegen onbedoeld hernoemen.
Waarom wij dit bouwden
Wij bouwen oplossingen op maat op basis van Directus voor klanten in heel Europa. Naarmate onze projecten complexer werden, werd het ontbreken van veilig hernoemen een serieus knelpunt. Stelt u zich voor dat u een collectie hernoemt in een productiesysteem waarvan meer dan 50 tabellen afhankelijk zijn — elke verwijzing handmatig bijwerken is niet alleen tijdrovend, het is gevaarlijk.
Wij doorzochten de GitHub-issues van Directus, de communityfora en Discord. Dit was een van de meestgevraagde functies. Daarom besloten wij het goed op te lossen en de oplossing terug te geven aan de community.
Installatie
De extensie installeert zoals elke andere Directus-extensie:
npm install directus-extension-safe-renameHerstart daarna uw Directus-instantie. De extensie verschijnt in de beheeromgeving onder Extensions, en de hernoemfunctie is beschikbaar vanuit de instellingen van collecties en velden.
De volledige installatie-instructies, gebruiksvoorbeelden en schermafbeeldingen staan in de GitHub-repository.
Voor wie is dit?
Voor elke Directus-ontwikkelaar, elk bureau en elk team dat ooit niet durfde een collectie te hernoemen omdat verderop alles zou breken. Beheert u complexe opzetten met veel collecties waarin hernoemen riskant is, dan is deze extensie voor u.
Bijdragen
De extensie valt onder de MIT-licentie en staat open voor bijdragen. Of u nu een ervaren Directus-gebruiker bent of net begint, uw inbreng — bugmeldingen, functieverzoeken of pull requests — maakt het voor iedereen beter.
- GitHub: github.com/contensu/directus-extension-safe-rename
- npm:
directus-extension-safe-rename - Licentie: MIT
Over Contensu
Wij zijn een bureau voor softwareontwikkeling op maat dat CRM-systemen, websites, interne tools en leerplatformen bouwt voor het mkb in heel Europa. Daarnaast bouwen en onderhouden wij open-sourcetools die echte problemen oplossen die wij in ons dagelijks werk tegenkomen.
Heeft u software op maat nodig, neem dan contact op.
Interested in a solution like this?
Tell us about your business needs. We'll scope a custom solution with a fixed price.
Get a free quote →