Novità nel modulo di estensione "EPLAN API Extension"

Per i prodotti della piattaforma EPLAN è disponibile un'interfaccia di programmazione particolarmente uniforme ed efficiente (API, Application Programming Interface). Con l'ausilio di questo modulo di estensione, l'EPLAN API, è possibile sviluppare soluzioni personalizzate in collaborazione con EPLAN o altri partner. Per ulteriori informazioni sull'EPLAN API e sull'EADN, consultare le pagine Internet di EPLAN alla sezione "Soluzioni > Integrazione > EPLAN API Developer Network". La sezione seguente fornisce alcune informazioni in merito alle diverse novità nell'EPLAN API. Per poter sviluppare proprie applicazioni con la nuova versione dell'EPLAN API, è necessario il programma .NET Framework 4.5.2 di Microsoft.

Note:

Il modulo di estensione "EPLAN API Extension" è disponibile facoltativamente nell'ambito del nostro EPLAN Application Developer Network (EADN) come pacchetto di sviluppo per le varianti programma seguenti:
EPLAN Electric P8 Select, EPLAN Electric P8 Professional,
EPLAN Electric P8 Professional+, EPLAN Electric P8 Ultimate,
EPLAN Fluid, EPLAN Fluid Professional,
EPLAN Fluid Professional+, EPLAN Fluid Professional E,
EPLAN Preplanning P&ID, EPLAN Preplanning Professional,
EPLAN Pro Panel Professional, EPLAN Pro Panel Professional+.
Inoltre, il modulo di espansione "EPLAN API Extension" può essere acquistato anche per licenze "normali" (con eccezione per EPLAN Electric P8 Compact, EPLAN Fluid Compact).

Nota:

Si consiglia a ogni utente API di compilare e tempestivamente la propria applicazione con la nuova versione di EPLAN API. Se nell'applicazione vengono ancora utilizzati metodi obsoleti, durante la compilazione viene visualizzata un'avvertenza compiler corrispondente.

Disegna nuvola

Per mezzo di EPLAN API è ora inoltre possibile disegnare un rettangolo o una polilinea chiusa a forma di nuvola. A tale scopo occorre definire di conseguenza la proprietà FillPattern nella categoria Rectangle o PolyLine.

Metodi di importazione dati eliminati

Diversi metodi di importazione dati da EPLAN 21 ed EPLAN 5 sono stati eliminati in EPLAN API.

Aggiorna dati di base progetto

Con l'aiuto della nuova azione masterdata è ora possibile esportare i dati di base mediante chiamata della riga di comando, tramite script oppure EPLAN API. A tale riguardo, attraverso il parametro /TYPE:UPDATEPROJECT specificare che i dati di base progetto vengono aggiornati. Nell'interfaccia della piattaforma EPLAN ciò è possibile accedendo alle voci di menu Programmi servizio > Dati di base > Aggiorna progetto corrente.

Nuovi parametri per l'azione "generatemacros"

L'azione generatemacros è stata ampliata con i seguenti parametri opzionali:

PAGENAMEn : Nomi delle pagine da considerare
INSTALLATIONSPACENAMEn : Nomi degli ambienti 3D da considerare
STRUCTUREn : Identificativo struttura degli ambienti 3D da considerare
WINDOWMACRODIR : Directory per macro di finestra
PAGEMACRODIR : Directory per macro di pagina
FILTERSCHEME : Schema del filtro
OVERWRITE : Modalità sovrascrittura.

Qui, "n" corrisponde a un numero.

Generazione di punti di definizione tubazione e attacchi tubazione

Analogamente alle voci di menu Inserisci > Punto di definizione della tubazione e Inserisci > Attacco tubazione, nell'interfaccia utente è ora possibile generare e modificare i punti di definizione della tubazione e gli attacchi della tubazione anche mediante EPLAN API. A tale scopo nello spazio dei nomi Eplan.EplApi.DataModel è disponibile la nuova classe PipingDefinition.

Inserimento nella gerarchia armadio durante il posizionamento

Per poter considerare durante il posizionamento degli articoli nel layout 3D anche l'impostazione Inserisci nella gerarchia armadio in EPLAN API, alla classe Placement3D è stato aggiunto il metodo supplementare FindSourceMate.

Aggiornamento degli articoli mediante EPLAN Data Portal

Per mezzo di EPLAN API è ora possibile aggiornare l'articolo nella gestione articoli attraverso EPLAN Data Portal. A tale scopo, la classe MDPartsDataBase è stata ampliata con il nuovo metodo UpdatePartFromDataPortal.

Assegnazione del nome interfaccia bus per le maschere funzioni e la configurazione degli attacchi

Al fine di poter assegnare un nome interfaccia bus per le maschere funzioni nella Gestione articoli anche mediante EPLAN API, è disponibile per l'utente nella classe MDPlcTemplatePosition la nuova proprietà BusSystem.

Poiché il nome interfaccia bus può essere inserito anche nelle configurazioni degli attacchi della gestione articoli e nella configurazione degli attacchi di determinate funzioni (ad es. posizionamento articolo 3D), alle classi MDConnectionPointPosition e ConnectionPointPosition è stata di conseguenza aggiunta la nuova proprietà PLCBusInterfaceName.

Raggruppamento delle maschere funzioni come maschera composita

Per mezzo del nuovo metodo TemplateGroup della classe MDFunctionTemplatePosition è ora possibile mediante EPLAN API riepilogare le maschere funzioni delle funzioni correlate nella gestione articoli in una maschera composita.

Emissione di valori numerici come testo multilingue

I nuovi metodi GetDisplayString della classe PropertyValue consentono di emettere per le proprietà, invece di valori numerici, dei testi multilingue espressivi dall'interfaccia utente.

Utilizzo delle nuove variabili percorso

Per mezzo della classe PathMap e dei metodi SubstitutePath già esistenti, ora è possibile utilizzare anche tutte le nuove variabili percorso della piattaforma EPLAN (variabili di programma, variabili di progetto e variabili di ambiente).

Accesso ai set di valori dalle macro sugli oggetti della progettazione

Ora è possibile accedere a una macro salvata in un oggetto della progettazione e a un oggetto segnaposto definito nella macro con set valori anche mediante EPLAN API. A tale scopo, nella classe PlanningObject è disponibile la nuova proprietà MacroPlaceHolderValueSets.

Definizione della dimensione collegamento nelle maschere funzioni

In alcune delle classi derivate dalla classe MDFunctionTemplatePosition (ad es. MDTerminalTemplatePosition), è ora disponibile la nuova proprietà ConnectionDimension. Per mezzo di tale proprietà è ora possibile definire la dimensione collegamento per un articolo nelle maschere funzioni anche mediante EPLAN API.