ZIEHL-ABEGG FANVælg DLL API-programmeringsgrænseflade
Indledning
FANselect DLL'en fungerer som en applikationsprogrammeringsgrænseflade til FANselect. Det kræver en anmodningsstreng som input og udsender en svarstreng.
Både anmodnings- og svarstrenge kan formateres som JSON eller XML. Det er op til den kaldende applikation at oprette det nødvendige input og analysere API'ens output.
Denne API kan være:
Downloadet (som en Windows DLL) ved at klikke på linket www.ziehl-abegg.com/fileadmin/de/de/05_Support/Software/FANselect/FANselect_DLL.zip eller tilgås via web via http://fanselect.net:8079/FSWebService
Du kan tilmelde dig her https://www.ziehl-abegg.com/digitale-loesungen/software/fanselect for det nødvendige FAN, vælg login for at bruge DLL'en.
Den downloadbare FANselect DLL-mappe kan placeres hvor som helst på din maskine. Det er vigtigt at holde mappen intakt og opdateret. Din applikation skal have adgang til fanselect.dll file inde i denne mappe.
Sådan opdaterer du din version af DLL'en:
- Download den nye DLL-mappe fra URL over
- Slet din faktiske DLL-mappe
- placer den nye DLL-mappe på den placering, der er forladt af din tidligere DLL-mappe
FANselect web API er altid opdatering og kræver derfor ikke, at brugeren opdaterer.
I hver DLL-mappe er der et testværktøj, kaldet ZADllTest.exe eller ZADllTest64.exe, som du kan teste input- og outputstrenge med.
Billede 1: Venstre er inputområdet, mens højre side indeholder output produceret af DLL'en. Klik på fanen Tekst øverst til venstre for at se den genererede anmodningsstreng.
Du kan teste inputtet ved at indtaste de ønskede parametre i formularen (Billede 1). I tryk på "Tekst" kan du skrive eller kopiere json-stikket (f.eksampse 2.1.) i.
Opret forbindelse til FANselect DLL
Minimum nødvendige input:
brugernavn: Din FANselect-kontos brugernavn
adgangskode: Din FANselect-kontos adgangskode
cmd: Søg (forklaret i afsnit 2.2)
qv: Driftspunktets volumetriske flowhastighed
psf: Driftspunktets statiske tryk
spec_products: Portefølje, der indeholder nødvendige ventilatorer (forklaret i afsnit 3.1)
sprog: Vælg sprog, som output skal vises på (forklaret i afsnit 3.1)
Med disse minimale input skal din anmodningsstreng se ud som sampnedenstående:
JSON Request String example
{
"brugernavn": "ZAFS19946"
"adgangskode": "bnexg5",
"cmd" : "søg",
"qv" : "2500",
"psf" : "50",
"spec_products" : "PF_00",
"sprog": "EN",
}
Identisk anmodningsstreng som XML:
ZAFS19946
bnexg5
søge
2500
50
PF_00
DA
Programmering af en DLL-læser
Du kan få adgang til DLL'en via en af tre funktioner.
ZAJsonRequestW: Til Unicode-strenge
ZAJsonRequestA: Til UTF-8 strenge
ZAJsonRequestBSTR: Til OLE-objekter
Din DLL-læser skal sende anmodningsstrengen som et argument til en af funktionerne ovenfor og derefter læse DLL'ens output.
DLL Reader funktion i Python
def za_dll_fan_selection(request_string, dll_path):
importere ctypes
importere json
fanselect_dll = ctypes.WinDLL(dll_path)
fanselect_dll_output = (ctypes.wstring_at(fanselect_dll.ZAJsonRequestW(request_string)))
returner fanselect_dll_output
request_string er identisk med Request String example ovenfor, dog med flere input
dll_path: er stien til FANselect DLL'en, f.eks. C.\FANselect_DLL\FANselect_DLL}fanselect.dll
DLL Reader funktion i VBA
Privat erklæringsfunktion ZAJsonRequestBSTR Lib
"C:\FANselect_DLL\FANselect_DLL\FANselect.dll" (ByVal sRequest As String) Som String
Offentlig funktion vba_reader(ByVal input_request_string Som streng) Som streng
Dim request_string Som streng
Dim response_string Som streng
Dim request_string_unicode Som variant
Dim response_string_unicode Som variant
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 = svar_streng
Afslut funktion
Yderligere Examples kan downloades fra nedenstående links
C++ http://downloads.fanselect.net//fanselect/dll_examples/CPPConsoleApp.zip
C# http://downloads.fanselect.net//fanselect/dll_examples/VCS10StandardApp.zip
Delphi 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
Opret forbindelse til FANselect Web API
Adgang til FANselect's web API er næsten identisk med den proces, der bruges til at få adgang til DLL'en.
Den eneste forskel er, at du skal sende to anmodninger:
1. anmodning: For at få et sessions-id
2. anmodning: Sædvanlig anmodning, som inkluderer sessions-id'et opnået i den første anmodning
Den store advantage af web API er, at det (som før nævnt) altid er opdateret og ikke kræver at blive downloadet. Undersøg venligst internetpålideligheden i din placering og din maskines firewall/sikkerhedsindstillinger, da disse kan hamper den web API's ydeevne.
Som med den downloadbare DLL, anmodninger til og svar fra web API kan sendes som JSON- eller XML-strenge.
Både DLL og web API producerer identiske output, da begge bruger de samme udvælgelses- og beregningsalgoritmer. Eventuelle uoverensstemmelser mellem DLL og web API, skyldes sandsynligvis en forældet DLL.
Web API Reader funktion i Python
importere json
dll_path = "http://fanselect.net:8079/FSWebService"
def za_api_fan_selection_0(request_string, dll_path):
importanmodninger
fanselect_api_output = requests.post(url=dll_sti, data=anmodningsstreng)
returner fanselect_api_output
# Få sessions-id
request_string = "{'cmd':'create_session', 'username' : 'BRUGERNAVN', 'adgangskode' : 'PASSWORD' }"
request_string = str(request_string)
dll_sti = str(dll_sti)
response_string = za_api_fan_selection_0(request_string, dll_path)
session_id = json.loads(response_string_raw.content)['SESSIONID']
# Sædvanlig anmodning
request_string = "{"
request_string = request_string + "'brugernavn' : 'BRUGERNAVN',"
request_string = request_string + "'adgangskode' : 'PASSWORD',"
request_string = request_string + "'sprog' : 'DA',"
request_string = request_string + "'unit_system' : 'm',"
request_string = request_string + "'cmd': 'søg',"
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 + "'nominel_frekvens': '50',"
request_string = request_string + "'sessionid' : '" + session_id + "',"
request_string = request_string + "'full_octave_band': 'true',"
request_string = request_string + "}"
request_string = str(request_string)
response_string_initial = za_api_fan_selection_0(request_string, dll_path)
Yderligere Examples kan downloades fra nedenstående links
C# http://downloads.fanselect.net/fanselect/dll_examples/VCS10WebService.zip
VB10 http://downloads.fanselect.net//fanselect/dll_examples/VB10WebService.zip
Input & Outputs
Alle input forklaret
sprog
Indstil sprog for udgange
input muligheder:
CS: tjekkisk DA: dansk DE: tysk DA: engelsk
ES: spansk FR: fransk FI: finsk HU: ungarsk
DET: italiensk JA: japansk NL: hollandsk PL: Polere
PT: portugisisk Storbritannien: russisk SV: svensk TR: tyrkisk
ZH: kinesisk
enhed_system
enhedssystem, der skal bruges i beregninger.
Indtastningsmuligheder:
m: metrisk i: kejserlig
brugernavn
Din FANselect-kontos brugernavn.
adgangskode
Din FANselect-kontos adgangskode
Brugere, der kun er interesseret i et begrænset sæt artikler, kan erhverve en eller flere brugernavn/adgangskodekombinationer (login). Hvert login ville tilbyde et specifikt sæt artikler – foruddefineret af brugeren.
Brugerens applikation vil derefter kalde dll'en med et af disse specifikke logins for at vælge fra en begrænset pulje af artikler. Advantages: Hurtigere udvælgelsesproces og mindre antal artikler blandt fundne sæt
cmd
cmd, forkortelse for kommando, er nødvendig for at instruere DLL'en om den type output, der kræves
Indtastningsmuligheder:
søgning: valg efter driftspunkt + filtre som størrelse, design osv.
status: Leverer brugernavn og softwareversion. Web API udsender også SESSIONID.
create_session: Få SESSIONID. Denne cmd er kun relevant for web API
Følgende cmd'er kræver et artikelnummer i artikelnr: vælg: Vælg efter artikelnummer. Artiklens nominelle data udlæses, hvis driftspunktet ikke opnås
nominelle_værdier: Få artiklens elektriske nominelle værdier. Disse data opnås også med din indledende søgeanmodning ved at sætte insert_nominal_values til sand
motor_data: Artikelmotordata. Kan også fås med søgning og insert_motor_data: true
geo_data: Artikel (geometriske) dimensioner. Få disse data med søgning ved at indstille insert_geo_data til sand
tilbehør: Afbilder tilbehør forbundet med artiklen
get_chart: Opret diagrammer for den valgte artikel
cmd_param
Du kan indstille indekset for den artikel, du ønsker
zawall_mode
Vælg, om du vil vælge flere fans, med en af to muligheder
ZAWALL: Vælg kun ved brug af flere blæsere
ZAWALL_PLUS: Vælg ved at bruge flere og enkelte fans
zawall_størrelse
Indstil antallet af blæsere, du vil bruge i dit array med flere blæsere. Det maksimale antal blæsere er sat til 20.
zawall_size kan også stå tom. FANselect bestemmer automatisk antallet af krævede blæsere.
Valg uden et forudindstillet antal blæsere har normalt en længere responstid.
qv
Volumetrisk hastighed enten i m³/h for unit_system choice m eller CFM for unit_system choice i.
psf
Statisk tryk enten i Pa for unit_system choice m eller i wg for unit_system choice i.
pf
Samlet tryk enten i Pa for unit_system choice m eller i wg for unit_system choice i
I din anmodningsstreng angiver du enten psf eller pf.
spec_produkter
Fans i FANselect er placeret i diskrete porteføljer, angivet med PF-koderne, der er angivet nedenfor. Det er obligatorisk at indtaste en specifik portefølje. I øjeblikket er det ikke muligt at vælge på tværs af flere porteføljer.
Indtastningsmuligheder
PF_50: Standard på verdensplan PF_54: AMCA Thailand-produkter
PF_51: USA standardprodukter PF_56: Indien Portfolio
PF_52: Brasil Portfolio PF_57: AMCA Germany-produkter
PF_53: AMCA USA-produkter PF_59: AMCA India-produktportefølje
PF_60: Kina PF_61: Europa
produktsortiment
Ventilatorer er placeret i klynger aka produktserier, angivet med BR-koderne anført nedenfor.
product_range er ikke obligatorisk og kan indeholde flere BR-koder adskilt af |, f.eks. BR_01 | BR_57 | BR_59
produktdesign
Hver artikel kan komme i et af mange designs. Lad være tomt, hvis designet ikke er kendt
Indtastningsmuligheder
Aksialventilatorer med luftstrømsretning A: Luft suges over motoren
AA: Aksialventilator, der kun består af pumpehjul
AD: Aksialventilator suger gennem gitteret
AF: Røraksialventilator med længere rør, rundt hus
AL: Røraksialventilator med kortere rør, rundt hus
AQ: Røraksialventilator med kortere rør, rektangulært hus
AW: Aksialventilator suger gennem gitteret
Aksialventilatorer med luftstrømsretning V: Luft blæses over motoren
VA: Aksialventilator kun bestående af pumpehjul
VE: Røraksialventilator med kortere rør og gennemsugende kontaktbeskyttelse
VF: Rør aksial ventilator med meget langt rør
VH: Rør aksial ventilator med kortere rør, rundt hus
VH: Vægmonteret Rør aksial ventilator med kortere rør og styreskovle
VL: Vægmonteret Rør aksial ventilator med kortere rør og styreskovle
VQ: Vægmonteret Rør aksial ventilator med kortere rør og styreskovle
VI: Aksialventilator blæser gennem gitteret
VK: Aksialventilator blæser gennem gitteret
VL: Rør aksial ventilator med kortere rør, rundt hus
VQ: Røraksialventilator med kortere rør, rektangulært hus
VS: Aksial blæser blæser gennem gitteret, omgiver hele bagsiden af blæseren
Centrifugalventilatorer
ER: Centrifugalstikventilatordesign
GR-H: Vægmonteret centrifugalventilator design, vandret monteret
GR-Vo: Vægmonteret centrifugalventilator design, lodret monteret opad
GR-Vu: Vægmonteret centrifugalventilator design, lodret monteret nedad
GR: Vægmonteret centrifugalventilator design
RH: Centrifugalventilator kun bestående af pumpehjul
WR: Centrifugalventilator placeret i kubedesign
fan_type
Filtrer ved at definere en del af ventilatorens typenøgle. Wild cards er: * for flere karakterer og ? for 1 tegn.
F.eks.: GR56C*1C for at få alle størrelse 560 C-løbehjul i GR-design, ER??I-4* for at få alle ZAbluefin i ER-design
artikel_nr
Artikelnummer (hvis kendt) på den påkrævede ventilator.
Flere artikelnumre kan indtastes på én gang, hver adskilt af en |, såsom: 178125 | 178153 | 178113.
fan_størrelse
ventilatorstørrelse på nødvendige ventilatorer (hvis kendt)
netdrift
Vælg om den ønskede ventilator skal tilsluttes en controller eller ej.
Indtastningsmuligheder:
NETZ: Ventilator direkte forbundet til el-nettet
FZ: Ventilator tilsluttet frekvensomformer
motorteknologi
Vælg den type motor, der passer bedst til din applikation. Flere valg kan indtastes adskilt af en |
f.eks.: ZAmotpremium IE2 | PMblue IE4 | ZAmotpremium IE3
Indtastningsmuligheder:
AC ERM: Ekstern rotor AC-motor
AMblue IE3: Intern rotor IE3 motor med controller
ECblue: Ekstern rotor EC-motorer
ECQ: Ekstern rotor EC-motor
PMblue IE4: Permanent magnet IE4 intern rotormotor
PMblue Standalone: Permanent magnet IE4 intern rotormotor uden controller
ZAmotbasic EX: Lavpris intern rotor ATEX-motor
ZAmotbasic IE2: Lavpris intern rotor IE2 motor
ZAmotbasic IE3: Lavpris iIntern rotor IE3 motor
ZAmotpremium IE2: Førsteklasses intern rotor IE2 motor
ZAmotpremium IE3: Førsteklasses intern rotor IE3 motor
ZAmotpremium PE: Premium intern rotor Premium Efficiency (USA) motor
nuværende_fase
Elektriske strømfaser.
Indtastningsmuligheder:
1 eller 3.
voltage
Elektrisk voltage
Indtastningsmuligheder:
230 400 460 690
nominel_frekvens
Elektrisk nominel frekvens.
Indtastningsmuligheder:
50 60
søge_tolerance
Påkrævet udvalgstolerance
motor_sikkerhedsmargin
Motorkraftreserve, hvis det kræves
fx motor_safety_margin = 10 => 10 kW akseleffekt kræver 11 kW motor
luftstrømsvolumenreserve
Luftmængde volumetrisk reserve, hvis påkrævet
fx airflow_volum_reseve = 10 => 1000 m³/h nødvendig flow betyder, at ventilatoren skal levere 1100 m³/h
luftdensitet
Ventilatordrift lufttæthed. Blæservalg og driftspunktberegninger vil tilpasse sig tætheden.
omgivende_temperatur
Medium Temperatur, hvor ventilatoren kører
grill_indflydelse
Gælder kun for centrifugalventilatorer
Indtastningsmuligheder:
falsk: ingen grill i betragtning
sandt: Driftspunktberegninger, der påvirker ventilatorens ydeevne og akustik, tager hensyn til grillen
installationshøjde_mm
Indkapslingshøjde i mm. Placering af ventilatorer inden for kabinetter kræver de overordnede dimensioner af disse kabinetter. Jo mindre kabinettet er i forhold til blæserstørrelsen, jo mere skadeligt er det for blæserens ydeevne.
installationsbredde_mm
Kapslingsbredde i mm.
installationslængde_mm
Længde på kabinettet i mm.
installationstilstand
Kabinettets ydeevnetab beregnes af specifikke algoritmer. FANselect tilbyder flere tabsberegningsalgoritmer til enkelte fans, men kun én (RLT_2017) til flere ventilatorlayouts
Indtastningsmuligheder:
ZA: Intern udviklet algoritme
RLT_2017: Seneste algoritme udviklet af AHU Manufacturer's Association
beskyttelsesklasse
Indtast påkrævet beskyttelsesklasse som et IPxx-nummer.
erp_klasse
Input ERP (Energy Related Products-Directive) klasse, dvs. 2015.
ErP-klassen definerer den minimale effektivitet, en ventilator kan have for at blive solgt på visse markeder
sfp_class
Input SFP (Specific Fan Performance) Klasse som et ciffer, dvs. 3, 4. SFP er grundlæggende den input elektriske effekt i forhold til den udgående luftstrøm.
fuld_oktavbånd
For at vise hele oktavbåndet med cmd: søg, indstil denne parameter til sand.
indsæt_nominelle_værdier
Indstil denne parameter til sand for at vise alle de elektriske nominelle værdier med cmd: søgning.
insert_motor_data
Indstil denne parameter til sand for at vise relevante moor-data med cmd: search.
indsæt_geo_data
Indstil denne parameter til sand for at vise artiklens dimensioner
fokus_kriterier
Denne parameter giver dig mulighed for at begrænse det fundne sæt til de fans med de bedste fokuskriterier, du havde indstillet.
Indtastningsmuligheder:
ZA_ETASF_SYS: Bedste …% ved systemstatisk effektivitet
ZA_PSYS: Bedste …% ved systemabsorberet effekt
ZA_LWA5: Bedste … % ved akustik på sugesiden
ZA_LWA6: Bedste …% ved tryksideakustik
ZA_BG: Bedste …% ved blæserstørrelse
fokus_tolerance
Indstilling af denne parameter til 0 ville kun producere én artikel, nemlig den med den bedste forudindstillede focus_crtieria. Indtastning af et nummer X ville give den bedste blæser til de forudindstillede focus_criteria plus alle blæsere op til X % dårligere end den bedste blæser.
fx: focus_criteria = ZA_ETASF_SYS og fokus_tolerance = 7
yder: Ventilator med bedste statiske systemeffektivitet + alle ventilatorer op til 7 % dårligere end den bedste ventilator
prislistenavn
Ved at indtaste navnet på Excel-arket, der findes i DLL-mappen: Product_Price_Reference..xls, kan du få prisen vist blandt DLL'ens output. Excel file har et regneark med tre kolonner.
Kolonne 1: Kundens artikelnummer. Her kan et hvilket som helst talsystem bruges.
Kolonne 2: Ziehl-Abegg artikelnummer, som bruges til selektionsberegningerne
Kolonne 3: Prisen på denne artikel
Alle udgange forklaret
ARTICLE_NO Artikelnummer
CALC_AIR_DENSITY Luftdensitet brugt til valg og beregning (kg/m³)
CALC_ALTITUDE Højde brugt til udvælgelse og beregning (m over havets overflade)
CALC_LW5_OKT Oktavbånd på sugesiden, værdier adskilt af kommaer (dB)
CALC_LW6_OKT Oktavbånd på tryksiden, værdier adskilt af kommaer (dB)
CALC_LWA5_OKT Sugesidevægtede oktavbåndværdier (dBA)
CALC_LWA6_OKT Tryksidevægtede oktavbåndværdier (dBA)
CALC_NOZZLE_PRESSURE Tryk i dyse, bruges til at bestemme luftstrøm (Pa)
CALC_N_RATED Forholdet mellem driftspunkt blæseromdrejninger og maksimal blæseromdrejningstal (%)
CALC_P1_MAX Maksimal absorberet elektrisk effekt ved driftspunkt (W)
CALC_PL_MAX Maksimal absorberet akseleffekt ved driftspunkt (W)
CALC_PSYS_MAX Maksimal absorberet systemeffekt = motor + controller absorberet effekt (W)
CALC_TEMP_C Middel temperatur (°C)
CAPACITOR_CAPACITANCE Kondensatorkapacitans (??F)
CAPACITOR_VOLTAGE Kondensator voltage (V)
DIAGRAM_VIEWER_URL URL til diagram, der viser ventilatorkurver
KREDSLAG Type af elektrisk kredsløb
COSPHI Blæsermotor Cosinus Phi værdi
CURRENT_PHASE Ventilatormotorfaser
dim_... Dimensioner på ventilatoren
dim_klischee Cliche name => forenklet tegning med vigtige dimensioner
DENSITY_INFLUENCE Densitet brugt til bestemmelse af driftspunktsmålingstæthed => Udvælgelse ved ventilatorens målte densitetstæthed => Valg ved densitet forskellig fra målt densitet
TEGNING_FILE Vej til viftetegning
EC_TYPE Output er 1, hvis ventilatoren drives af en EC-motor og en tom streng, hvis ventilatormotoren ikke er en EC-motor
EFFICIENCY_CLASS Effektivitetsklasse for IEC-motor. Parametre vises kun sammen med ventilatorer drevet af IEC-motorer
EFFICIENCY_STAT Statisk effektivitet af ventilator = volumetrisk hastighed x statisk tryk / effekt absorberet af systemet (%)
EFFICIENCY_TOT Ventilatorens samlede effektivitet = volumetrisk hastighed x statisk tryk / effekt absorberet af systemet (%)
ERP_CLASS Ventilator ERP-klasse
ERP_METHOD Metode, der bruges til at måle ERP-klasse
ERP_N_ACTUAL Faktisk normaliseret effektivitetsgrad (Nist)
ERP_N_STAT Statisk effektivitet (hstatA) ved driftspunkt (%) i henhold til målemetode A
ERP_N_TRAGET Påkrævet standardiseret effektivitetsgrad (Nsoll)
ERP_VSD Returnerer integreret EC-controller, hvis blæseren er udstyret således. og en tom streng til ventilatorer uden et integreret hastighedskontrolsystem
FAN_EFFICIENCY_GRADE Dette er en faktor, der er tildelt individuelle fans og er kun relevant for AMCA-fans
FEI_FACTOR Denne faktor beregnes ud fra driftspunktet og er kun relevant for AMCA-ventilatorer
GRILL_INFLUENCE Returnerer nej, hvis grillpåvirkning ikke er indregnet i beregninger, og ja, hvis grillens indflydelse tages i betragtning.
INCREASE_OF_CURRENT Aktuel stigning (%)
INDEKS Sekvensnummer af blæsere i fundet sæt. Første blæser i fundet sæt ville have indeks 0, anden blæser indeks 1 osv.
INSTALLATION_HEIGHT_MM Højde på blæser (mm)
INSTALLATION_LENGTH_MM Længde af ventilator (mm)
INSTALLATION_POS Returnerer blæserretning(er): H: Vandret VO: Lodret opad VU: Lodret nedad
INSTALLATION_POS_H Returnerer 1 for vandret orienterede ventilatorer (INSTALLATION_POS = H), og en tom streng for resterende ventilatorer.
INSTALLATION_POS_VO Returnerer 1 for lodrette opadvendte ventilatorer (INSTALLATION_POS = VO) og en tom streng for resterende ventilatorer
INSTALLATION_POS_VU Returnerer 1 for lodrette nedadvendte ventilatorer (INSTALLATION_POS = VU) og en tom streng for resterende ventilatorer
INSTALLATION_WIDTH_MM Bredde på blæser (mm)
IS_EC Returnerer 1, hvis ventilatoren har EC-motor og tom streng for ikke-EC-motorer
KFACTOR Ventilatorens dysetryk
MAX_CURRENT Ventilatorens maksimale strøm (A)
MAX_FREQUENCY Ventilatorens maksimale frekvens (Hz)
MAX_TEMPERATURE_C Ventilatorens maksimale temperatur (°C)
MAX_VOLTAGE Fan's maksimum voltage (V)
MTEGNINGEN Navn på tegningen file
MIN_CURRENT Ventilatorens minimumstrøm (A)
MIN_TEMPERATURE_C Ventilatorens minimumstemperatur (°C)
MIN_VOLTAGE Fan's maksimum voltage (V)
MOTOR_DESIGN Type af motordesign: (kun for IEC-motorer)
IMB 3: Fodmonteret
IMB 5: Flangemonteret
MOTOR_POLES Antal motorpoler (til IEC-drevne ventilatorer)
MOTOR_SHAFT IEC motoraksel beskrivelse: antal / diameter X længde
MOTOR_SIZE IEC motorstørrelse
NOMINAL_CURRENT Blæsermotor nominel strøm (A)
NOMINAL_FREKVENS Blæsermotorens nominelle frekvens (Hz)
NOMINAL_IECMOTOR
_EFFEKTIVITET IEC Motorens nominelle effektivitet som et decimaltal
NOMINAL_SPEED Ventilatorens nominelle hastighed (1/min)
NOMINAL_VOLTAGE Ventilatormotor nominel voltage
NOZZLE_GUARD Oplysninger om, hvordan ventilatoren blev målt. Overvejende til aksialventilatorer
NUMBER_OF_POLES IEC motor antal poler
PHASE_DIFFERENCE Faseforskel
POWER_INPUT_KW Kraft til motoren (kW)
POWER_INPUT_KW Effektudgang efter motor (kW)
PRODUCT_IMG Sti til produktbillede
PROTECTION_CLASS_IP Beskyttelsesklasse som IP-nummer
PROTECTION_CLASS_THCL Temperaturbeskyttelsesklasse som THCL-nummer
RUBBER_MOT_DIAMETER Motorgummi damper diameter
RUBBER_MOT_HEIGHT Motorgummi damper højden
SPRING_MOT_DIAMETER Motorfjeder damper diameter
SPRING_MOT_HEIGHT Motorfjeder damper højden
TYPE Type nøgle på ventilator
BINDTAGE_TOLERANCE Voltage-tolerance (%)
ZAWALL_ARRANGEMENT Layout med flere ventilatorer. Returnerer 0, hvis der ikke er valgt flere blæsere
ZA_BG Ventilator nominel størrelse
ZA_COSPHI Ventilatormotor Cos Phi
ZA_ETAF Ventilatorens samlede effektivitet = volumetrisk hastighed X totalt tryk / effekt absorberet af systemet (%)
ZA_ETAF_L Samlet virkningsgrad for ventilatorhjul (%)
ZA_ETAF_SYS Systemets samlede effektivitet (%)
ZA_ETAM Motoreffektivitet (%)
ZA_ETASF Statisk effektivitet af ventilator = volumetrisk hastighed x statisk tryk / effekt absorberet af systemet (%)
ZA_ETASF_L Statisk effektivitet for ventilatorhjul (%)
ZA_ETASF_SYS Systemets statiske effektivitet (%)
ZA_F Blæser nominel elektrisk frekvens (Hz)
ZA_FBP Blæser elektrisk frekvens ved driftspunkt (Hz)
ZA_I Ventilatorstrøm ved driftspunkt (A)
ZA_IN Ventilator nominel strøm (A)
ZA_LW5 Driftspunkt akustisk effektniveau sugeside (dB)
ZA_LW6 Driftspunkt akustisk effektniveau trykside (dB)
ZA_LWA5 Driftspunktvægtet akustisk effektniveau sugeside (dBA)
ZA_LWA6 Driftspunktvægtet akustisk effektniveau trykside (dBA)
ZA_MAINS_SUPPLY Netforsyning: faser, voltage og elektrisk frekvens
ZA_N RPM ved driftspunkt (1/min)
ZA_NMAX Maksimal omdrejningstal for blæser (1/min)
ZA_PD Dynamisk tryk ved driftspunkt (Pa)
ZA_PF Totaltryk af ventilator. ZA_PF = ZA_PSF + ZA_PD (Pa)
ZA_PF_MAINS_OPERATED Totaltryk af ventilator i netdrift (Pa)
ZA_PSF Statisk tryk af ventilator (Pa)
ZA_PSF_MAINS_OPERATED Statisk tryk af ventilator i netdrift (Pa)
ZA_P1 Elektrisk strøm påkrævet ved driftspunktet (W)
ZA_PD Driftspunkt dynamisk tryk (Pa)
ZA_PF Driftspunkt totalt tryk (Pa)
ZA_PL Beregnet akseleffekt ved driftspunkt (W)
ZA_PSF Driftspunkt statisk tryk (Pa)
ZA_PSYS Absorberet effekt efter system (W)
ZA_QV Driftspunkt volumetrisk flowhastighed (m³/h)
ZA_QV_MAINS_OPERATED Driftspunkt volumetrisk flowhastighed i netdrift (m³/h)
ZA_SFP SFP-nummer på ventilator
ZA_SFP_CLASS Fans SFP-klasse
ZA_U Fan voltage ved arbejdspunkt (V)
ZA_UN Ventilator nominel voltage (V)
ZA_WEIGHT Masse af ventilator
Udgange for hver cmd
cmd: søg udgange
| ARTIKEL_NR | CALC_AIR_DENSITY | CALC_ALTITUDE |
| CALC_NOZZLE_PRESSURE | CALC_N_RATED | DENSITY_INFLUENCE |
| TEGNING_FILE | ERP_KLASSE | ERP_METHOD |
| ERP_N_ACTUAL | ERP_N_STAT | ERP_N_TRAGET |
| ERP_VSD | FAN_EFFICIENCY_GRADE | FEI_FACTOR |
| GRILL_INFLUENCE | INDEKS | INSTALLATION_HEIGHT_M M |
| INSTALLATION_LENGTH_M M | INSTALLATION_POS | INSTALLATION_POS_H |
| INSTALLATION_POS_VO | INSTALLATION_POS_VU | INSTALLATION_WIDTH_MM |
| IS_EC | IS_VALID | KFACTOR |
| NOZZLE_GUARD | PRODUCT_IMG | TYPE |
| 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_VÆGT |
cmd: vælg Udgange
Denne cmd kræver, at du indtaster et artikelnummer i artikelnr.
| ARTIKEL_NR | 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 | DIAGRAM_VIEWER_URL |
| KREDSLØB | COSFI | CURRENT_PHASE |
| DENSITY_INFLUENCE | TEGNING_FILE | EC_TYPE |
| EFFEKTIVITET_STAT | EFFEKTIVITET_TOT | ERP_KLASSE |
| ERP_METHOD | ERP_N_ACTUAL | ERP_N_STAT |
| ERP_N_TRAGET | ERP_VSD | FAN_EFFICIENCY_GRADE |
| FEI_FACTOR | GRILL_INFLUENCE | INCREASE_OF_CURRENT |
| INSTALLATION_HEIGHT_MM | INSTALLATION_LENGTH_MM | INSTALLATION_POS |
| INSTALLATION_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 | NOMINAL_FREKVENS | NOMINAL_HASTIGHED |
| NOMINAL_VOLTAGE | NOZZLE_GUARD | PHASE_DIFFERENCE |
| POWER_INPUT_KW | PRODUCT_IMG | PROTECTION_CLASS_IP |
| PROTECTION_CLASS_THCL | TYPE | BINDTAGE_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_VÆGT |
cmd: nominelle_værdier Udgange
Denne cmd kræver et artikelnummer i artikelnr.
Outputtene nedenfor kan også udlæses ved hjælp af cmd-søgning ved at indstille insert_nominal_values til sand
| ARTIKEL_NR | CAPACITOR_CAPACITANCE | CAPACITOR_VOLTAGE |
| KREDSLØB | COSFI | CURRENT_PHASE |
| EC_TYPE | EFFEKTIVITET_STAT | EFFEKTIVITET_TOT |
| INCREASE_OF_CURRENT | MAX_CURRENT | MAX_FREQUENCY |
| MAX_SPEED | MAX_TEMPERATURE_C | MAX_VOLTAGE |
| MIN_CURRENT | MIN_PSF | MIN_TEMPERATURE_C |
| MIN_VOLTAGE | NOMINAL_CURRENT | NOMINAL_FREKVENS |
| NOMINAL_HASTIGHED | NOMINAL_VOLTAGE | PHASE_DIFFERENCE |
| POWER_INPUT_HP | POWER_INPUT_KW | POWER_OUTPUT_HP |
| POWER_OUTPUT_KW | PROTECTION_CLASS_IP | PROTECTION_CLASS_THCL |
| BINDTAGE_TOLERANCE |
cmd: get_chart Udgange
Denne cmd kræver et artikelnummer i artikelnr, og producerer nedenstående output og blæserkurver
| BOTTOM_MARGIN | DIAGRAM_FILE | CHART_MAX_X |
| CHART_MAX_Y | CHART_MIN_X | CHART_MIN_Y |
| LEFT_MARGIN | MEASUMENT_ID | RIGHT_MARGIN |
| TOP_MARGIN |
cmd: motor_data udgange
For EC-motorer:
| KREDSLØB | NOMINAL_VOLTAGE | PROTECTION_CLASS_IP |
FOR IEC-motorer:
| KREDSLØB | EFFEKTIVITET_KLASSE | MOTOR_DESIGN |
| MOTOR_SHAFT | MOTOR_SIZE | NOMINAL_CURRENT |
| NOMINAL_VOLTAGE | NUMBER_OF_POLES | POWER_OUTPUT_KW |
| PROTECTION_CLASS_IP | RUBBER_MOT_DIAMETER | RUBBER_MOT_HEIGHT |
| SPRING_MOT_DIAMETER | SPRING_MOT_HEIGHT |
cmd: status Udgange
Denne cmd er nyttig til at hente DLL'ens version og brugerens brugernavn
| BRUGERNAVN | VERSION |
cmd: create_session Outputs
Denne cmd bruges til at oprette en session, før den kaldes web DLL
| BRUGERNAVN | VERSION |
Hjælp og support
Kontaktoplysninger
Du er velkommen til at kontakte os, hvis du har brug for yderligere hjælp eller råd til, hvordan du integrerer FANselect API'et i din applikation.
Kontakte
FAN vælg Support
Ventilationsteknologi
Heinz-Ziehl-Straße – 74653 Künzelsau
fanselect@ziehl-abegg.com
www.fanselect.net
www.ziehl-abegg.com
Links
Ziehl-Abegg
www.ziehl-abegg.com
FAN vælg DLL Download
www.ziehl-abegg.com/fileadmin/de/de/03_Produktwelten/DigitaleLösungen/Software/FANselect/FANselect_DLL.zip
FANvælg Web API
fanselect.net:8079/FSWebService
Artikelbilleder og tegninger
http://www.ziehl-abegg.com/fileadmin/de/de/05_Support/Software/FANselect/catalog.zip
Dokument historie
04.11.2019
- Første udgivelse
12.08.2021
- Nyt design af dokumentet
- Opdater ERP_... beskrivelse
- Tilføj nye porteføljer
- Tilføj ny beskrivelse af outputvariabler for dimensioner
Dokumenter/ressourcer
 |
ZIEHL-ABEGG FANVælg DLL API-programmeringsgrænseflade [pdfBrugervejledning FANselect DLL, FANselect DLL API-programmeringsgrænseflade, API-programmeringsgrænseflade, programmeringsgrænseflade |