Productbeschrijving Inhoud: Programmeerinterface versie 2.5 Stand: 09/2015

Transcriptie

1

2 Copyright 2015 EPLAN Software & Service GmbH & Co. KG EPLAN Software & Service GmbH & Co. KG is niet aansprakelijk voor technische of druktechnische fouten of onvolkomenheden in deze technische informatie en is ook niet verantwoordelijk voor schade die direct of indirect terug te voeren is op de levering, de kwaliteit en het gebruik van dit materiaal. Dit document bevat eigendomsrechtelijk beschermde informatie die valt onder het auteursrecht. Alle rechten zijn beschermd. Zonder voorafgaande schriftelijke toestemming van EPLAN Software & Service GmbH & Co. KG mag dit document noch geheel noch gedeeltelijk worden gekopieerd of vermenigvuldigd. De software die in dit document wordt beschreven, valt onder een licentiecontract. Gebruik en vermenigvuldiging van de software is alleen toegestaan in het kader van dit contract. RITTAL is een geregistreerd handelsmerk van Rittal GmbH & Co. KG. EPLAN, EPLAN Electric P8, EPLAN Fluid, EPLAN Preplanning, EPLAN PPE, EPLAN Pro Panel en EPLAN Harness prod zijn geregistreerde handelsmerken van EPLAN Software & Service GmbH & Co. KG. Windows 7, Windows 8, Windows 8.1, Windows Server 2008 R2, Windows Server 2012, Microsoft Windows, Microsoft Excel, Microsoft Access en Notepad zijn geregistreerde handelsmerken van Microsoft Corporation. PC WORX, CLIP PROJECT en INTERBUS zijn geregistreerde handelsmerken van Phoenix Contact GmbH & Co. AutoCAD en AutoCAD Inventor zijn geregistreerde handelsmerken van Autodesk, Inc. STEP 7, SIMATIC en SIMATIC HW Konfig zijn geregistreerde handelsmerken van Siemens AG. InstallShield is een geregistreerd handelsmerk van InstallShield, Inc. Adobe Reader en Adobe Acrobat zijn geregistreerde handelsmerken van Adobe Systems Inc. TwinCAT is een geregistreerd handelsmerk van Beckhoff Automation GmbH. Unity Pro is een geregistreerd handelsmerk van Schneider Electric. RSLogix 5000 en RSLogix Architect zijn geregistreerde handelsmerken van Rockwell Automation. Alle overige genoemde product- en handelsnamen zijn handelsmerken of geregistreerde handelsmerken van de desbetreffende eigenaren. EPLAN gebruikt de Open-Source-Software 7-Zip (7za.dll), Copyright by Igor Pavlov. De broncode van 7-Zip valt onder de GNU Lesser General Public License (LGPL). De broncode van 7-Zip en meer informatie over deze licentie vindt u op EPLAN gebruikt de Open-Source-Software Open CASCADE, Copyright by Open CASCADE S.A.S. De broncode van Open CASCADE valt onder de Open CASCADE Technology Public License. De broncode van Open CASCADE en meer informatie over deze licentie vindt u op EPLAN biedt een importfunctie, die gebruik maakt van ecl@ss. Voor het gebruik van de ecl@ssstandaard is een licentie nodig. U kunt deze bestellen en registeren in het download portal:\r\nhttp:// 2

3 Inhoudsopgave Inleiding 5 Wij ontwikkelen oplossingen voor meer efficiëntie 5 EPLAN platform uw sleutel tot succes 6 EPLAN API 9 EPLAN API voordelen 9 Functionele prestatieverbetering 9 Snellere taakgerichte processen 10 EPLAN API techniek 10 Uitbreidingsmodulen 11 Zelfstandige programma's 11 EPLAN API frameworks 12 EPLAN API objectmodel 12 EPLAN API basisfunctionaliteiten 13 Geavanceerde EPLAN API functionaliteiten 13 EPLAN API ontwikkelomgeving 14 Functieoverzicht 15 EPLAN API objectmodel 15 EPLAN API basisfunctionaliteiten 17 Geavanceerde EPLAN API functionaliteiten 18 3

