Dokumentasjon av elektriske anlegg - et nødvendig hjelpemiddel

1. Dokumentasjon av elektriske anlegg - et nødvendig hjelpemiddel Grunnleggende prinsipper og sammenhengen mellom dokumentasjonsnormene NEKs Elsikkerhetskonferanse 28. - 29. oktober

2. Per-Åke Svensson Konsult inom dokumentationsområdet • Tidigare ABB med industriella el- och styr-utrustningar, koncern-standarder för dokumentation och andra grundstandarder, mm • Secretary IEC TC3 Information structures, documentation and graphical symbols pasv Consulting AB pasv@pasv.se NEKs Elsikkerhetskonferanse 28. - 29. oktober

3. Varför dokumentation? • Direktiv • Föreskrifter • Användarkrav • Sökbarhet • Läsbarhet • Tillgänglighet och kvalité • Kostnadseffektiv framställning och användning NEKs Elsikkerhetskonferanse 28. - 29. oktober

4. Föreskriftskrav – Användarkrav Tillverkaren och slutanvändaren bör basera och sin dokumentation, beteckningssystem, mm på gemensamma standarder, för att få en kostnadseffektiv framställning och användning NEKs Elsikkerhetskonferanse 28. - 29. oktober

5. Produkter och anläggningar Är det skillnad på dokument för produkter och dokument för anläggningar? Påverkande faktorer: Konstruktionsprocess? Användningsområde? Mekanisk – Elektrisk konstruktion? Direktiv och standarder? …..? NEKs Elsikkerhetskonferanse 28. - 29. oktober

6. Vad är en produkt? En produkt är resultatet av en process I detta sammanhang kan vi begränsa beskrivningen till resultatet av en utvecklings- och tillverkningsprocess, dvs. en fysisk enhet I EMC direktivet definierar man produkter som handelsvaror avsedda att säljas på en öppen marknad. Produkter tillverkas normalt efter en typbeskrivning, dvs. en beskrivning som redovisar processen för att tillverka ett obestämt antal individer av samma typ. NEKs Elsikkerhetskonferanse 28. - 29. oktober

7. Vad är en anläggning? En anläggning är en komplett sammansättning av teknisk utrustning och resurser för att lösa en definierad teknisk uppgift. En anläggning kan innehålla apparater, maskiner, instrument, transportsystem, kontrollutrustning och andra system. I EMC direktivet skiljer man på produkter och fasta installationer. En fast installation (anläggning) byggs som en unik enhet på en specifik plats och är inte avsedd att säljas som en handelsvara. En anläggning beskrivs normalt av en specifik dokumentation som är avsedd endast för denna installation. NEKs Elsikkerhetskonferanse 28. - 29. oktober

8. Vad ska dokumenten innehålla? Produktrelaterade dokument bör beskriva: Hur produkten fungerar Hur produkten ska hanteras och skötas Vilka krav (värden) som produkten uppfyller Hur produkten är sammansatt Produktens användningsområde och hur den inte får användas Anläggningsrelaterade dokument bör beskriva: Hur anläggningen är uppbyggd och vad som ingår Hur produkter och sammansatta system förväntas fungera i anläggningen Hur drift och underhåll ska hanteras NEKs Elsikkerhetskonferanse 28. - 29. oktober

9. Mekanisk och elektrisk konstruktion Är det skillnad på mek. och el. dokument? Vissa dokumenttyper passar bättre för att beskriva elektriska kretsar och andra för att redovisa en fysisk konstruktion, men… …den egentliga skillnaden är nog relaterad till beskrivning av funktion kontra beskrivning av fysisk uppbyggnad Både för anläggningar och produkter kan mek. och el. dokument behövas NEKs Elsikkerhetskonferanse 28. - 29. oktober

10. Beskriva produkter eller funktioner Dokument för fysisk uppbyggnad De mekaniska ritningarna beskriver framförallt hur produkter i anläggningen ser ut och hur de är sammansatta. Den strukturella uppbyggnaden är oftast självklar och kan enkelt redovisas med detaljritningar eller sprängskisser Layout-ritningar kan användas för beskriver placering av komponenter eller större enheter (tex byggnader) på en sammansatt produkt eller i en anläggning Funktionsbeskrivande dokument För att förenkla beskrivningen används symboler och algoritmer. Den strukturella sammansättningen är mycket viktigt och det krävs ofta en strukturbeskrivning NEKs Elsikkerhetskonferanse 28. - 29. oktober

