Aja Shell-komentoja ja ARexx-makroja

AWeb tarjoaa ainutlaatuisen ja tehokkaan mahdollisuuden ajaa Amiga DOSin Shell-komentoja ja ARexx-makroja sivulta, pelkästään osoittamalla hyperlinkkiä tai hyväksymällä lomake. Näkemällä hieman vaivaa, voit luoda monimutkaisia sovelluksia käyttäen AWebiä käyttöliittymänä, käynnistäen komentotiedostoja, jotka puolestaan dynaamisesti luovat uusia dokumentteja, ladattavaksi ARexxin kautta AWebiin jne.

Vaikka tämä ominaisuus voi olla erittäin käyttökelpoinen, se voi olla myös hyvin vaarallinen. Tämän vuoksi ominaisuus toimii vain paikallisilta sivuilta (joiden URL alkaa file://localhost/ -osalla) ja vain jos Salli Shell-komennot -asetus on valittu.

Yksinkertaiset Shell-komennot

Sisällyttääksesi yksinkertaisen komennon, lisää vain dokumenttiisi normaali hyperlinkki, jonka osoittama URL on muotoa

   x-aweb:command/sinun_DOS_komentosi

Jos käyttäjä osoittaa hyperlinkkiä, sinun_DOS_komentosi ajetaan. Komennon tulosteet ohjataan automaattisesti avautuvaan konsoli-ikkunaan, ellet määritä komennossa muuta tulostuksen uudelleenohjausta.

Koska yhteensopiva HTML-tila päättää URL:n välilyöntiin, varmista että olet määritellyt kaikki välilyönnit komennossa " "-koodilla. Muuten komento ei toimi, mikäli käyttäjä on valinnut yhteensopivan HTML-tilan.

Esimerkki: <a href="x-aweb:command/dir sys: all">tulosta hakemisto</a> antaisi käyttäjän ajaa dir sys: all -komennon osoittamalla sanoja "tulosta hakemisto".

Huomio: DOS-komento ajetaan erillisessä komentorivi-Shellissä, jossa oletushakemisto on asetettu samaksi kuin AWebin oletushakemisto. Käytä vain täydellisiä hakemistopolkuja DOS-komennoissa tai muuten tulos riippuu siitä, mikä hakemisto sattui olemaan oletushakemisto käynnistäessäsi AWebin.

ARexx-makrot

ARexx-makrojen käynnistäminen sivuilta toimii samanlaisella tavalla. Lisää vain normaali hyperlinkki, jonka osoittama URL on muotoa

   x-aweb:rexx/sinun_ARexx_makrosi

Jos käyttäjä osoittaa hyperlinkkiä, sinun_ARexx_makrosi käynnistetään ja kyseisen ikkunan ARexx-portti on oletuksena oleva komentoportti.

Parametrit

Voit käyttää HTML-lomaketta tai osoitettavaa karttaa välittämään parametreja DOS-komennolle tai ARexx-makrolle.

Lomakkeet

Lisää ACTION="x-aweb:command/sinun_komentosi" -määre <FORM>-erottimeen ajaaksesi komennon, jos käyttäjä hyväksyy lomakkeen. Vastaavasti voit lisätä ACTION="x-aweb:rexx/sinun_makrosi" -määreen käynnistääksesi ARexx-makron.

Lomakkeen parametrit muunnetaan Amiga DOSin tyylisiksi parametreiksi: kentän nimeä käytetään argumentin nimenä ja kentän arvoa argumentin arvona. Arvo sisällytetään lainausmerkkeihin ja siinä oleviin escape-, uusi rivi- ja lainaus-merkkeihin liitetään eteen ohjauskoodi, kuten Amiga DOS vaatii.

Huomio: vipu-argumentteja (/S) ei voi välittää tällä tavalla. Voit käyttää sen sijaan komentotiedostoa, kuten alla olevassa esimerkissä.

Osoitettavat kartat

Kun käytät osoitettavia karttoja, hiiren kursorin x- ja y-koordinaatit kuvassa välitetään komennolle parametreina ilman avainsanaa.

ARexx-argumentit

Parametrit ARexx-makroille välitetään samassa muodossa kuin DOS-komentotiedostoille. Argumenttimerkkijono sisältää nimen, yhtäläisyysmerkin ja lainausmerkeissä olevan arvon jokaiselle lomakkeen parametrille. Katso alla olevasta toisesta esimerkistä yksi mahdollinen tapa jäsentää tämä.

Lataa tulos takaisin AWebiin

Jos komentotiedostosi tai makrosi on luonut uuden HTML-dokumentin (tai tavallisen tekstitiedoston), voit automaattisesti ladata tämän tiedoston takaisin AWebiin. Käytä ARexxin OPEN-komentoa tähän tarkoitukseen. Jos käytät tiedostosi nimeä uudelleen eri vastauksiin, lisää RELOAD-vipu estääksesi AWebiä näyttämästä aikaisempaa (välimuistissa olevaa) dokumenttia uudelleen.

Tietenkin tämä toimii paremmin ARexx-makrosta kuin DOS-komentotiedostosta. DOS-komentotiedostossa sinulla ei ole mahdollisuutta selvittää, mihin ARexx-porttiin OPEN-komento tulisi lähettää.

Esimerkkejä

Alla on kaksi esimerkkiä näistä ominaisuuksista. Katso ensin tämän sivun lähdettä ja suoritettavaa makroa vakuuttaaksesi itsesi, että linkin seuraaminen tai lomakkeen hyväksyminen ei aiheuta hankaluuksia. Valitse sitten Salli Shell-komennot ohjelman asetusten valitsimessa ja kokeile tätä lomaketta.

Yksinkertainen Shell-komento

Tämä esimerkki hakee vain SYS: -hakemiston sisällön ja näyttää sen erillisessä konsoli-ikkunassa: näytä hakemisto.

ARexx-makro

Tämä esimerkki hakee valitun kansion hakemiston sisällön.

Takaisin hakemistoon.