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.
![Document image Document image](https://archbee-doc-uploads.s3.amazonaws.com/yePEKm1oq9OQdn0laEcyX/9OQEXdNHGZs96WeVX7G9T_documentlink_example.png)
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.
ï»ż
![Document image Document image](https://archbee-doc-uploads.s3.amazonaws.com/yePEKm1oq9OQdn0laEcyX/76qm2p7ME1fcUdxjedpQ1_symbol_definition.png)
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.
![Document image Document image](https://archbee-doc-uploads.s3.amazonaws.com/yePEKm1oq9OQdn0laEcyX/ucOn5wZMiDR6lzaKcrgpR_editreference.png)
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.
Â