4 4

5 Inleiding EPLAN Software & Service ontwikkelt CAE-oplossingen en adviseert bedrijven bij het optimaliseren van hun engineeringsprocessen. Dankzij gestandaardiseerde processen, automatische procedures en uniforme workflows kunnen klanten bij het productontwikkelingsproces nog efficiënter werken. EPLAN levert op maat gesneden concepten voor de invoering en inrichting van het systeem, alsmede perfecte integratie in de IT- / PLM-systeemomgeving gebaseerd op standaard engineeringsoplossingen. Daarnaast omvat het serviceprogramma customizing, consulting en training. De ontwikkeling van individuele en gestandaardiseerde ERP- en PDM-interfaces voor de PLM-integratie staat garant voor uniformiteit van gegevens bij de productontwikkeling. Consequente klantgerichtheid, wereldwijde support en innovatieve ontwikkelings- en interfacecompetentie zijn onze succesfactoren. EPLAN maakt deel uit van Rittal Software Systems en daarmee van de Friedhelm Loh Group en staat hierdoor voor continuïteit en investeringszekerheid: Geoptimaliseerde engineeringsprocessen: dat is onze belofte klantspecifiek en praktijkgericht. Wij ontwikkelen oplossingen voor meer efficiëntie Globaliserende markten, stijgende kosten en tijdsdruk alsmede toenemende concurrentie dwingen bedrijven om continu efficiënter te werken. Alleen zo kunt u het hoofd bieden aan de uitdagingen van de branche en uw ambitieuze doelstellingen zoals innovatieleiderschap, wereldwijde groei en operationele topprestaties bereiken. Op de weg daarheen liggen met name in de engineering vaak onbenutte potenties die effect hebben op het complete productontwikkelingsproces. Onder het motto "EPLAN efficient engineering" ontwikkelt de onderneming al meer dan 30 jaar praktijkgerichte engineeringsoplossingen en individuele concepten voor het optimaliseren van engineeringsprocessen bij klanten. EPLAN adviseert bedrijven competent, kundig en effectief met als doel processen perfect op elkaar af te stemmen, doorlooptijden van projecten te reduceren en engineeringskosten te verlagen. Meer dan klanten van 5

6 verschillende grootte en in de meest uiteenlopende branches vertrouwen ondertussen dagelijks op EPLAN en zijn producten om hun concurrentiepositie en de toekomstbestendigheid op lange termijn veilig te stellen. Zorg ook voor een beslissende voorsprong ten opzichte van uw concurrenten en verhoog permanent de efficiëntie van de engineeringsprocessen binnen uw bedrijf! EPLAN platform uw sleutel tot succes Het EPLAN platform verbindt expertsystemen voor verschillende disciplines zoals elektro-, fluid- en M&R-engineering alsmede de schakelkastproductie. Zo worden alle toepassingen voorzien van dezelfde basisgegevens en bewerkingsfuncties, waardoor een hogere projectkwaliteit en een mechatronische werkwijze worden ondersteund. EPLAN Electric P8 EPLAN Electric P8 is een CAE-softwareoplossing voor de engineering, documentatie en het beheer van elektrotechnische automatiseringsprojecten. EPLAN Fluid EPLAN Fluid is een CAE-softwareoplossing voor de engineering en documentatie van fluidtechnische installaties op het gebied van hydraulica, pneumatiek, koeling en smering. EPLAN Preplanning EPLAN Preplanning is een CAE-softwareoplossing voor de technische preplanning van machines en installaties. De software ondersteunt grafische en databankgebaseerde werkwijzen, met gegevensoverdracht naar interdisciplinaire detailplanningen. De individuele systeemconfiguratie maakt een flexibele aanpassing aan bestaande engineeringsprocessen mogelijk. EPLAN Preplanning P&ID EPLAN Preplanning P&ID is een CAE-softwareoplossing voor het maken van installatieoverzichten, PFD's (Process Flow Diagram) en P&ID's (Piping and Instrumentation Diagram) voor procestechnische machines en installaties. 6

