Ressourcer og arbejdsområde

Det centrale samlingssted for brugerdatafiler kaldes et arbejdsområde. Platformens arbejdsbænk kan betragtes som et værktøj, der giver brugeren mulighed for at navigere i og manipulere med arbejdsområdet. Ressource-plugin'en stiller API'er til rådighed for ressourceoprettelse, -navigation og -manipulation i et arbejdsområde. Arbejdsbænken bruger disse API'er til at stille denne funktionalitet til rådighed for brugeren. Plugin'en kan også benytte disse API'er.

For en ressourcebaseret plugin er der ét arbejdsområde, og det er altid åbent, sålænge plugin'en udføres. Arbejdsområdet åbnes automatisk, når ressource-plugin'en aktiveres, og lukkes igen, når platformen lukkes. Hvis plugin'en kræver ressource-plugin'en, startes ressource-plugin'en inden plugin'en, og arbejdsområdet vil være til rådighed for dig.

Arbejdsområdet indeholder en samling ressourcer. Fra brugerens synspunkt er der tre forskellige typer ressourcer: projekter, foldere og filer. Et projekt er en samling filer og foldere. Det er et opbevaringssted til brug for organisering af andre ressourcer, der relaterer til et bestemt område. Filer og foldere er lige som filer og foldere i filsystemet. En folder indeholder andre foldere og filer. En fil indeholder en vilkårlig bytesekvens. En fils indhold fortolkes ikke af platformen.

Et arbejdsområdes ressourcer organiseres i en træstruktur med projekter øverst og foldere og filer nedenunder. En særlig ressource, arbejdsområdets rodressource, fungerer som roden til ressourcetræstrukturen. Arbejdsområderoden oprettes internt, når et arbejdsområde oprettes, og det eksisterer lige så længe som arbejdsområdet.

Et arbejdsområde kan have et vilkårligt antal projekter, som kan lagres på hver sin placering i et filsystem.

Der skelnes altid mellem store og små bogstaver i arbejdsområdets ressourcenavneområde, og denne forskel bevares. Arbejdsområdet tillader, at der findes flere sideordnede ressourcer samtidigt, hvis navne kun adskiller sig ved forskellen på store og små bogstaver. Arbejdsområdet har ingen betingelser mht. gyldige tegn i ressourcenavne, længden på ressourcenavne eller ressourcestørrelsen på disken. Hvis du gemmer ressourcer i et filsystem, der ikke skelner mellem store og små bogstaver eller som har betingelser for ressourcenavne, vil disse betingelser naturligvis vise sig, hvis du forsøger at oprette eller ændre ressourcer.

Et eksempel på en ressourcetræstruktur

Træstrukturen nedenfor (repræsenteret på arbejdsbænkens navigatoroversigt) viser et typisk ressourcehierarki i et arbejdsområde. Træstrukturens (implicitte) rod er arbejdsområdets rod. Projekterne er umiddelbart underordnet arbejdsområdets rod. Hver node (bortset fra roden) er en af de tre typer ressourcer, og hver har et navn, der er forskelligt fra nodens sideordnede elementer.

Navigatoroversigt med eksempel på arbejdsområde

Ressourcenavne er vilkårlige streng (næsten - de skal være gyldige filnavne). Selve platformen dikterer ikke ressourcenavne, og den angiver heller ikke navne med særlig betydning. (Der er dog en undtagelse - et projekt kan ikke hedde ".metadata", da dette navne benyttes internt.)

Projekter indeholder filer og foldere, men ikke andre projekter. Projekter og foldere er lige som biblioteker i et filsystem. Når du sletter et projekt, bliver du spurgt, om du vil slette alle filer og folder, som det indeholder. Når du sletter en folder fra et projekt, slettes folderen og alle de underordnede elementer. At slette en fil svarer til at slette en fil i filsystemet.