11. Köpa anläggning … en i stål … en i data Kunderna fordrar två anläggningar … NEKs Elsikkerhetskonferanse 28. - 29. oktober

12. Köpa produkt … en i data … en i aluminium Specifikationer, datablad Instruktioner för användning, installation, handhavande, underhåll, skrotning, osv Kunderna fordrar två produkter… NEKs Elsikkerhetskonferanse 28. - 29. oktober

13. Leverans och dokumentation • Dokumentation (”instructions”) är en integrerad del av leveransen av en produkt/anläggning. Den skall understödja en korrekt användning av produkten. [IEC 62079] • Informationsinnehållet skall omfatta alla förväntade uppgifter som kunden behöver utföra. Därför beror innehållet på typen av leverans. NEKs Elsikkerhetskonferanse 28. - 29. oktober

14. Leverans och dokumentation • För en konsumentprodukt (som kräver lite eller inget kontinuerligt underhåll) är kundens dokumentation begränsad till dokumentation för handhavande, men tillverkare och serviceorganisationer har naturligtvis mera omfattande dokumentation av dess uppbyggnad och beteende. • För en anläggning (som kräver kontinuerligt underhåll och skall vidareutvecklas) behöver kunden en mer omfattande del av den uppbyggnadsbeskrivande dokumentationen som tillverkaren tagit fram och också i ett format som medger fortsatt arbete. • …och så alla sorter däremellan … NEKs Elsikkerhetskonferanse 28. - 29. oktober

15. Leverans och dokumentation • I samtliga fall måste en modell - i vid mening - av den verkliga produkten finnas, som kanske också innehåller information om hur den kom till • En modell som skall vara utformad med den teknik som är tillgänglig och adekvat under produktens livstid NEKs Elsikkerhetskonferanse 28. - 29. oktober

16. Leverans och dokumentation ”Modell” av produkten Dokumentation Produkt NEKs Elsikkerhetskonferanse 28. - 29. oktober

17. Vad skall modellen innehålla? Vad är det? Hur skall den användas? Vad har den för egenskaper? Hur skall den hanteras? Hur beter den sig? Hur skall den underhållas? Hur är den uppbyggd? Vem har tillverkat den? Hur tillverkas den? … … och så vidare! Varför ser den ut som den gör? NEKs Elsikkerhetskonferanse 28. - 29. oktober

18. Vad skall modellen innehålla? • Information om objektets egenskaper och beteende • Information om handhavande, användning, underhåll, etc • Information om gränssnitt mot omgivningen • Information om objektets uppbyggnad • Information om system och komponenter i objektet (och deras egenskaper och beteende) • Information om hur objektet utvecklats NEKs Elsikkerhetskonferanse 28. - 29. oktober

19. Hur skall modellen byggas? • Oavsett vilken teknik som används måste modellen kunna kommuniceras. Därför måste den: • organiseras på ett logiskt sätt, • följa överenskomna tolkningsregler • Dokumentationsstandarder innehåller såväl organisations- som tolkningsregler för informationen NEKs Elsikkerhetskonferanse 28. - 29. oktober

20. Hur skall modellen byggas? • IEC och ISO standarder innehåller byggstenar till modeller/dokumentation • Tillsammans bildar de ett sammanhängande system som nu skall beskrivas närmare NEKs Elsikkerhetskonferanse 28. - 29. oktober

21. Hur skall modellen byggas? • Strukturering • Identifiering • Dokumenthantering • Dokumentinnehåll • Symboler • Egenskaper och dataelementtyper • Terminologi och vokabulär NEKs Elsikkerhetskonferanse 28. - 29. oktober

22. Hur skall modellen byggas? • Strukturering • Identifiering • Dokumenthantering • Dokumentinnehåll • Symboler • Egenskaper och dataelementtyper • Terminologi och vokabulär NEKs Elsikkerhetskonferanse 28. - 29. oktober