7 EPLAN Pro Panel EPLAN Pro Panel is een CAE-softwareoplossing voor de engineering en verificatie van schakelkasten en schakelinstallaties in 3D, inclusief het beschikbaar stellen van gegevens voor de materiaallogistiek en de productieintegratie. EPLAN Harness prod EPLAN Harness prod is een CAE-softwareoplossing voor de efficiënte constructie en documentatie van kabels en kabelbomen in 3D / 2D, van het digitale prototype tot aan de vervaardiging van complete productdocumentatie. EPLAN Engineering Configuration One De toepassing van EPLAN Engineering Configuration One (EEC One) is de eerste stap in de wereld van geautomatiseerde Excel-gebaseerde schemavervaardiging voor de elektro- en fluidtechniek op basis van voorgedefinieerde standaarden zoals EPLAN-macro's, waardensets en varianten. EPLAN Engineering Configuration EPLAN Engineering Configuration Professional (EEC Professional) is een soort "besturingscentrale", die bruggen slaat tussen mechanica, elektrotechniek, besturingstechniek en de documentatie. Met een systeem van bouwkasten en voorschriften kunnen varianten in de machine- en installatiebouw worden beheerd. EPLAN Data Portal Geïntegreerd, webgebaseerd gegevensplatform waarmee actuele apparaatgegevens van toonaangevende fabrikanten van componenten ter beschikking worden gesteld en direct kunnen worden gebruikt bij de engineering met EPLAN-softwareoplossingen. Onze software is uniform ontworpen en verbindt alle disciplines. 7

8 Opmerking: De in deze productbeschrijving genoemde functies en mogelijkheden, hebben steeds betrekking op de meest uitgebreide leveringsomvang van de technologie. Afhankelijk van het geïnstalleerde EPLAN-systeem, kan deze leveringsomvang afwijken. Monheim, September 2015 Productmanagement EPLAN Software & Service GmbH & Co. KG 8

9 EPLAN API EPLAN API voordelen Voor de producten EPLAN Electric P8, EPLAN Fluid, EPLAN Pro Panel en EPLAN PPE is een uniforme en bijzonder krachtige programmeerinterface (API, Application Programming Interface) beschikbaar. De programmeerinterface is gebaseerd op de huidige Microsoft ".Net 4.0"- technologie en biedt zo een open, toekomstgericht en krachtig ontwikkelingsplatform. Ontwikkel zelf of samen met EPLAN op basis van de EPLAN API uw eigen op maat gesneden engineeringsoplossingen. Het gebruik van de API en de mogelijke samenwerking tussen EPLAN en softwareaanbieders in de EPLAN-omgeving zijn via het EPLAN API Developer Network (EADN) geregeld. Functionele prestatieverbetering Met de EPLAN API kunt u binnen uw eigen bedrijf op basis van het EPLANplatform op efficiënte wijze individuele functies realiseren en zo de workflow- en systeemintegratie nog verder verbeteren. Als sleutelcomponent in de engineering maakt EPLAN door individuele aanpassing aan uw specifieke taakstellingen een uiterst efficiënte en door automatismen sterk gerationaliseerde projectbewerking mogelijk. Voor aanbieders van interfaces en engineeringsoplossingen in de EPLANomgeving kunnen op basis van de EPLAN API creatieve eigen toepassingen worden ontwikkeld die nieuwe marktkansen bieden. 9

