Definitioner
Avsnittet beskriver endast SiteBase Link och användningen av detta. Information om hur länksyntax skrivs finns här: Databasfrågor & länksyntax
Uppgifter i dokumentlänken sparas i ritningsfilen och pekar ut mot vilken AppServer, databas samt dokument som filen är kopplad.
Dessa uppgifter är synliga i Properties formuläret som kan öppnas från SiteBase Link menyn. Dokumentets id nummer kan ses från fliken SB Info i SiteBase.
Initialt måste det alltid finnas en dokumentlänk som håller samman ritningen med en dokumentpost i SiteBase. När denna är uppsatt kan ritningsblock länkas direkt mot objekt i databasen.
För ritningar som flödesscheman sker länkningen av block direkt mot ett objekt i databasen, dvs. varje block har sin egen objektkoppling.
Den kopplingen skapas när block sätts in på ritningen och därefter pekas ut i SiteBase.
På exempelvis automationsritningar som skapas via färdiga typritningar sker länkningen automatiskt när ritningen genereras. Dessa kopplingar går via dokumentkopplingen och sedan vidare till det ägande objektet. Därefter kan den gå vidare till exempelvis apparater, kablar och anslutna plintar.
Block som ska kopplas kräver en motsvarande symboldefinition i SiteBase. I denna kan varje blockattribut definieras till att hämta önskad data från SiteBase.
Symboldefinitionerna är grupperade i symbolgrupper ofta indelade efter disciplin.
Nya symboldefinitioner läggs med fördel till via Edit Symbol i SiteBase Link från ritningen, därmed fås då också blockets alla attribut automatiskt.
OBS! Tänk på att en ändring av en symboldefinition kan slå igenom på alla ritningar som använder den symbolen. Detta sker om man på ritningen kör en "Update", då kommer ritningsblocken att uppdateras efter länkarna som är uppsatta i symboldefinitionen.
Symbol Symbolens blocknamn, detta måste vara unikt inom ritningarna.
Symbolgrupp Symboler bör grupperas under symbolgrupper för enklare hantering mellan olika discipliner. Symbolgrupper som inleds med SBS tillhör SiteSymbol, undvik att lägga till symboler i dessa utan skapa istället egna grupper.
Disciplin, Kategori & Klass Disciplin, kategori och klass styr hantering och val av objekt, detta anges om möjligt. Det innebär att när man sedan använder "Select Object" så kommer urvalslistan att placera sig på fördefinierad Disciplin/kategori/Klass.
Dokumentsymbol Kryssas i för symboler kopplade direkt mot dokumentet, dvs. ritningshuvud och revisionsblock.
Exclude compare Markeras rutan kommer blocket inte tas med när en jämförelse görs mot en annan arkivversion.
Nyckelattribut, Nyckelfält Ett nyckelattribut kan användas för att automatiskt matcha ett objekt i SiteBase. Vanligtvis attributet för blockets posnummer som matchas mot SiteBase fält för posnr (POSP)
Attribut & länklista Alla attribut läggs automatiskt upp om symbolen definieras från SiteBase Link, komplettera med länksyntax för de attribut som ska länkas. Ska attributet inte användas lämnas länkfältet tomt.
Vill man fylla i en statisk text ska denna omgärdas av " " tecken. Information om hur länksyntax skrivs finns här: Databasfrågor & länksyntax
Dessa används främst på typritningar för automation och sällan på flödesscheman. Länksyntax kan komma från symboldefinitionen men också från s.k. lokala referenser. Finns en lokal referens kommer den att komplettera eller ersätta uppgifterna som finns i symboldefinitionen. Behovet av dessa finns t.ex. när en kabelsymbol ska kunna användas mot alla olika kablar som ingår i en instrumentkrets. På dessa finns då en lokalreferens som pekar ut exempelvis sorteringsordningen på en specifik kabel, t.ex matningskabel, givarkabel, luftkabel, etc.
Block och attribut samt attributvärde för den valda referensen.
På ett direktlänkat objekt (t.ex. flödesscheman) står normalt objektets ID nr i fältet. På typritningar utgår man istället oftast från dokumentet och vidare till dess ägande objektet och sen vidare ner i strukturen tills man når önskad data. Detta fält användas då för att fylla i en så kallad relationsvandring. Efter en generering kommer objektets ID nr att fyllas in i början på fältet med ett avslutande ”|” skiljetecken.
Det inledande ID nr i fältet inkl. skiljetecknet ”|” kan tas bort utan problem när man håller på att testa länkarna, men kommer att fyllas i efter varje generering.
Visar symboldefinitionens syntax, är inget angivet i fältet "Lokal referens" så kommer detta att gälla.
Ersätter värdet i som står i fältet "Symbol referens" Detta gäller per attribut i symbolen och bygger på frågan som står i Link/ID fältet. Innehållet i "Link/ID" och "Lokal referens" sätts samman och den kompletta frågan från exemplet på blir då: §OBJLOC{210}CHETER{@1}:MARK
Saknas länkade uppgifter som ska visas på ritningen eller om själva objektet i SiteBase saknas lämnas dessa uppgifter tomma och därmed inte synliga. Det kan vara opraktiskt då de lätt ”försvinner” i ritningen, därför finns två variabler som kan sättas och då anger alternativa tecken.
Dessa kan sättas som systemegenskaper på dokumentet eller dokumentklassen, det finns även en övergripande inställning som kan anges på AppServern. !1010026 SYMBOL_VALUE_NULL_STRING !1010027 SYMBOL_REF_NULL_STRING
Den första anger ett tecken som ska fyllas i om värdet är tomt (null). Den andra sätter ett tecken där själva databasposten saknas.