23. Strukturering … av produkten/anläggningen … av dokumentationen IEC 81346, ISO/TS 16952 IEC 62023, ISO 11005 NEKs Elsikkerhetskonferanse 28. - 29. oktober

24. Vad är strukturering av produkt/anläggning? Att organisera objekten i en produkt eller anläggning på ett sätt som underlättar de aktiviteter som skall utföras under dess hela livstid. Strukturering NEKs Elsikkerhetskonferanse 28. - 29. oktober

25. Strukturering Vad är ett objekt? fysiska enheter, som pumpar, maskiner, motorer, apparater, kopplingsutrustningar, .. tekniska system (funktionella grupperingar) volymer, som våningar och rum i byggnader, utrymmen i skåp NEKs Elsikkerhetskonferanse 28. - 29. oktober

26. Strukturering NEKs Elsikkerhetskonferanse 28. - 29. oktober

27. Strukturering NEKs Elsikkerhetskonferanse 28. - 29. oktober

28. Strukturering NEKs Elsikkerhetskonferanse 28. - 29. oktober

29. Grundprinciper:IEC 81346-1 och -2 Tillämpningar: ISO/TS 16952-1, -10 Dokumentationsstruktur:IEC 62023, ISO 11005 Dokumentklassificering:IEC 61355-1, IEC 61355DB Strukturering av dokumentation IEC 81346-1 och -2 Struktureringsprinciper ISO/TS 16952-10 Kraftverk ISO/TS 16952-1 Tillämpning IEC 62023 Strukturering av Information –Huvuddokument ISO 11005 Huvuddokumet NEKs Elsikkerhetskonferanse 28. - 29. oktober

30. Strukturering av dokumentation • IEC 62023 och ISO 11005 beskriver begreppen huvuddokument och kompletteringsdokument • För ett objekt som skall kunna hanteras fristående skall det finnas ett huvuddokument som fungerar som ingång till all information om objektet NEKs Elsikkerhetskonferanse 28. - 29. oktober

31. Strukturering av dokumentation NEKs Elsikkerhetskonferanse 28. - 29. oktober

32. Strukturering av dokumentation NEKs Elsikkerhetskonferanse 28. - 29. oktober

33. Strukturering av dokumentation NEKs Elsikkerhetskonferanse 28. - 29. oktober

34. Hur skall modellen byggas? • Strukturering • Identifiering • Dokumenthantering • Dokumentinnehåll • Symboler • Egenskaper och dataelementtyper • Terminologi och vokabulär NEKs Elsikkerhetskonferanse 28. - 29. oktober

35. Identifiering … entydigt utpekande i ett definierat sammanhang (domän) IEC 62507 (organisationsdomän) IEC 81346, ISO 6433 (objektdomän) NEKs Elsikkerhetskonferanse 28. - 29. oktober

36. Allmänt: IEC 62507-1 Identifieringsprinciper IEC 62507-2 Applikationsexempel System- och produktdomän:IEC 81346-1 och -2, ISO 6433 Referensbeteckningar och posnummer Tilläggsmärkning:IEC 62491 Kablar Identifiering IEC 62507-1 Identifieringsprinciper ISO/TS 16952-10 Kraftverk ISO/IEC 15459-x Unika identifierare IEC 81346-1 och -2Referensbeteckningar ISO 6433 Posnummer NEKs Elsikkerhetskonferanse 28. - 29. oktober

37. Identifiering NEKs Elsikkerhetskonferanse 28. - 29. oktober

38. Identifiering med referensbeteckning Produktorienterad struktur med beteckningar NEKs Elsikkerhetskonferanse 28. - 29. oktober

39. Hur skall modellen byggas? • Strukturering • Identifiering • Dokumenthantering • Dokumentinnehåll • Symboler • Egenskaper och dataelementtyper • Terminologi och vokabulär NEKs Elsikkerhetskonferanse 28. - 29. oktober

40. Dokumenthantering Metadata ID: … Version: … Dokumentslag: … Titel: … Författare: … … … … … dokumentet hanterat som en ”svart låda” IEC 82045, ISO 11442, ISO7200, (IEC 61355, ISO 29845, …) NEKs Elsikkerhetskonferanse 28. - 29. oktober