10 Snellere taakgerichte processen Met de EPLAN API kunt u gestandaardiseerde werkprocessen in de engineering automatiseren. De standaard functieomvang van de EPLANproducten kan bovendien met individuele functionaliteiten worden uitgebreid. Zo kan EPLAN eenvoudig aan uw individuele werkmethode worden aangepast. Dankzij de automatisering en individualisering wordt de bediening van de totaaloplossing voor afzonderlijke gebruikers vereenvoudigd. Doorlooptijden, ontwerpfouten en inwerktijden worden op deze manier gereduceerd. Gebruikers van andere programma's binnen de EPLAN-omgeving kunnen door toegang op afstand via EPLAN API programmering EPLAN-functionaliteiten en gegevens gebruiken zonder daarbij de oorspronkelijke werkomgeving te hoeven verlaten. Dat maakt een uniforme gegevensstroom tussen alle bij de engineering betrokken applicaties mogelijk. Resultaten zijn zo sneller en economisch voordeliger beschikbaar. EPLAN API techniek De volgende hoofdstukken helpen softwareontwikkelaars bij de beoordeling van de mogelijkheden van de EPLAN API voor hun onderneming. Voor de programmering is in principe niet meer nodig dan een eenvoudige teksteditor en een gratis ".Net" compiler. Maar voor een meer gebruiksvriendelijk ontwikkelingsproces raden wij zeker een geïntegreerde ontwikkelomgeving aan, zoals Microsoft Visual Studio, die door de EPLAN API optimaal wordt ondersteund. Als programmeertalen kunt u talen gebruiken die door ".Net" worden ondersteund, zoals C#, Visual Basic en C++/CLI. Met behulp van de EPLAN API kunnen zowel uitbreidingsmodulen, die binnen het EPLAN-systeem functioneren, als zelfstandige programma's worden geschreven. 10

11 Uitbreidingsmodulen Met behulp van uitbreidingsmodulen kunnen nieuwe functionaliteiten worden gecreëerd die naadloos in de gebruikersinterface kunnen worden geïntegreerd. Zo kunnen eigen menuopdrachten en dialoogvensters in de EPLAN-applicaties worden opgenomen. Uitbreidingsmodulen zijn ".Net"-assemblies, die slechts eenmalig worden geregistreerd en vervolgens bij elke start van EPLAN beschikbaar zijn. Zelfstandige programma's Met behulp van de EPLAN API kunnen EPLAN-functionaliteiten ook in eigen programma's worden toegepast. Via deze "offline-toepassingen" kan een groot aantal individuele tools worden geprogrammeerd, waarmee aan speciale eisen kan worden voldaan. In combinatie met voorbereide schemamacro's en deelschema's kunnen zo bijvoorbeeld complexe schemagenerators worden opgebouwd, die in staat zijn EPLAN-schema's automatisch te genereren. De configuratie en de workflow kunnen daarbij individueel en bedrijfsspecifiek worden ingesteld. 11

12 EPLAN API frameworks Vanuit technisch oogpunt is de EPLAN API ingedeeld in verschillende bereiken, met elk hun eigen programmeeromgeving (EPLAN API framework). Afhankelijk van de taakstelling kan een EPLAN API programma worden bediend vanuit de bereiken "Objectmodel", "Basisfunctionaliteiten" of "Geavanceerde functionaliteiten". EPLAN API objectmodel Met het EPLAN API objectmodel kunnen elektro- en fluidtechnische schemasymbolen direct worden bewerkt. Hiervoor stelt de EPLAN API een objectgeoriënteerd gegevensmodel beschikbaar, dat directe toegang biedt tot de verschillende schemasymbolen en de overige projectgegevens. In het EPLAN API gegevensmodel zijn er vele objectklassen, waarmee vrijwel elk aspect van een project kan worden vastgelegd en waarmee de eigenschappen daarvan kunnen worden benaderd, uitgelezen en gewijzigd. Op deze manier kunnen bijvoorbeeld projecten, pagina's en functies, maar ook complete 3D-schakelkasten worden gegenereerd, bewerkt en verwijderd. Een overzicht van het EPLAN API objectmodel vindt u in het functieoverzicht aan het eind van deze productbeschrijving. 12

