ZIEHL-ABEGG FANselect DLL API Programming Interface
Introduzione
U FANselect DLL serve cum'è una interfaccia di prugrammazione di l'applicazione per FANselect. Esige una stringa di dumanda cum'è input è produce una stringa di risposta.
E stringhe di dumanda è di risposta ponu esse formattate cum'è JSON o XML. Hè à l'applicazione chì chjama per creà l'input necessariu è analizà l'output di l'API.
Questa API pò esse:
Scaricatu (cum'è DLL di Windows) clicchendu nantu à u ligame www.ziehl-abegg.com/fileadmin/de/de/05_Support/Software/FANselect/FANselect_DLL.zip o accede à traversu u web via http://fanselect.net:8079/FSWebService
Pudete registràvi quì https://www.ziehl-abegg.com/digitale-loesungen/software/fanselect per u FANselect login necessariu per utilizà a DLL.
U cartulare DLL FANselect scaricabile pò esse piazzatu in ogni locu in a vostra macchina. Hè impurtante di mantene u cartulare intactu è aghjurnata. A vostra applicazione avissi bisognu di accede à u fanselect.dll file in stu cartulare.
Per aghjurnà a vostra versione di DLL:
- Scaricate u novu cartulare DLL da u URL sopra
- Sguassà u vostru cartulare DLL attuale
- piazzate u novu cartulare DLL in quellu locu vacante da u vostru cartulare DLL precedente
U FANselect web L'API hè sempre aghjurnata è per quessa ùn hè micca bisognu di l'utilizatore per aghjurnà.
In ogni cartulare DLL ci hè un strumentu di teste, chjamatu ZADllTest.exe o ZADllTest64.exe, cù quale pudete pruvà stringhe di input è output.
Image 1: A sinistra hè l'area di input mentre chì u latu drittu cuntene i outputs pruduciuti da a DLL. Cliccate nantu à a tabulazione Testu in u latu superiore manca per vede a stringa di dumanda generata.
Pudete pruvà l'input inserendu i paràmetri chì vulete in a forma (Image 1). In u toccu "Testu" pudete scrive o copià u json sting (esample vede 2.1.) in.
Cunnette vi à FANselect DLL
Ingressi minimi richiesti:
nome d'utilizatore: U nome d'utilizatore di u vostru contu FANselect
codice: A password di u vostru contu FANselect
cmd: Ricerca (spiegata in a sezione 2.2)
qv: débit volumétrique du point de service
psf: Pressione statica di u puntu di duty
spec_products: Portfolio chì cuntene i fan richiesti (spiegatu in a sezione 3.1)
lingua: Sceglite a lingua per l'outputs per apparisce (spiegata in a sezione 3.1)
Cù questi inputs minimi, a vostra stringa di dumanda deve esse cum'è a sampi sottu:
Stringa di dumanda JSON example
{
"username" : "ZAFS19946"
"password" : "bnexg5",
"cmd" : "cerca",
"qv" : "2500",
"psf" : "50",
"spec_products" : "PF_00",
"language": "EN",
}
Stringa di richiesta identica cum'è XML:
ZAFS19946
bnexg5
cerca
2500
50
PF_00
FR
Programmazione di un lettore DLL
Pudete accede à a DLL via una di e trè funzioni.
ZAJsonRequestW: Per Unicode Strings
ZAJsonRequestA: Per UTF-8 Strings
ZAJsonRequestBSTR: Per l'oggetti OLE
U vostru lettore DLL deve passà a stringa di dumanda cum'è un argumentu à una di e funzioni sopra, è poi leghje a pruduzzioni di DLL.
Funzione di DLL Reader in Python
def za_dll_fan_selection (stringa di richiesta, dll_path):
import ctypes
impurtà json
fanselect_dll = ctypes.WinDLL(dll_path)
fanselect_dll_output = (ctypes.wstring_at (fanselect_dll.ZAJsonRequestW (request_string)))
torna fanselect_dll_output
request_string hè un furmatu identicu à Request String example sopra, anche se cù più inputs
dll_path: hè u percorsu à a DLL FANselect, per esempiu C.\FANselect_DLL\FANselect_DLL}fanselect.dll
Funzione di DLL Reader in VBA
Funzione di dichjarazione privata ZAJsonRequestBSTR Lib
"C:\FANselect_DLL\FANselect_DLL\FANselect.dll" (ByVal sRequest As String) As String
Funzione publica vba_reader (ByVal input_request_string As String) As String
Dim request_string As String
Dim response_string As String
Dim request_string_unicode As Variante
Dim response_string_unicode As Variante
request_string = "{" + input_request_string + "}"
request_string_unicode = StrConv (request_string, vbUnicode)
response_string_unicode = ZAJsonRequestBSTR (request_string_unicode)
response_string = StrConv (response_string_unicode, vbFromUnicode)
vba_reader = risposta_stringa
Funzione di fine
In più Examples pò esse scaricatu da i ligami sottu
C++ http://downloads.fanselect.net//fanselect/dll_examples/CPPConsoleApp.zip
C# http://downloads.fanselect.net//fanselect/dll_examples/VCS10StandardApp.zip
Delfi http://downloads.fanselect.net//fanselect/dll_examples/DelphiConsoleApp.zip
VB6 http://downloads.fanselect.net//fanselect/dll_examples/VB6StandardApp.zip
VB10 http://downloads.fanselect.net//fanselect/dll_examples/VB10StandardApp.zip
Cunnette vi à FANselect Web API
Accessu à FANselect web L'API hè quasi identica à u prucessu utilizatu per accede à a DLL.
L'unica diferenza hè chì duvete mandà duie richieste:
1st Request: Per ottene un ID di Session
2nd Request: Richiesta abituale, chì include l'ID di sessione ottenuta in a prima dumanda
U vantaghju maiòtage di u web L'API hè chì hè (cum'è dettu prima) sempre aghjurnatu è ùn deve micca esse scaricatu. Per piacè esaminà l'affidabilità di Internet in u vostru locu è i paràmetri di firewall / security di a vostra macchina, postu chì questi puderanu hamper u web Prestazione di l'API.
Cum'è cù a DLL scaricabile, dumande è risposte da u web L'API pò esse mandatu cum'è strings JSON o XML.
Sia DLL sia web L'API produce risultati identici, postu chì i dui utilizanu i stessi algoritmi di selezzione è calculu. Ogni discrepanza trà DLL è web API, sò probabilmente dovutu à una DLL obsoleta.
Web Funzione API Reader in Python
impurtà json
dll_path = "http://fanselect.net:8079/FSWebserviziu"
def za_api_fan_selection_0(request_string, dll_path):
richieste d'importazione
fanselect_api_output = requests.post(url= dll_path, data = richiesta_stringa)
torna fanselect_api_output
# Get ID di sessione
request_string = "{'cmd':'create_session', 'username': 'USERNAME', 'password': 'PASSWORD'}"
stringa_richiesta = str (stringa_richiesta)
dll_path = str(dll_path)
response_string = za_api_fan_selection_0 (request_string, dll_path)
session_id = json.loads (response_string_raw.content) ['SESSIONID']
# Richiesta di solitu
request_string = "{"
request_string = request_string + "'username': 'USERNAME',"
request_string = request_string + "'password': 'PASSWORD',"
request_string = request_string + "'language': 'EN',"
request_string = request_string + "'unità_sistema': 'm',"
request_string = request_string + "'cmd': 'cerca',"
request_string = request_string + "'cmd_param': '0',"
request_string = request_string + "'spec_products': 'PF_00',"
request_string = request_string + "'product_range': 'BR_01',"
request_string = request_string + "'qv': '2500',"
request_string = request_string + "'psf': '50',"
request_string = request_string + "'current_phase': '3',"
request_string = request_string + "'voltage': '400',"
request_string = request_string + "'frequenza_nominale': '50',"
request_string = request_string + "'sessionid': '" + session_id + "',"
request_string = request_string + "'full_octave_band': 'veru',"
request_string = request_string + "}"
stringa_richiesta = str (stringa_richiesta)
response_string_initial = za_api_fan_selection_0 (request_string, dll_path)
In più Examples pò esse scaricatu da i ligami sottu
C# http://downloads.fanselect.net/fanselect/dll_examples/VCS10WebService.zip
VB10 http://downloads.fanselect.net//fanselect/dll_examples/VB10WebService.zip
Inputs & Outputs
Tutti l'inputs Spiegati
lingua
Stabilisci a lingua di outputs
opzioni di input:
CS: Ceccu DA: Danese DE: Tedescu FR: Inglese
ES: Spagnolu FR: Francese FI: Finlandese HU: Ungherese
IT: Talianu JA: Ghjappunese NL: Ulandesa PL: Pulaccu
PT: Portughese RU: Russu SV: Svedese TR: Turcu
ZH: Cinese
sistema_unità
sistema unità à esse usatu in calculs.
Opzioni di input:
m: metrica i: imperiale
nome d'utilizatore
U nome d'utilizatore di u vostru contu FANselect.
codice
A password di u vostru contu FANselect
L'utilizatori chì anu interessatu solu in un settore limitatu di articuli, ponu acquistà una o più combinazioni di nome d'utilizatore / password (login). Ogni login offre un settore specificu di articuli - predefiniti da l'utilizatore.
L'applicazione di l'utilizatori chjamarà a dll cù unu di sti logins specifichi per selezziunà da una piscina limitata di articuli. Avanzatutages: Prucessu di selezzione più veloce è più chjucu numeru di articuli trà l'insemi truvati
cmd
cmd, cortu per u cumandamentu, hè necessariu per istruisce a DLL nantu à u tipu di outputs necessariu
Opzioni di input:
ricerca: selezzione per puntu di duty + filtri cum'è dimensione, disignu, etc.
status: Fornisce u nome d'utilizatore è a versione di u software. Web L'API produce ancu SESSIONID.
create_session: Ottene SESSIONID. Questu cmd hè pertinente solu per u web API
I seguenti cmd necessitanu un numeru d'articulu in article_no: selezziunà: Selezziunate per numeru d'articulu. I dati nominali di l'articulu sò in output se u puntu di duty ùn hè micca ottenutu
nominal_values: Ottene i valori nominali elettrici di l'articulu. Queste dati sò ancu ottenuti cù a vostra dumanda di ricerca iniziale mettendu insert_nominal_values à veru
motor_data: Articulu di dati di u mutore. Pò esse ancu uttene cù ricerca è insert_motor_data: true
geo_data : Articulu (geometricu) dimensioni. Ottene sta dati cù a ricerca mettendu insert_geo_data à veru
accessori: Descrive l'accessori assuciati cù l'articulu
get_chart: Crea charts per l'articulu sceltu
cmd_param
Pudete stabilisce l'indici di l'articulu chì vulete
zawall_mode
Sceglite se vulete selezziunà parechji fan, cù una di duie opzioni
ZAWALL: Selezziunate cù parechji fanali solu
ZAWALL_PLUS: Selezziunate utilizendu fanali multipli è unichi
zawall_size
Stabilite u numeru di fan chì vulete usà in u vostru array multipli di fan. U numeru massimu di fan hè stabilitu à 20.
zawall_size pò ancu esse lasciatu viotu. FANselect determinerà automaticamente u numeru di fan necessarii.
E selezioni senza un numeru predeterminatu di fan di solitu venenu cù un tempu di risposta più longu.
qv
Velocità volumetrica in m³/h per unità_sistema a scelta m o CFM per unità_sistema a scelta i.
psf
Pressione statica sia in Pa per a scelta di sistema_unità m o in wg per a scelta di sistema_unità i.
pf
A pressione totale sia in Pa per a scelta di u sistema di unità m o in wg per a scelta di u sistema di unità i
In a vostra stringa di dumanda, o specificate psf o pf.
spec_products
Fans in FANselect sò posti in portafogli discreti, indicati da i codici PF elencati quì sottu. Hè ubligatoriu di inserisce una cartera specifica. Attualmente ùn hè micca pussibule di selezziunà in parechje portafogli.
Opzioni di input
PF_50: Standard Worldwide PF_54: AMCA Products Thailand
PF_51: USA Standard Products PF_56: India Portfolio
PF_52: Brasil Portfolio PF_57: AMCA Germany Products
PF_53: AMCA USA Products PF_59: AMCA India Product Portfolio
PF_60: Cina PF_61: Europa
gamma_produttu
I fan sò posti in clusters aka gamme di prudutti, indicati da i codici BR elencati quì sottu.
product_range ùn hè micca ubligatoriu è pò cuntene parechji codici BR separati da |, per esempiu BR_01 | BR_57 | BR_59
cuncepimentu_produttu
Ogni articulu pò vene in unu di una multitùdine di disinni. Lasciate viotu se u disignu ùn hè micca cunnisciutu
Opzioni di input
Ventilatori di flussu assiale cù a direzzione di flussu d'aria A: L'aria hè aspirata sopra u mutore
AA: Ventilatore assiale custituitu solu di girante
AD : Ventilateur axial aspirant à travers la grille
AF: Ventilatore assiale tubu cù tubu più longu, carcassa tonda
AL: Ventilatore assiale di tubu cù tubu più cortu, carcassa tonda
AQ: Ventilatore assiale di tubu cù tubu più cortu, carcassa rettangulare
AW : Ventilateur axial aspirant à travers la grille
Ventilatori di flussu assiale cù a direzzione di u flussu d'aria V: L'aria hè soffiata sopra u mutore
VA: Ventilatore assiale custituitu solu di l'impeller
VE: Ventilatore assiale di tubu cù tubu più cortu è succione attraversu a prutezzione di cuntattu
VF: Ventilatore assiale à tubu cù tubu assai longu
VH: Ventilatore assiale di tubu cù tubu più cortu, carcassa tonda
VH: Ventilatore assiale à tubu murale cù tubu più cortu è palette di guida
VL: Ventilatore assiale à tubu murale cù tubu più cortu è palette di guida
VQ: Ventilatore assiale à tubu murale cù tubu più cortu è palette di guida
VI: Ventilatore assiale chì soffia attraversu a griglia
VK: Ventilatore assiale chì soffia attraversu a griglia
VL: Ventilatore assiale di tubu cù tubu più cortu, carcassa tonda
VQ: Ventilatore assiale di tubu cù tubu più cortu, carcassa rettangulare
VS: Ventilatore assiale chì soffia à traversu a griglia, circundante tutta a parte posteriore di u ventilatore
Ventilatori centrifugi
ER: Disegnu di ventilatore centrifugu
GR-H: Disegnu di ventilatore centrifugu muntatu à u muru, muntatu orizzontalmente
GR-Vo: Disegnu di ventilatore centrifugu à u muru, muntatu verticalmente rivoltu in sopra
GR-Vu: Disegnu di ventilatore centrifugu à u muru, muntatu verticalmente versu u fondu
GR: Disegnu di ventilatore centrifugu à muru
RH: Ventilatore centrifugu custituitu solu di impeller
WR: Ventilatore centrifugu pusatu in u disignu di cubi
fan_type
Filtrà definendu parte di a chjave di u tipu di fan. I caratteri salvatichi sò: * per parechje caratteri è ? per 1 caratteru.
Esempiu: GR56C * 1C per uttene tutte e giranti di taglia 560 C in u disignu GR, ER??I-4 * per uttene tutte ZAbluefin in u disignu ER
articulu_nr
U numeru di l'articulu (se cunnisciutu) di u fan necessariu.
I numeri di l'articuli multipli ponu esse inseriti in una volta, ognuna siparata da un |, cum'è: 178125 | 178153 | 178113.
fan_size
dimensione di i fanali necessarii (se cunnisciutu)
funziunamentu di rete
Sceglie se u fan necessariu deve esse cunnessu à un controller o micca.
Opzioni di input:
NETZ: Ventilatore direttamente cunnessu à a rete elettrica
FZ: Ventilatore cunnessu à u convertitore di frequenza
tecnulugia_mutore
Sceglie u tipu di mutore più adattatu per a vostra applicazione. Scelte multiple pò esse input siparati da un |
per esempiu: ZAmotpremium IE2 | PMblue IE4 | ZAmotpremium IE3
Opzioni di input:
AC ERM: Motore AC à rotore esternu
AMblue IE3: Rotor internu IE3 mutore cù controller
ECblue: Motori EC à rotore esternu
ECQ: Motore EC à rotore esternu
PMblue IE4: Motore di rotore internu IE4 à magnete permanente
PMblue Standalone: Motore di rotore internu IE4 à magnete permanente senza controller
ZAmotbasic EX: Motore ATEX di rotore internu à pocu costu
ZAmotbasic IE2: Motore IE2 di rotore internu low cost
ZAmotbasic IE3: Low Cost i Motore IE3 di rotore internu
ZAmotpremium IE2: Motore IE2 di rotore internu premium
ZAmotpremium IE3: Motore IE3 di rotore internu premium
ZAmotpremium PE: Rotore internu premium Motore Premium Efficiency (USA).
fase_corrente
Fasi di corrente elettrica.
Opzioni di input:
1 o 3.
voltage
Elettricu voltage
Opzioni di input:
230 400 460 690
frequenza_nominale
Frequenza nominale elettrica.
Opzioni di input:
50 60
ricerca_tolleranza
Tolleranza di selezzione necessaria
margine_di_sicurezza_motore
Riserva di putenza di u mutore, se necessariu
p.e. motor_safety_margin = 10 => 10 kW a putenza di l'arbre richiede un mutore di 11 kW
airflow_volume_reserve
Riserva volumetrica di flussu d'aria, se necessariu
per esempiu, airflow_volum_reseve = 10 => 1000 m³/h u flussu necessariu significa chì u ventilatore deve furnisce 1100 m³/h
densità_aria
Densità di l'aria operante di u fan. A selezzione di u fan è i calculi di u puntu di duty si adattanu à a densità.
temperatura_ambienti
Temperature Medium à quale u ventilatore funziona
grill_influence
Applicabile solu à i ventilatori centrifughi
Opzioni di input:
falsu: ùn hè micca cunsideratu grill
True: i calculi di u puntu di duty chì affettanu u funziunamentu di u fan è l'acustica piglianu in contu a grill
altezza_installazione_mm
Altezza di l'armadiu in mm. U piazzamentu di i fanali in l'involucri richiede e dimensioni in generale di questi recinzioni. U più chjucu u recinte hè relative à a dimensione di u fan, u più dannosu hè per u rendiment di u fan.
larghezza_installazione_mm
Larghezza di l'armadiu in mm.
lunghezza_installazione_mm
Lunghezza di l'armadiu in mm.
installazione_mode
E perdite di rendiment di l'enclosure sò calculate da algoritmi specifichi. FANselect offre più algoritmi di calculu di perdita per i fan unichi, ma solu unu (RLT_2017) per i layout multipli di fan.
Opzioni di input:
ZA: Algoritmu sviluppatu in casa
RLT_2017: L'algoritmu più recente sviluppatu da l'Associazione di Fabbricanti AHU
prutezzione_class
Ingressu necessariu classa di prutezzione cum'è un numeru IPxx.
erp_class
Input ERP (Energy Related Products-Directive) classa ie 2015.
A classa ErP definisce l'efficienza minima chì un fan pò esse vendutu in certi mercati
sfp_class
Input SFP (Specific Fan Performance) Classe cum'è un cifru, vale à dì 3, 4. SFP hè basicamente a putenza elettrica di input in relazione à u flussu d'aria di output.
full_octave_band
Per vede a banda d'ottava cumpleta cù cmd: search, stabilisce stu paràmetru à veru.
inserisci_valori_nominali
Pone stu paràmetru à veru per vede tutti i valori nominali elettrici cù cmd: search.
inserisci_dati_motore
Pone stu paràmetru à veru per vede i dati di moor pertinenti cù cmd: search.
inserisci_dati_geo
Pone stu paràmetru à veru per rapprisenta e dimensioni di l'articulu
focus_criteri
Stu paràmetru vi permette di limità l'inseme trovu à quelli fans cù i migliori criterii di focus chì avete stabilitu.
Opzioni di input:
ZA_ETASF_SYS: U megliu ...% à l'efficienza statica di u sistema
ZA_PSYS: U megliu ...% à a putenza assorbita di u sistema
ZA_LWA5: U megliu ...% à l'acustica di u latu di aspirazione
ZA_LWA6: U megliu ...% à l'acustica di u latu di pressione
ZA_BG: U megliu ...% à a dimensione di u fan
focus_tolerance
Stabilisce stu paràmetru à 0 pruduce solu un articulu, à dì quellu cù u megliu focus_crteria predefinitu. Ingressu un numeru X pruducia u megliu fan per u focus_criteria predeterminatu più tutti i fanali finu à X% peggiu di u megliu fan.
per esempiu: focus_criteria = ZA_ETASF_SYS è focus_tolerance = 7
rende: Fan cù u megliu efficienza statica di u sistema + tutti i fanali finu à u 7% peghju di quellu megliu fan
pricelist_name
Ingressendu u nome di u fogliu Excel chì si trova in u cartulare DLL: Product_Price_Reference..xls, pudete avè u prezzu cumparisce trà e outputs di DLL. Excel file hà una foglia di calculu cù trè colonne.
Colonna 1: Numeru d'articulu di u cliente. Quì ogni sistema numericu pò esse usatu.
Colonna 2: Ziehl-Abegg nùmeru d'articulu, chì hè utilizatu per i calculi di selezzione
Colonna 3: U prezzu di stu articulu
Tutti i Outputs Spiegati
ARTICLE_NO Numeru d'articulu
CALC_AIR_DENSITY Densità di l'aria utilizata in a selezzione è u calculu (kg/m³)
CALC_ALTITUDE Altitudine utilizata in a selezzione è u calculu (m sopra u livellu di u mari)
CALC_LW5_OKT Banda d'ottava laterale di aspirazione, valori separati da virgole (dB)
CALC_LW6_OKT Banda d'ottava laterale di pressione, valori separati da virgule (dB)
CALC_LWA5_OKT Valori di banda d'ottava ponderati di u latu di aspirazione (dBA)
CALC_LWA6_OKT Valori di banda d'ottava ponderati di u latu di pressione (dBA)
CALC_NOZZLE_PRESSURE Pressione in ugello, utilizata per determinà u flussu d'aria (Pa)
CALC_N_RATED Rapportu di rpm di u ventilatore di u puntu di impiegu à u rpm massimu di u fan (%)
CALC_P1_MAX Potenza elettrica massima assorbita à u puntu di impiegu (W)
CALC_PL_MAX Potenza massima assorbita à l'arbre à u puntu di impiegu (W)
CALC_PSYS_MAX Massima putenza assorbita di u sistema = motore + putenza assorbita di u controller (W)
CALC_TEMP_C Température moyenne (°C)
CAPACITOR_CAPACITANCE Capacità di u condensatore (??F)
CAPACITOR_VOLTAGE Capacitor voltage (V)
CHART_VIEWER_URL URL per graficu chì raffiguranu curve di fan
CIRCUIT Tipu di circuitu elettricu
COSPHI Fan motor Cosinu Phi
CURRENT_PHASE Fasi di u mutore di u fan
dim_... Dimensioni di u fan
dim_klischee Cliche name => disegnu simplificatu cù dimensioni impurtanti
DENSITY_INFLUENCE Densità aduprata per a determinazione di a densità di misurazione di u puntu di duty => Selezzione à a densità di densità misurata di u fan => Selezzione à a densità diversa da a densità misurata
DISEGNU_FILE Percorsu à u fan drawing
EC_TYPE L'output hè 1 se u fan hè alimentatu da un mutore EC è una stringa viota se u mutore di u fan ùn hè micca un mutore EC
EFFICIENCY_CLASS Classe di efficienza di u mutore IEC. I paràmetri si prisentanu solu à fiancu à i fanali alimentati da i mutori IEC
EFFICIENCY_STAT Efficienza statica di u fan = Velocità Volumetrica X Pressione Statica / Potenza Assorbita da u Sistema (%)
EFFICIENCY_TOT Efficienza totale di u ventilatore = Velocità Volumetrica X Pressione Statica / Potenza Assorbita da u Sistema (%)
ERP_CLASS Fan ERP class
ERP_METHOD Metudu utilizatu per misurà a classe ERP
ERP_N_ACTUAL Gradu di efficienza normalizatu attuale (Nist)
ERP_N_STAT Efficienza statica (hstatA) à u puntu di duty (%) secondu u metudu di misura A
ERP_N_TRAGET Gradu d'efficienza standardizatu necessariu (Nsoll)
ERP_VSD Ritorna u controller EC integratu se u ventilatore hè cusì equipatu. è una stringa viota per i fanali senza un sistema integratu di cuntrollu di velocità
FAN_EFFICIENCY_GRADE Questu hè un fattore assignatu à i fan individuali è hè pertinente solu per i fan di AMCA
FEI_FACTOR Stu fattore hè calculatu basatu annantu à u puntu di duty è hè pertinente solu per i fan di AMCA
GRILL_INFLUENCE Ritorna no se l'influenza di grill ùn hè micca fattu in i calculi, è sì se l'influenza di grill hè presa in contu.
INCREASE_OF_CURRENT Aumentu attuale (%)
INDICE Numeru di sequenza di fan in u set trovu. U primu fan in l'inseme trovu averia l'indice 0, u sicondu fan index 1 etc.
INSTALLATION_HEIGHT_MM Altezza di u ventilatore (mm)
INSTALLATION_LENGTH_MM Lunghezza di u ventilatore (mm)
INSTALLATION_POS Restituisce l'orientazione(i) di u ventilatore: H: Orizzontale VO: Verticale rivolta in su VU: Verticale rivolta in giù
INSTALLATION_POS_H Restituisce 1 per i fan orientati orizontali (INSTALLATION_POS = H), è una stringa viota per i fan rimanenti.
INSTALLATION_POS_VO Restituisce 1 per i ventilatori verticali rivolti in su (INSTALLATION_POS = VO) è una stringa viota per i fan rimanenti
INSTALLATION_POS_VU Restituisce 1 per i ventilatori verticali rivolti in basso (INSTALLATION_POS = VU) è una stringa vuota per i ventilatori rimanenti
INSTALLATION_WIDTH_MM Larghezza di u ventilatore (mm)
IS_EC Restituisce 1 se u ventilatore hà un mutore EC è una stringa viota per i motori non-EC
KFACTOR Pressione ugello di u fan
MAX_CURRENT Corrente massima di u ventilatore (A)
MAX_FREQUENCY Frequenza massima di u ventilatore (Hz)
MAX_TEMPERATURE_C Temperatura massima di u ventilatore (°C)
MAX_VOLTAGE Fan's maximum voltage (V)
MDRAWING Nome di u disegnu file
MIN_CURRENT Corrente minima di u ventilatore (A)
MIN_TEMPERATURE_C Température minimale du ventilateur (°C)
MIN_VOLTAGE Fan's maximum voltage (V)
MOTOR_DESIGN Tipu di disignu di u mutore: (solu per i mutori IEC)
IMB 3: Pede muntatu
IMB 5: Monté à bride
MOTOR_POLES Numeru di poli di u mutore (per i ventilatori alimentati IEC)
MOTOR_SHAFT Descrizzione di l'arbre di u mutore IEC: numeru / diametru X lunghezza
MOTOR_SIZE taglia di mutore IEC
NOMINAL_CURRENT Courant nominale du moteur du ventilateur (A)
NOMINAL_FREQUENCY Frequenza nominale di u mutore di ventilatore (Hz)
NOMINAL_IECMOTOR
_EFFICIENCY IEC Motor efficienza nominali cum'è un numeru decimali
NOMINAL_SPEED Velocità nominale di u ventilatore (1/min)
NOMINAL_VOLTAGE Vol. nominale du moteur du ventilateurtage
NOZZLE_GUARD Infurmazioni nantu à cumu si misurà u fan. Prevalentemente per i ventilatori assiali
NUMBER_OF_POLES mutore IEC numeru di poli
PHASE_DIFFERENCE Differenza di fasi
POWER_INPUT_KW Potenza necessaria da u mutore (kW)
POWER_INPUT_KW Potenza di u mutore (kW)
PRODUCT_IMG Percorsu à l'imaghjini di u produttu
PROTECTION_CLASS_IP Classe di prutezzione cum'è numeru IP
PROTECTION_CLASS_THCL Classe di prutezzione di a temperatura cum'è numeru THCL
RUBBER_MOT_DIAMETER Motor gomma dampu diametru
RUBBER_MOT_HEIGHT Motor gomma dampa altezza
SPRING_MOT_DIAMETER Molla di mutore dampu diametru
SPRING_MOT_HEIGHT Molla di mutore dampa altezza
TYPE Tippu chjave di u fan
VOLTAGE_TOLERANCE Voltage tolleranza (%)
ZAWALL_ARRANGEMENT Disposizione multipla di fan. Ritorna 0 se ùn sò micca selezziunati parechji fan
ZA_BG Dimensione nominale di u fan
ZA_COSPHI Fan motor Cos Phi
ZA_ETAF Efficienza totale di u ventilatore = Velocità Volumetrica X Pressione Totale / Potenza Assorbita da u Sistema (%)
ZA_ETAF_L Efficienza totale della girante del ventilatore (%)
ZA_ETAF_SYS Efficienza totale di u sistema (%)
ZA_ETAM Efficienza di u mutore (%)
ZA_ETASF Efficienza statica di u ventilatore = Velocità Volumetrica X Pressione Statica / Potenza Assorbita da u Sistema (%)
ZA_ETASF_L Efficienza statica della girante del ventilatore (%)
ZA_ETASF_SYS Efficienza statica di u sistema (%)
ZA_F Frequenza elettrica nominale di u ventilatore (Hz)
ZA_FBP Frequenza elettrica di u ventilatore à u puntu di travagliu (Hz)
ZA_I Courant du ventilateur au point de service (A)
ZA_IN Courant nominal du ventilateur (A)
ZA_LW5 Livellu di putenza acustica di u puntu di u latu di aspirazione (dB)
ZA_LW6 Latu di pressione di u livellu di putenza acustica di u puntu di serviziu (dB)
ZA_LWA5 Latu di aspirazione di u livellu di putenza acustica ponderata di u puntu di impiegu (dBA)
ZA_LWA6 Latu di pressione di u livellu di putenza acustica ponderata di u puntu di impiegu (dBA)
ZA_MAINS_SUPPLY Alimentazione di rete : fasi, voltage è frequenza elettrica
ZA_N RPM à u puntu di travagliu (1/min)
ZA_NMAX RPM massimu di ventilatore (1/min)
ZA_PD Pressione dinamica à u puntu di duty (Pa)
ZA_PF Pressione tutale di u fan. ZA_PF = ZA_PSF + ZA_PD (Pa)
ZA_PF_MAINS_OPERATED Pressione totale di u ventilatore in u funziunamentu di rete (Pa)
ZA_PSF Pressione statica di u ventilatore (Pa)
ZA_PSF_MAINS_OPERATED Pressione statica di u ventilatore in u funziunamentu di rete (Pa)
ZA_P1 Potenza elettrica necessaria à u puntu di serviziu (W)
ZA_PD Pressione dinamica di u puntu di duty (Pa)
ZA_PF Pressione totale di u puntu di travagliu (Pa)
ZA_PL Puissance à l'arbre calculée au point de service (W)
ZA_PSF Pressione statica di u puntu di travagliu (Pa)
ZA_PSYS Potenza assorbita da u sistema (W)
ZA_QV Débit volumétrique au point de service (m³/h)
ZA_QV_MAINS_OPERATED Duty point débit volumétrique en fonctionnement réseau (m³/h)
ZA_SFP SFP numeru di fan
ZA_SFP_CLASS Classe SFP di Fan
ZA_U Fan voltage au point de service (V)
ZA_UN Fan nominale voltage (V)
ZA_WEIGHT Massa di fan
Outputs di ogni cmd
cmd: ricerca Outputs
| ARTICLE_NO | CALC_AIR_DENSITY | CALC_ALTITUDE |
| CALC_NOZZLE_PRESSURE | CALC_N_RATED | DENSITY_INFLUENCE |
| DISEGNU_FILE | ERP_CLASS | ERP_METHOD |
| ERP_N_ACTUAL | ERP_N_STAT | ERP_N_TRAGET |
| ERP_VSD | FAN_EFFICIENCY_GRADE | FEI_FACTOR |
| GRILL_INFLUENZA | INDICE | INSTALLATION_HEIGHT_M M |
| INSTALLATION_LENGTH_M M | INSTALLAZIONE_POS | INSTALLAZIONE_POS_H |
| INSTALLATION_POS_VO | INSTALLATION_POS_VU | INSTALLATION_WIDTH_MM |
| IS_EC | IS_VALID | KFACTOR |
| NOZZLE_GUARD | PRODUCT_IMG | TIPU |
| ZAWALL_ARRANGEMENT | ZA_BG | ZA_COSPHI |
| ZA_ETAF_SYS | ZA_ETAF_SYS_ MAINS_OPERATED | ZA_F |
| ZA_FBP | ZA_I | ZA_LW5 |
| ZA_LW6 | ZA_LWA5 | ZA_LWA6 |
| ZA_MAINS_SUPPLY | ZA_N | ZA_NMAX |
| ZA_PD | ZA_PF | ZA_PF_MAINS_OPERATED |
| ZA_PSF | ZA_PSF_MAINS_OPERATE D | ZA_PSYS |
| ZA_QV | ZA_QV_MAINS_OPERATED | ZA_SFP |
| ZA_SFP_CLASS | ZA_U | ZA_UN |
| ZA_PESO |
cmd: selezziunà Outputs
Questu cmd richiede chì inserite un numeru d'articulu in article_no.
| ARTICLE_NO | CALC_AIR_DENSITY | CALC_ALTITUDE |
| CALC_LW5_OKT | CALC_LW6_OKT | CALC_LWA5_OKT |
| CALC_LWA6_OKT | CALC_NOZZLE_PRESSURE | CALC_N_RATED |
| CAPACITOR_CAPACITANCE | CAPACITOR_VOLTAGE | CHART_VIEWER_URL |
| CIRCUITU | COSPHI | CURRENT_PHASE |
| DENSITY_INFLUENCE | DISEGNU_FILE | EC_TYPE |
| EFFICIENCY_STAT | EFFICIENCY_TOT | ERP_CLASS |
| ERP_METHOD | ERP_N_ACTUAL | ERP_N_STAT |
| ERP_N_TRAGET | ERP_VSD | FAN_EFFICIENCY_GRADE |
| FEI_FACTOR | GRILL_INFLUENZA | INCREASE_OF_CURRENT |
| INSTALLAZIONE_HEIGHT_MM | INSTALLATION_LENGTH_MM | INSTALLAZIONE_POS |
| INSTALLAZIONE_POS_H | INSTALLATION_POS_VO | INSTALLATION_POS_VU |
| INSTALLATION_WIDTH_MM | IS_EC | IS_VALID |
| KFACTOR | MAX_CURRENT | MAX_TEMPERATURE_C |
| MAX_VOLTAGE | MIN_CURRENT | MIN_TEMPERATURE_C |
| MIN_VOLTAGE | FREQUENZA_NOMINALE | NOMINAL_SPEED |
| NOMINAL_VOLTAGE | NOZZLE_GUARD | PHASE_DIFFERENCE |
| POWER_INPUT_KW | PRODUCT_IMG | PROTECTION_CLASS_IP |
| PROTECTION_CLASS_THCL | TIPU | VOLTAGE_TOLERANCE |
| ZAWALL_ARRANGEMENT | ZA_BG | ZA_COSPHI |
| ZA_ETAF_SYS | ZA_ETAF_SYS_ MAINS_OPERATED | ZA_ETASF_SYS |
| ZA_ETASF_SYS_ MAINS_OPERATED | ZA_F | ZA_FBP |
| ZA_I | ZA_LW5 | ZA_LW6 |
| ZA_LWA5 | ZA_LWA6 | ZA_MAINS_SUPPLY |
| ZA_N | ZA_NMAX | ZA_PD |
| ZA_PF | ZA_PF_MAINS_OPERATED | ZA_PSF |
| ZA_PSF_MAINS_OPERATED | ZA_PSYS | ZA_QV |
| ZA_QV_MAINS_OPERATED | ZA_SFP | ZA_SFP_CLASS |
| ZA_U | ZA_UN | ZA_PESO |
cmd: nominal_values Outputs
Stu cmd richiede un numeru d'articulu in article_no.
L'outputs quì sottu ponu ancu esse output cù a ricerca di cmd mettendu insert_nominal_values à true
| ARTICLE_NO | CAPACITOR_CAPACITANCE | CAPACITOR_VOLTAGE |
| CIRCUITU | COSPHI | CURRENT_PHASE |
| EC_TYPE | EFFICIENCY_STAT | EFFICIENCY_TOT |
| INCREASE_OF_CURRENT | MAX_CURRENT | MAX_FREQUENZA |
| VELOCITÀ MASSIMA | MAX_TEMPERATURE_C | MAX_VOLTAGE |
| MIN_CURRENT | MIN_PSF | MIN_TEMPERATURE_C |
| MIN_VOLTAGE | NOMINAL_CURRENT | FREQUENZA_NOMINALE |
| NOMINAL_SPEED | NOMINAL_VOLTAGE | PHASE_DIFFERENCE |
| POWER_INPUT_HP | POWER_INPUT_KW | POWER_OUTPUT_HP |
| POWER_OUTPUT_KW | PROTECTION_CLASS_IP | PROTECTION_CLASS_THCL |
| VOLTAGE_TOLERANCE |
cmd: get_chart Outputs
Stu cmd richiede un numeru d'articulu in article_no, è pruduce l'outputs sottu è e curve di fan
| BOTTOM_MARGIN | CHART_FILE | CHART_MAX_X |
| CHART_MAX_Y | CHART_MIN_X | CHART_MIN_Y |
| LEFT_MARGIN | MEASUREMENT_ID | RIGHT_MARGIN |
| MARGINE_TOP |
cmd: motor_data Outputs
Per i Motori EC:
| CIRCUITU | NOMINAL_VOLTAGE | PROTECTION_CLASS_IP |
PER I Motori IEC:
| CIRCUITU | EFFICIENCY_CLASS | MOTOR_DESIGN |
| MOTOR_HAFT | MOTOR_SIZE | NOMINAL_CURRENT |
| NOMINAL_VOLTAGE | NUMBER_OF_POLI | POWER_OUTPUT_KW |
| PROTECTION_CLASS_IP | RUBBER_MOT_DIAMETER | RUBBER_MOT_HEIGHT |
| SPRING_MOT_DIAMETER | PRIMAVERA_MOT_HEIGHT |
cmd : Status Outputs
Questu cmd hè utile per ottene a versione di DLL è u nome d'utilizatore di l'utilizatore
| USERNAME | VERSIONE |
cmd: create_session Outputs
Stu cmd hè utilizatu per creà una sessione, prima di chjamà u web DLL
| USERNAME | VERSIONE |
Aiutu è Supportu
Informazioni di cuntattu
Per piacè, sentite liberu di cuntattateci, se avete bisognu di più aiutu o cunsigliu nantu à cumu integrà l'API FANselect in a vostra applicazione.
Cuntattu
Supportu FANselect
Tecnulugia di Ventilazione
Heinz-Ziehl-Straße - 74653 Künzelsau
fanselect@ziehl-abegg.com
www.fanselect.net
www.ziehl-abegg.com
Ligami
Ziehl-Abegg
www.ziehl-abegg.com
FANselect DLL Download
www.ziehl-abegg.com/fileadmin/de/de/03_Produktwelten/DigitaleLösungen/Software/FANselect/FANselect_DLL.zip
FANselect Web API
fanselect.net:8079/FSWebserviziu
Articulu Images è Disegni
http://www.ziehl-abegg.com/fileadmin/de/de/05_Support/Software/FANselect/catalog.zip
Storia di u documentu
04.11.2019
- Prima liberazione
12.08.2021
- Novu disignu di u documentu
- Aghjurnate ERP_... descrizzione
- Aghjunghjite novi portafogli
- Aghjunghjite una nova descrizzione di variabili di output per dimensioni
Documenti / Risorse
 |
ZIEHL-ABEGG FANselect DLL API Programming Interface [pdfGuida di l'utente FANselect DLL, FANselect DLL Interfaccia di prugrammazione API, Interfaccia di prugrammazione API, Interfaccia di prugrammazione |