41. Varför dokumenthantering? En bra dokumenthantering behövs för att: Skapa ordning och reda bland sina dokument Lättare kunna hitta den information som söks Ge tillgång till rätt information för alla som behöver Kontrollera framtagningsprocessen Förbättra utbytbarhet av (elektronisk) information Förbättra kvalitén på hantering och lagring NEKs Elsikkerhetskonferanse 28. - 29. oktober

42. Dokumenthantering Dokumenthanteringen måste bygga på standard Det finns ofta ett behov av att utbyta information mellan olika system…. … ett gemensamt regelverk är nödvändigt…. … liksom gemensamma definitioner NEKs Elsikkerhetskonferanse 28. - 29. oktober

43. Dokumenthantering I dokumenthanteringen betraktas dokumenten som ”Black boxes” Metadata ID: … Version: … Dokumentslag: … Titel: … Författare: … … • D.v.s. vi behandlar information om dokumenten snarare än den information som dokumenten innehåller • Typen av dokument är viktigare än presentationen • ..men detta innebär inte att innehåll och presentation är ointressant NEKs Elsikkerhetskonferanse 28. - 29. oktober

44. Standarder för dokumenthantering IEC 82045-1 Document management - Principles and methods IEC 82045-2 Document management - Metadata and information models ISO 82045-5 Document management - Application of metadata for the construction and facility management sector Serien 82045 är en grupp standarder som behandlar olika aspekter av dokumenthanteringen IEC 82045-1 och -2 Modell och metadata ISO 82045-5 Application of metadata NEKs Elsikkerhetskonferanse 28. - 29. oktober

45. Standarder för dokumenthantering ISO 11442 - Document managementSpecificerar faser i dokumentations-processen Standarden redovisar även faser i produktutvecklingsprocessen IEC 62023 - Structuring of technical information and documentation - Skapar en länk mellan PDM och DM ISO 7200 - Data fields in title blocks and document headersVisar hur metadata kan appliceras i datafält på ritningar ISO 11442 Dokumenthantering NEKs Elsikkerhetskonferanse 28. - 29. oktober

46. Standarder för dokumenthantering Ritningshuvud i kompakt form Samma datafält finns i båda exemplen Ritningshuvud med extra utrymme för ägare / utgivare NEKs Elsikkerhetskonferanse 28. - 29. oktober ISO 7200

47. Metadata Metadata för dokument är data som beskriver dokumenten och deras hantering Genom att lagra metadata om dokumenten kan ett datorsystem hantera identifikation, klassificering, versioner, status och andra viktiga processer i dokumenthanteringen. Metadata är också viktigt för att klara av att utbyta information (dokument) mellan olika datorsystem som CAD, PDM, ECM samt arkiveringssystem, etc. För utbyte av data är det av största vikt att standardiserade namn och definitioner på metadata används. ISO/IEC ger oss denna möjlighet. NEKs Elsikkerhetskonferanse 28. - 29. oktober

48. Standarder för dokumentslag Dokumenttyp = Dokumentslag(Document type = Document kind) IEC61355-1 Classification and designation of documents for plants, systems and equipmentGruppering av dokument i klasser med koder för dokumentslag (DCC) IEC 61355DB dvs. IEC 61355 i databasform ISO/CD 29845 Document type definitionKommande standard för dokumentyper IEC 61355-1 och –DB Klassificering ISO 29845Dokumenttyper NEKs Elsikkerhetskonferanse 28. - 29. oktober

49. Dokumentslag Dokumentslag - Dokumentklass - Dokumentkod ISO och IEC standarder beskriver ett antal dokumentslag som traditionellt används i olika typer av dokumentation. Namn och beskrivningar på dokumentslagen baseras på dokumentens innehåll men relateras också till användningen av dokumenten. Dokumentslagen är klassificerade och indelade i grupper baserat på användningsområde, presentationsform, etc. Baserat på klassificeringen anges en kod, Document Classification Code (DCC) för varje dokumentslag. IEC redovisar dessa dokumentslag och koder i en databas. NEKs Elsikkerhetskonferanse 28. - 29. oktober

50. IEC 61355 DB Sök dokumenttyper enligt följande: IEC 61355Collection of standardized and established document kinds NEKs Elsikkerhetskonferanse 28. - 29. oktober