Databas-frågor (Link syntax)

Det här avsnittet beskriver syntaxen för att extrahera information från SiteBase. Informationen är generisk och kan användas i alla applikationer som stöds, t.ex. Excel, Word och AutoCAD via tillägget SiteBase Link.

Olika applikationer och anpassningar kan ha specialfunktioner och specialsyntax som inte är redovisade här.

En databasfråga är uppbyggd på tre delar där den första delen (START)definierar utgångspunkten för sökningen. Den andra delen (RELATION{FILTER}) bygger på ett eller flera filter för spårning av information. Den tredje och sista delen (VÄRDE) identifierar vilket värde som ska hämtas.

START:§RELATION{FILTER}RELATION{FILTER}:VÄRDE



Startkod

Startkod definierar utgångspunkten för den förfrågade informationen. Start kan ske från dessa tre olika ställen, det ska följas av ett kolon, till exempel D: eller DOC: Tidigare har oftast startkoden skrivits endast med D: eller O: men det rekommenderas att istället använda den kompletta benämningen DOC: eller OBJ:

START:§RELATION{FILTER}:VÄRDE

DOC (D) - Dokument Dokument används som start om det som efterfrågas finns i ett länkat dokument eller om informationen kan spåras från det dokumentet.

Utgår frågan från ett dokument kan startkoden utelämnas, det gäller till exempel uppgifter som ska presenteras i ett rithuvud.

OBJ (O) - Objekt Objekt används som start om det man utgår från är ett dokument, ett exempel är kretsscheman där man utgår från dokumentet för att sedan komma åt det ägande objektet.

Utgår frågan från ett objekt kan startkoden utelämnas.

S - System Systeminformation är information om projektet, exempelvis kunduppgifter osv.



Relationsvandring

Relationer definierar en väg genom databasen i SiteBase till den efterfrågande informationen. Spårningen startas med det objektet som är definierat i Start och spårar informationen via relationer i SiteBase enligt definierad väg. En relationsvandring inleds med tecknet §, relationerna identifieras genom en treställig kod. Komplexa relationsvandringar kan göras genom att placera relationerna direkt efter varandra, varje sådant steg kan dessutom innehålla ett valfritt filter. Den sista relationen/filterkombinationen avslutas med ett kolon (:) START:§RELATION{FILTER}:VÄRDE

Läs mer om relationer Relationer och Relationsdefinitioner .



Värde

Värdedelen av frågan är den enda obligatoriska delen och identifierar den specifika informationen som söks. Det finns många typer av värden som kan hämtas och alla kan ha ett prefix eller ett suffix. Prefixtecken är applikationsspecifika och används för att plocka ut olika typer av data. Suffixtecken används för att dela på värden. START:§RELATION{FILTER}:[PREFIX]VÄRDE[SUFFIX] Läs mer om värden och funktioner här: Värden & funktioner