13 EPLAN API basisfunctionaliteiten Als basisfunctionaliteiten van de EPLAN API zijn mechanismen beschikbaar, die in alle EPLAN-productvarianten nodig zijn. Met deze EPLAN API basisfunctionaliteiten kunnen bijvoorbeeld instellingen worden uitgelezen of gedefinieerd, teksten in de systeemmeldingen worden ingevoerd, meertalige eigenschappen worden bewerkt of kan het in EPLAN geïntegreerde rechtenbeheer worden toegepast. Een overzicht van de EPLAN API basisfunctionaliteiten vindt u in het functieoverzicht aan het eind van deze productbeschrijving. Geavanceerde EPLAN API functionaliteiten Naast de basisfunctionaliteiten biedt de EPLAN API zogeheten geavanceerde functionaliteiten uit de bereiken EPLAN Electric P8, EPLAN Fluid, EPLAN Pro Panel en EPLAN Preplanning. Enkele voorbeelden van deze geavanceerde EPLAN API functionaliteiten: Macro's kunnen automatisch worden ingevoegd of individuele schemasymbolen kunnen in het schema worden geplaatst. Verwerkingen kunnen worden geactualiseerd, projecten of afzonderlijke pagina's kunnen naar printers worden uitgevoerd of in PDF-formaat worden geëxporteerd. Er kunnen controleprocedures worden gestart en de resultaten daarvan kunnen worden verwerkt. Eigen controleprocedures kunnen worden uitgebreid en er kunnen nieuwe meldingen in het meldingenbeheer worden geschreven. Er zijn functies beschikbaar voor de meest uiteenlopende typen projectgegevens, zoals artikelen, PLC's, kabels etc. Ook zijn de functies van de backup- of de labelingsmodule toegankelijk. Een overzicht van de geavanceerde EPLAN API functionaliteiten vindt u in het functieoverzicht aan het eind van deze productbeschrijving. 13

14 EPLAN API ontwikkelomgeving Softwareontwikkelaars worden door de EPLAN API optimaal ondersteund. De programmeerinterface wordt als zelfstandige setup geleverd en integreert de EPLAN API in de ontwikkelomgeving van Microsoft Visual Studio. De integratie van de ontwikkelomgeving omvat een contextafhankelijke Help en diverse Project en Klasse Wizards. In de meegeleverde gebruikershandleiding wordt stap voor stap uitgelegd hoe u een add-on-programma maakt. De Help-functie en gebruikershandleiding zijn beschikbaar in het Engels. 14

15 Functieoverzicht Het volgende functieoverzicht bevat een overzicht van de EPLAN APImogelijkheden. EPLAN API objectmodel Objectmodel met echte afleidingshiërarchie Projecten openen, sluiten, kopiëren, verwijderen etc. Projectgegevens bewerken Eigenschappen op type afvragen en plaatsen Eigenschapattributen bepalen: type, codering en toegangsmodus Gebruikergedefinieerde eigenschappen maken Definitie van eigen Ongedaan-maken-stappen Integratie in het Ongedaan-maken-beheer van de interface Projectinstellingen bewerken Gefilterde toegang tot pagina's Projecten genereren en bewerken Pagina's genereren en bewerken Elektro- en fluid-technische functies genereren en bewerken Krachtige zoekfuncties voor gegevensmodelobjecten Gefilterde toegang tot objecten op pagina's Uitlezen van speciale macro-eigenschappen zoals invoegpunten of tijdelijke aanduidingen voor de macroplaatsing Plaatsing van symbolen Toegang tot opgeslagen symbolen en symboolvarianten Toegang tot opgeslagen artikelen Toewijzing van artikelen aan functies Apparaatkasten genereren en bewerken Structuurkasten genereren en bewerken 15

16 Macrovakken genereren en bewerken Kabeldefinities genereren en bewerken PLC-kasten genereren en bewerken Stekers en stekercontacten genereren en bewerken Klemmenstroken, klemmen en klemmentoebehoren genereren en bewerken Groepen plaatsingen genereren en bewerken Groeperingen genereren en bewerken Grafische objecten genereren en bewerken Toegang tot logica via functiesjablonen Verbindingseigenschappen bewerken Dynamische verbindingslijnen bewerken Verbindingseigenschappen via verbindingsdefinitiepunten bewerken Afbreekpunten genereren en bewerken Bundelaansluitingen en bundelverbinders genereren en bewerken Potentiaaldefinities genereren en bewerken Aansluitingen van functies genereren en bewerken Tijdelijke aanduiding-teksten genereren en bewerken Toegang tot het layerbeheer en alle grafische layers Hyperlinks en afbeeldingen genereren en bewerken Pad-functieteksten genereren en bewerken Geplaatste eigenschappen genereren en bewerken Tijdelijke aanduiding-objecten, variabelen en waardensets genereren en bewerken Projectopties bewerken Alle elementen van 3D-schakelkasten genereren en bewerken Topologie-routeringstrajecten genereren en bewerken Pre-planning segmenten genereren en bewerken Toegang tot deelprojecten 16

