La funzione Valuta esternamente permette di esportare valutazioni create da EPLAN Harness proD mediante un programma di elaborazione di valutazioni (creato in proprio). I dati contenuti in una valutazione vengono esportati in un file temporaneo di dati XML. Quindi, viene lanciato in automatico il programma di elaborazione di valutazioni che da questi dati crea l'emissione desiderata. Nella sezione Informazioni per sviluppatori si trovano maggiori informazioni per creare un siffatto programma.

La directory di installazione di EPLAN Harness proD contiene una demo a nome HReportExternally.exe: Questo programma usa un modello di file .xlsx per l'emissione di valutazioni in fogli Microsoft Excel. Un modello per ciascun genere di valutazione è contenuto nella directory di installazione. Qui è possibile trovare parole chiave per ciascun genere di valutazione:

• Parole chiave per valutazioni accessori
• Parole chiave per valutazioni gruppi / dispositivi
• Parole chiave per distinte base raggruppate
• Parole chiave per distinte base per riga
• Parole chiave per valutazioni cavi
• Parole chiave per valutazioni unità cavo
• Parole chiave per valutazioni oggetti collegabili
• Parole chiave per valutazioni componenti speciali
• Parole chiave per valutazioni protezione della superficie
• Parole chiave per valutazioni di cavi preassemblati
• Parole chiave per valutazioni di liste collegamenti

Tutti i generi di valutazioni possono contenere anche proprietà definite dall'utente. Il nome della proprietà definita dall'utente deve presentare il prefisso userdef_ e al posto di spazi, la sequenza di caratteri _x0020_.

Configurazione richiesta per la funzione "Valuta esternamente"

Per utilizzare la funzione "Valuta esternamente", è necessario soddisfare due requisiti:

• Un idoneo programma .exe per l'elaborazione di valutazioni deve essere disponibile sul computer o nella rete locale
• Il percorso file e gli argomenti parametri devono essere stati aggiunti alle impostazioni di Studio

Facendo l'esempio del programma demo HReportExternally.exe, si dovrebbe procedere come segue:

1. Richiamare in Studio Extra > Impostazioni > Valutazioni > Valuta esternamente.
   
   Si vedrà un elenco di tipi di valutazione, ciascuno con due campi. Uno per un percorso file che porta a un programma di elaborazione di valutazioni e uno per argomenti parametri.
   
2. Nel tipo di valutazione che interessa, scegliere il percorso che porta al programma esterno
   
   Selezionare la valutazione di distinta base redatta come esempio, e utilizzare quindi il programma demo <Harness proD-Directory installazione>\HReportExternally.exe.
   
3. Fare clic sul campo vicino e indicare, se necessario, ulteriori argomenti per il programma.
   
   Nel programma demo, si tratterebbe del percorso fino al modello di valutazione adeguato. Il percorso modello deve essere indicato nel seguente formato: -template "<Harness proD-Directory installazione>\Demo\Demo_ReportExternally\<template name>.xlsx". Per le valutazioni di distinte base redatte è possibile utilizzare il modello bom_aggregated_template.xlsx.
4. Fare clic su [OK].
   

Esporta valutazione con "Valuta esternamente"

Dopo avere predisposto le impostazioni di Studio per svolgere la funzione "Valuta esternamente", sarà possibile esportare valutazioni con questa funzione:

1. Aprire la valutazione che si desidera esportare con il programma.
2. Selezionare le voci di menu File > Valuta esternamente.
   
   Selezionare una directory in cui va salvata la valutazione finale, definirne il nome e assegnare un'estensione file adeguata. Nel programma demo, l'estensione deve essere *.xlsx.
3. Fare clic su [Salva].

Informazioni per sviluppatori

Il codice sorgente non compilato per HReportExternally.exe è salvato in <Harness proD-Directory installazione>\Demo\Demo_ReportExternally\Demo_ReportExternally.zip.

Se la valutazione viene salvata mediante la funzione Valuta esternamente, Harness proD esegue i seguenti passaggi:

• Harness proD crea il file *.xml con i dati di valutazione.
• Harness proD richiama il programma con i seguenti argomenti:
  
  
  • -source "<Percorso file al file dati XML>"
  • -output "<Percorso file al file di emissione che è stato definito dall'utente>"
  • Argomentazioni aggiuntive definite dall'utente come -template "<Percorso file a modello>" per il programma demo HReportExternally.exe.

Il programma utilizza queste informazioni per la creazione di una valutazione finale.

Variabili specifiche ai modelli di HReportExternally.exe

Nei modelli del programma demo HReportExternally.exe sono utilizzate diverse variabili:

Parola chiave	Descrizione
PROJECT_NAME	Nome del progetto
DATE	Data dell'esportazione di valutazione
TIME	Ora dell'esportazione di valutazione
START	Indicazione necessaria, in cui si trova la prima colonna della tabella, che va compilata con i dati
END	Indicazione necessaria, in cui si trova l'ultima colonna della tabella, che va compilata con i dati