17 EPLAN API basisfunctionaliteiten Opzetten en uitvoeren van geparameteriseerde acties Uitvoeren van opdrachtregeloproepen in de EPLAN API Integreren van uitbreidingsmodulen Eigen menuopdrachten genereren Integreren van eigen werkbalken Reageren op systeemgebeurtenissen Opzetten van eigen systeemgebeurtenissen Uitlezen van de systeemmeldingenlijst Uitlezen van het meldingenbeheer Naar gelang het gebruik van het rechtenbeheer: controleren van rechten voor bepaalde acties Multi-user-functies Bepalen van de actuele gebruiker Toevoegen van eigen gebruikersrechten voor eigen uitbreidingsmodulen Meertalige eigenschappen bewerken Instellingen lezen, schrijven en aanbrengen Toegang tot schema's voor geavanceerde functies Besturing van de voortgangsweergave Voortgangsweergave in eigen programma's opnemen Naadloze integratie van nieuwe export- en importformaten Schrijven van externe programma's op basis van een applicatieobject 17

18 Geavanceerde EPLAN API functionaliteiten Projecten archiveren en inpakken Stamgegevens archiveren en inpakken Projecten uit archieven terugzetten Stamgegevens uit archieven terugzetten Automatische kabelselectie Kabelnummering Controleprocedures uitvoeren Verbindingsdefinitiepunten bewerken Apparaten genereren Apparatenlijsten importeren en exporteren Grafische weergaven in eigen dialoogvensters weergeven Projectpagina's openen en plaatsingen of posities markeren Export in verschillende afbeeldingsbestandsformaten, DXF / DWG, PXF, PDF Import van DWG / DXF Gegevensovername uit EPLAN 5 en EPLAN 21 Projecten verwerken Actualiseren van verwerkingen Ingesloten verwerkingen invoegen Modelaanzichten invoegen Automatisch verwerken van modelaanzichten Automatisch verwerken van boorpatronen Automatisch verwerken van koperuitslagen Macro's invoegen Besturen van de labelingsmodule, genereren van lijsten Stamgegevens laden, actualiseren en veilig opslaan Montageplaten reorganiseren, bijvoorbeeld legendanummers Toegang tot het artikelbeheer 18

19 Artikelen opslaan in het project Materiaallijsten exporteren en importeren Objecten toevoegen aan tijdelijke aanduidingen, waardensets toewijzen Import en export van PLC I/O-lijsten Projecten en pagina's afdrukken Toegang tot afdrukinstellingen Projecten publiceren Projecten comprimeren Projectkopgegevens inlezen Onderdelen nummeren Materiaallijstposities nummeren Nummering van onderdelen met PLC-gegevens Actualiseren van verbindingen Potentialen en signalen traceren Revisiebeheer Vergelijkingsprojecten genereren Projecten vergelijken Resultaten van de projectvergelijking uitlezen Pagina's en projecten afsluiten Revisies van projecten maken Lezen en toevoegen van invoeren in zoeklijsten Geselecteerde objecten bepalen Projecten vertalen Lijsten met ontbrekende woorden exporteren Meldingen aan het meldingenbeheer toevoegen Eigen controleprocedures en meldingen integreren Toegang tot symboolbibliotheken Import en export van pre-planning gegevens Automatisch routeren van topologieverbindingen 19

20 Export van layoutruimtes naar STEP of VRML Export van boorpatroongegevens voor NC-machines Export van draadconfectioneringsgegevens (Fouten en wijzigingen voorbehouden.) 20