ansmirnov 22. elokuuta 2013 klo 14.12

Ulkoiset komponentit kohdassa 1C 8.2

• Ohjelmointi,
• C++

• Opetusohjelma

Johdanto

Ulkoiset komponentit "1C: Enterprise"

• käyttämällä alkuperäistä APIa
• käyttämällä COM-tekniikkaa

VK rakenne

Demo-VK:n käynnistäminen

Kokoelma

VK:n yhdistäminen 1C-kokoonpanoon

Sisäänrakennetun toiminnallisuuden esittely

1. Hallinnoi komponenttiobjektin tilaa
   Menetelmät: Kiihottua, Kytke pois päältä
   Ominaisuudet: Mukana
2. Ajastimen hallinta
   Joka sekunti komponentti lähettää parametreilla viestin 1C: Enterprise -järjestelmään Komponentti, Ajastin ja järjestelmän kellon laskurilinja.
   Menetelmät: Aloitusajastin, StopTimer
   Ominaisuudet: On ajastin
3. Menetelmä ShowInStatusLine, joka näyttää tilarivillä menetelmälle parametreina välitetyn tekstin
4. Menetelmä Lataa kuva. Lataa kuvan määritetystä tiedostosta ja siirtää sen 1C: Enterprise -järjestelmään binääritietojen muodossa.

Mukautettu ulkoisen komponentin nimi

VK-ominaisuuksien luettelon laajentaminen

Tarkastellaanpa yllä olevien luokkamenetelmien toteutusta CAddInNative.
Demo-VC:ssä määritellään 2 ominaisuutta: Mukana Ja On ajastin (On kytketty Ja IsTimerPresent).
Kirjastokoodin globaalissa laajuudessa määritellään kaksi taulukkoa:
static wchar_t *g_PropNames = (L"IsEnabled", L"IsTimerPresent"); static wchar_t *g_PropNamesRu = (L"Käytössä", L"Ajastin on olemassa");
joka tallentaa venäjän ja englannin kiinteistöjen nimet. Otsikkotiedostossa AddInNative.h luettelo on määritelty:
enum Props ( ePropIsEnabled = 0, ePropIsTimerPresent, ePropLast // Aina viimeinen );
ePropIsEnabled Ja ePropIsTimerPresent, joiden arvot ovat 0 ja 1, käytetään korvaamaan kiinteistöjen sarjanumerot merkityksellisillä tunnisteilla. ePropLastia, jonka arvo on 2, käytetään ominaisuuksien lukumäärän saamiseksi (GetNprops-menetelmällä). Näitä nimiä käytetään vain komponenttikoodissa, eivätkä ne ole saatavilla ulkopuolelta.
FindProp- ja GetPropName-menetelmät suorittavat taulukkohakuja g_PropNames Ja g_PropNamesRu.
Kenttien arvojen tallentamiseksi kirjastomoduuliin CAddInNative-luokassa on ominaisuuksia, jotka tallentavat komponentin ominaisuuksien arvon. menetelmät GetPropVal Ja SetPropVal palauttaa ja asettaa näiden ominaisuuksien arvot vastaavasti.
menetelmät IsPropReadable Ja IsPropWritable ja palata totta tai väärä, riippuen kiinteistön hyväksytystä järjestysnumerosta sovelluslogiikan mukaisesti.
Jotta voit lisätä mukautetun ominaisuuden, sinun on:

1. Lisää taulukoihin lisättävän ominaisuuden nimi g_PropNames Ja g_PropNamesRu(tiedosto AddInNative.cpp)
2. Listata Rekvisiitta(tiedosto AddInNative.h) ennen ePropLast lisää nimi, joka yksilöi lisättävän ominaisuuden
3. Järjestä muisti ominaisuusarvojen tallentamista varten (luo moduulikomponenttikentät, jotka tallentavat vastaavat arvot)
4. Tee muutoksia menetelmiin GetPropVal Ja SetPropVal olla vuorovaikutuksessa edellisessä vaiheessa varatun muistin kanssa
5. Tee muutoksia menetelmiin sovelluslogiikan mukaisesti IsPropReadable Ja IsPropWritable

Toinen ja kolmas viesti ovat tulosta edellisessä vaiheessa asetettujen ominaisuuksien lukemisesta. Ensimmäinen ja toinen viesti sisältävät viimeisen ominaisuusjoukon tyyppikoodin. 3 vastaa kokonaislukuarvoa, 22 merkkijonoarvoa. Tyyppien ja niiden koodien vastaavuus selvitetään tiedostosta tyypit.h, joka sijaitsee ITS-levyllä.

Menetelmien luettelon laajentaminen

1. Lisää menetelmän nimi taulukoihin g_MethodNames Ja g_MethodNamesRu(tiedosto AddInNative.cpp)
2. Lisää merkityksellinen menetelmätunniste Methods-luetteloon (tiedosto AddInNative.h)
3. Tee muutokset toimintokoodiin Hanki NParams ohjelman logiikan mukaisesti
4. Tee tarvittaessa muutoksia menetelmäkoodiin GetParamDefValue, jos haluat käyttää menetelmäparametrien oletusarvoja.
5. Tee muutoksia toimintoon HasRetVal
6. Tee muutoksia funktioiden logiikkaan CallAsProc tai CallAsFunc, sijoittamalla menetelmän suoraan suoritettavan koodin sinne

Enum Methods ( eMethEnable = 0, eMethDisable, eMethShowInStatusLine, eMethStartTimer, eMethStopTimer, eMethLoadPicture, eMethTest, eMethLast // Aina viimeinen );
Muokataan funktiota Hanki Nprops niin, että se palauttaa "Testi"-menetelmän parametrien määrän:
long CAddInNative::GetNParams(const long lMethodNum) ( switch(lMethodNum) ( case eMethShowInStatusLine: return 1; case eMethLoadPicture: return 1; case eMethTest: return 2; oletus: return 0; ) return 0; )
Tehdään muutoksia funktioon:
bool CAddInNative::GetParamDefValue(const long lMethodNum, const long lParamNum, tVariant *pvarParamDefValue) (TV_VT(pvarParamDefValue)= VTYPE_EMPTY; switch(lMethodNum) ( case e MethStartTimer: tapaus eMethStopTimer: tapaus eMethTest : / / Parametriarvoja ei ole oletusarvoisesti: return false;
Kiitos lisätyn linjan
tapaus eMethTest:
jos yksi tai useampi argumentti puuttuu, vastaavilla parametreilla on tyhjä arvo ( VTYPE_EMPTY). Jos tarvitset parametrille oletusarvon, aseta se osiossa eMethTest toimintokytkimen lausunto CAddInNative::GetParamDefValue.
Koska testimenetelmä voi palauttaa arvon, sinun on tehtävä muutoksia funktiokoodiin HasRetVal:
bool CAddInNative::HasRetVal(const long lMethodNum) ( switch(lMethodNum) ( case eMethLoadPicture: case eMethTest: return true; oletus: return false; ) return false; )
Ja lisää menetelmän suoritettava koodi funktioon CallAsFunc:
bool CAddInNative::CallAsFunc(const long lMethodNum, tVariant* pvarRetArray, tVariant* paParams, const long lSizeArray) ( ... std::wstring s1, s2; switch(lMethodNum) ( case eMethLoadT case:eMethLoadT; case eMethLoadP; if (!lSizeArray || !paParams) return s1 = (paParams) -> pwstrVal ;
Käännetään komponentti ja tuodaan konfigurointikoodi lomakkeeseen:
muuttuja DemoComp; Toimenpide, kun järjestelmä käynnistyy () Yhdistä ulkoinen komponentti ("...", "DemoVK", ulkoisen komponentin tyyppi. Alkuperäinen); DemoComp = Uusi("AddIn.DemoVK.SomeName"); kaista = DemoComp.Test("Hei", "Maailma!"); Raportti(per); Menettelyn loppu
Konfiguroinnin käynnistämisen jälkeen saamme viestin: "Hei, maailma!", joka osoittaa, että menetelmä toimi onnistuneesti.

Ajastin

Vuorovaikutus 1C: Enterprise -järjestelmän kanssa

tVariantin tietotyyppi

• seos (liitto), joka on tarkoitettu suoraan tietojen tallentamiseen
• tietotyypin tunniste

1. Muuttujaan tällä hetkellä tallennettujen tietojen tyypin määrittäminen
2. Siirry vastaavaan sekoituskenttään päästäksesi suoraan tietoihin

Sovellus

Artikkelin otsikko sisältää lauseen "nukkeille". Teekannulla tarkoitin ennen kaikkea itseäni. Kaikki tietoni C++:sta pysyi 3-4 vuoden yliopiston tasolla, kun lähdin 1C:n kierolle polulle. Ja kaikki olisi hyvin, mutta äskettäin ilmaantui tehtävä, joka vaati ulkoisen komponentin kirjoittamista. Minun oli muistettava muistoni ja pyyhittävä pöly pois C++-tietoni. Osoittautuu, että kaikki ei ole niin pelottavaa. Haluan tarjota sinulle lyhyen johdannon ulkoisten komponenttien kirjoittamiseen.

Mallikomponentit ITS:ssä

ITS-levy sisältää täydellisen dokumentaation ulkoisten komponenttien mekanismista, jota täydentää esimerkkiprojekti ja malli omaa kehitystä varten. Materiaalia kutsutaan nimellä "External Component Technology". Dokumentaatio on hienoa, mutta sinun on silti ymmärrettävä se, ja aika on tuttuun tapaan lyhyt. Itse asiassa on vain muutama keskeinen seikka, joihin kannattaa kiinnittää huomiota, loput on rappeutumista ja turhamaisuutta :)

Tarvittavat materiaalit

Ulkoisen komponentin luomiseksi tarvitsemme:

1. Materiaali "Teknologia ulkoisten komponenttien luomiseen" sijaitsee ITS:ssä
2. Materiaalin mukana toimitettu tyhjä ulkokomponenttimalli
3. MS Visual Studio. Express-versio on ilmainen ja enemmän kuin riittävä tarpeisiimme.
4. Perustiedot C++-syntaksista, nimittäin:

• Kyky erottaa muuttujan ilmoitus silmukasta tai ehdosta
• Ymmärtäen, että merkkijonoja puhtaassa muodossaan ei ole olemassa C++:ssa, on olemassa taulukoita, joiden kanssa sinun täytyy selvästi vaivautua muistiin
• Tietysti vaaditaan kyky toteuttaa tehtävä määritetyllä kielellä. Ainakin mahdollisuus kutsua jotain kolmannen osapuolen kirjastoa C++:sta, joka tekee kaiken itse.

Aloitetaan kaivaminen

Native API:n dokumentaatio on melko yksityiskohtainen. Yhteenvetona se sanoo seuraavaa:

1. Ulkoisen komponentin avulla voit laajentaa sisäänrakennettua kieltä uudella objektilla (tai useilla). Nuo. luomme tietyn luokan, jonka voimme luoda "New"-operaattorilla ja kutsumme tämän objektin menetelmiä sisäänrakennetusta kielestä.
2. Jotta esineemme toimisi, alusta "kommunikoi" sen kanssa käyttämällä tiettyä protokollaa, joka meidän on toimitettava.
3. Itse komponenttikoodi koostuu perinteisesti kahdesta osasta: ensimmäinen on itse komponentin rekisteröinti järjestelmään, toinen on uuden luokan toiminta ja sen vuorovaikutus alustan kanssa.

Emme perehdy toteutuksen yksityiskohtiin, meillä on loppumassa määräajat, eikä meillä ole tarpeeksi osaamista. Meidän on nopeasti ymmärrettävä, mihin meidän on syötettävä rivimme, jotta komponentti toimisi. Voit tehdä tämän ottamalla komponenttimallin ITS:n kanssa ja avaamalla se Visual Studiossa. Malli sijaitsee pakkaamattoman arkiston mallikansiossa. Katsotaan mitä täällä on.

Olemme kiinnostuneita AddInNative.cpp-tiedostosta. Kaikki oivallus on siinä. Se sisältää malleja kaikille tarvittaville menetelmille, sinun on vain mukautettava niitä hieman. Kävi kuitenkin ilmi, että oli helpompaa olla käyttämättä tyhjää mallia pohjana, vaan käsitellä toimivaa esimerkkiä. Siinä on useita hyödyllisiä kelloja ja pillejä, jotka eivät sisälly tyhjään malliin. Kun ymmärrys tulee, sinun on otettava tyhjä malli ja hiottava sitä asian tiedolla. Esimerkki toimivasta komponentista sijaitsee esimerkki\NativeAPI-kansiossa ja tyhjä mallipohja mallikansiossa.

Avataan projekti esimerkkikansiosta ja siinä - tiedosto AddInNative.cpp

Aivan tiedoston alussa on vakioiden ja apufunktioiden ilmoitukset. Olemme kiinnostuneita seuraavista riveistä:

Kohteemme "oikeana" tukee sekä venäjäksi että englanniksi kirjoitettuja menetelmiä. Tätä tarkoitusta varten ominaisuuksien ja menetelmien kirjalliset nimet ilmoitetaan kahdella kielellä. Sininen runko on englantilaisille kylpyille, punainen kehys venäläisille kylpyille. Kuvassa näkyy, että esimerkki toteuttaa jo useita menetelmiä ja ominaisuuksia. Tehtävämme on poistaa ne ja lisätä omamme.

Rivi, jolla luokan nimi ilmoitetaan, on korostettu vihreällä kehyksellä. Rehellisesti sanottuna en ymmärtänyt mitä se tarkoitti. Jos muutat sen, mikään ei toimi. Koska he alun perin tekivät varauksen, että olin "nukke", voin antaa anteeksi. :)

Jos siis objektimme sisältää "RunCalculation"-menetelmän ja "Destination"-ominaisuuden, meidän on kuvattava tämä nimi g_MethodNamesRu- ja g_PropNamesRu-taulukoissa, vastaavasti.

Puhelut 1C-kieleltä

Joten objektimme sisältää yhden menetelmän ja luku-kirjoitusominaisuuden.

Otetaan seuraava käyttöskenaario:

OurObject = Uusi("AddIn. MyComponent. DataSender"); MeidänObjektimme. Kohde = "joku sähköposti@palvelin. fi";
MeidänObjektimme. RunCalculation(PaymentAmount, "Apuohjelmille");

On merkkijono-ominaisuus ja menetelmä, jossa on numeerinen ja merkkijonoparametri. Jotta tämä kaikki toimisi, 1C suorittaa suunnilleen seuraavan viestintäprotokollan komponentin kanssa:

Alusta kutsuu ennalta määritettyjä toimintoja objektillamme, ja se vastaa siihen ja suorittaa sen komentoja. Tilanne on samanlainen menetelmien kanssa, vain siellä pyydetään menetelmän numeron lisäksi parametrien lukumäärää, paluuarvon olemassaoloa ja valinnaisten parametrien läsnäoloa.

Palataan koodiimme. "Maagisten lukujen" välttämiseksi CAddInNative-luokassa ilmoitetaan kaksi luettelointia, jotka ovat vastuussa menetelmien ja ominaisuuksien lukumäärän määrittämisestä. Avataan tiedosto CAddInNative.h ja katsotaan ne heti alussa:

Tyhjä malli ei sisällä näitä luetteloita, eikä myöskään ole esimerkkiä venäjänkielisten puhelujen erottamisesta ei-venäläisistä puheluista. Tämä lähestymistapa on valinnainen. On tärkeää seurata käyttöliittymää, ja se, tuleeko siirtoja vai ei, on sinun päätettävissäsi.

Unicode-merkkijonot

Monet ihmiset luultavasti tietävät, että alusta toimii kaksitavuisilla Unicode-muodossa olevilla merkeillä. Malli ilmoittaa erityistyypin WCHAR_T tätä tarkoitusta varten. Tämä tyyppi on monialustainen kääre ja varmistaa saman merkkikoon Windowsissa ja Linuxissa. Vakio wchar_t-tyyppi voi vaihdella kooltaan eri järjestelmissä. Huomaa myös, että kaikki merkkijonoliteraalit ilmoitetaan L-kirjaimen etuliitteellä. Tämä tarkoittaa, että tällainen merkkijono on tyyppiä wchar_t.

On olemassa yksinkertainen sääntö: sisäisesti merkkijonokomponentit käsitellään muodossa wchar_t (Linuxissa voi olla 4 tavua, Windowsissa - 2), mutta heti kun siirrämme merkkijonon 1C: hen tai vastaanotamme sen sieltä, tarvitsemme WCHAR_T (tiukasti 2 tavua kaikissa järjestelmissä).

Jos haluat muuntaa yhden tyyppisen merkkijonon toiseksi, malli tarjoaa aputoimintoja:

Ensimmäinen muodostaa WCHAR_T standardista wchar_t:

uint32_t convToShortWchar(WCHAR_T** Kohde, const wchar_t* Lähde, uint32_t len ​​= 0);

Toinen on päinvastoin. Lomakkeet wchar_t kohteesta WCHAR_T.

uint32_t convFromShortWchar(wchar_t** Kohde, const WCHAR_T* Lähde, uint32_t len ​​​​= 0);

Vuorovaikutuksessa alustan kanssa käytetään aina vain WCHAR_T:tä.

Varianttityyppi

Toinen mielenkiintoinen asia on yleinen Variant-tietotyyppi. Sen avulla voimme olla vuorovaikutuksessa 1C-kielen kanssa, jota, kuten tiedät, ei kirjoiteta ja jokainen muuttuja voi sisältää mitä tahansa. Tätä tyyppiä käytetään arvoja vaihdettaessa. Välitämme RunCalculation-menetelmään kaksi parametria - numeron ja merkkijonon. Komponentti saa kaksi Variant-arvoa. Meidän vastuullamme on tarkistaa niiden todellinen tyyppi. Kukaan ei estä sinua välittämästä komponentille numeroa, vaan esimerkiksi arvotaulukkoa.

Vaikka näyttää siltä, ​​että olen väärässä. Minusta näyttää siltä, ​​​​että arvotaulukon siirtäminen NativeAPI:hen ei vieläkään ole mahdollista, koska se ei ole sallittujen tyyppien luettelossa, mutta voit silti antaa päivämäärän merkkijonon sijaan. Tämä ei myöskään ole hyvä. Meidän on tarkistettava muuttujan todellinen tyyppi, joka tuli 1C:stä.

Variant-tyyppi on yksinkertainen. Tämä on rakenne, jonka ominaisuudet ovat erityyppisiä arvoja. On ominaisuuksia, kuten DATE, wchar_t, int ja muita. Variantin pääosa on "vt"-ominaisuus, joka tallentaa muuttujan todellisen tyypin ja josta voit ymmärtää tarkalleen kuinka tämä Variantti tulkitaan. Lisäksi useita apumakroja on ilmoitettu yksinkertaistamaan Variant-tyypin kanssa työskentelyä.

Mennä asiaan

Näyttää siltä, ​​että tämä kaikki on johdannossa. Ehdotan, että harkitaan esimerkkiä ulkoisen komponentin toteuttamisesta. TK on esimerkki komponentista ITS-levyltä. Tämä esimerkki kuvaa seuraavat ominaisuudet:

• Tekstin näyttäminen pääikkunan tilapalkissa;
• Ulkoisen ajastintapahtuman lähettäminen;
• Binääritietojen siirto 1C:Enterprise-palveluun;
• Kiinteistöjen toteutus;
• Menettelyjen täytäntöönpano;
• Toimintojen toteuttaminen;

Komponentilla on seuraava API:

• Ominaisuudet:
  • Käytössä/On Enabled;
  • IsTimer/IsTimerPresent;
  • Menetelmät:
    • Ota käyttöön;
    • Poista käytöstä / Poista käytöstä;
    • ShowInStatusLine;
    • EnableTimer/StartTimer;
    • Sammuta ajastin/pysäytysajastin;
    • LoadPicture/LoadPicture;

Ulkoinen tapahtuma tapahtuu ajastimella, joka voidaan tilata 1C-koodista.

Tarkastellaanpa komponenttia alusta alkaen olemassa olevan tiedon ohjaamana.

Rekisteröinnin komponentit

Oliomme on toteutettu erillisenä C++-luokana, tässä tapauksessa CAddInNativena. Jotta 1C näkee luokkamme, dll-kirjaston on vietävä 3 toimintoa:

• GetClassObject
• DestroyObject
• Hanki ClassNames

Nämä viennit näkyvät AddInNative.def-tiedostossa VisualStudio-projektipuussa. Katsotaanpa näiden funktioiden koodia:

Yksinkertaisin - GetClassNames-funktio - kertoo 1C-alustalle, mitkä luokat ovat komponentissamme. Oikaiskoon C++-gurut, minusta tuntuu, että tässä alustan on vastattava C++-luokkien nimiin, jotta se voi tuoda ne. Juuri tähän käytetään g_kClassNames-taulukkoa, jossa on vihreä "kehys". En tarkistanut sitä erikseen, mutta jos haluat vain saada komponentin toimimaan, jätä kaikki niin kuin se on esimerkissä. Se toimii jo, ei sen kanssa tarvitse toistaiseksi puuhata.

Joten GetClassNames palauttaa alustalle joukon luokkanimiä, jotka toteuttavat ulkoisen komponentin hyödyllisiä objekteja. Esimerkissämme komponentti palauttaa alustalle yhden elementin joukon, jonka luokka on CAddInNative.

Huomaa, että alusta saa arvon, jonka tyyppi on WCHAR_T, ja luokan nimi g_kClassNames-taulukossa on tyyppiä wchar_t. Siksi heitto suoritetaan käyttämällä yllä käsiteltyä aputoimintoa.

Seuraava funktio on GetClassObject. Kutsutaan, kun olemme kirjoittaneet yrityskoodiin "Uusi". Alusta edellyttää, että luomme luokasta uuden ilmentymän ja palautamme osoittimen uuteen objektiin.

Huomaa jälleen, että ensimmäinen parametri, jonka alusta kertoo meille, on mikä luokka luodaan (GetClassNames-menetelmällä sille annetuista). Koska meillä on vain yksi luokka, tätä nimeä ei tarkasteta täällä ollenkaan, objekti luodaan yksinkertaisesti uuden kautta ja palautetaan tulosparametrin pInterface kautta.

Ja viimeinen vaadittu vientitoiminto on DestroyObject. Nimi puhuu puolestaan. Kun alusta ei enää tarvitse objektia, se on poistettava. Saamme osoittimen aiemmin luotuun objektiin. Vapautamme sen poistamalla ja nollaamalla tarpeettomat osoittimet.

Kuvatut toteutukset ovat melko yleisiä. Jos komponenttimme toteuttaa vain yhden luokan (kuten esimerkissä), nämä funktiot on yksinkertaisesti kopioitava itselleen. Ainoa ehto on luoda oikea luokka GetClassObject-funktiossa, jos nimesi ei ole CAddInObject, vaan jokin muu.

Komponentin alustus/lopetus

Kun komponenttia toteuttava luokka on luotu, alusta kutsuu tämän luokan menetelmiä. Ennen työn aloittamista alusta kertoo meille "itsensä" -objektin, jolla voimme kutsua tiettyjä itse alustan menetelmiä. Tämä tapahtuu Init-menetelmässä. Esimerkissä alustaobjekti on tallennettu m_iConnect-muuttujaan.

Toinen tärkeä menetelmä on setMemManager. Voit varata muistilohkoja, jotka alusta itse vapauttaa. Se toteutetaan seuraavasti:

Tallennamme yksinkertaisesti osoittimen muistinhallintaan, jonka alusta välittää meille. Sitten tämän hallinnan avulla varaamme itse alustan vapauttaman muistin.

Ja jälleen, kuten vientitoimintojen tapauksessa, alustusmenetelmät ovat melko yleisiä, voit yksinkertaisesti kopioida ne itsellesi ja olla huolehtimatta niiden "viimeistelystä" ennen kuin se on todella välttämätöntä.

Hyötykuorma. Komponenttiobjektin menetelmät ja ominaisuudet

Rekisteröinti

No, tietenkään emme luoneet komponenttia sen alustuksen vuoksi, vaan hyödyllisten toimintojen vuoksi. On aika katsoa, ​​miten se toteutetaan.

Ensin meidän on rekisteröitävä objekti, joka voidaan luoda ja kutsua 1C-kielellä. Tämä objekti on rekisteröity RegisterExtensionAs-metodissa.

Tässä menetelmässä ilmoitamme alustalle luokkamme nimen, koska se näkyy 1C-kielellä. Tällä nimellä luomme sen "Uuden" kautta. Tässä tapauksessa objektin luonti suoritetaan seuraavalla koodilla:

ConnectExternalComponent(Tiedosto, "Oma komponentti", Ulkoinen komponenttityyppi. Alkuperäinen);
ObjectComponents = New( "AddIn.MyComponent.AddInNativeExtension");

Dokumentaation mukaan muistinhallinta varaa muistin merkkijonolle luokan nimellä, ja nimi kirjoitetaan tähän osoitteeseen - "AddInNativeExtension". Täällä voit kirjoittaa nimesi kivuttomasti. Huomaa, että wchar_t on jälleen muunnettu alustaksi WCHAR_T.

Käyttö

Kuten edellä kirjoitin, alusta kysyy komponentilta eri kieliominaisuuksia. Onko määritetty ominaisuus olemassa, onko se kirjoitettava, onko funktioparametrilla oletusarvoa, onko sillä palautusarvoa jne. Jos otamme aiemmin annetun koodiesimerkin:

OurObject = Uusi( "AddIn.MyComponent.DataSender"); // DataSender on nimi RegisterExtensionAs-funktiosta (käsitellään alla).
MeidänObjektimme. Osoite = " [sähköposti suojattu]" ;
MeidänObjektimme. Suorita laskelma (maksusumma, "Yhteispalveluille");

sitten suoritetaan seuraava kysely:

1. Onko olemassa kohde-omaisuutta?
2. Tukeeko se tallennusta?
3. Onko olemassa menetelmää nimeltä RunCalculation?
4. Kuinka monta parametria siinä on?
5. Onko sillä palautusarvoa
6. Mitkä ovat valinnaisten parametrien oletusasetukset (jos sellaisia ​​on)

Hyödyllisintä tässä on katsoa esimerkkiä ja tarkistaa dokumentaatio. Kaikkien näiden tutkimusten toteuttaminen on melko yksinkertaista. Kokonainen eläintarha menetelmiä vastaa vuorovaikutuksesta. En käy kaikkea läpi, ne ovat melko hyvin dokumentoituja, ja lisäksi ne on helppo toteuttaa. Vain merkittävimmät hetket huomioidaan, joihin meidän nukkeina on saatava käsiimme :). Peruslähestymistapa on seuraava: kun ominaisuus tai menetelmä mainitaan ensimmäisen kerran, alusta pyytää meitä etsimään sitä nimellä. Meidän on vastattava tämän ominaisuuden yksilöivällä numerolla (menetelmä). Kaikki jatkoviestintä tapahtuu vain numeroiden avulla. Tässä auttavat mainitut luettelot, jotka tallentavat nämä numerot.

Ominaisuudet

Ensimmäinen asia, joka on otettava huomioon, on kiinteistön infrastruktuuri. Alusta pyytää ominaisuuden olemassaoloa FindProp-menetelmällä

Alusta välittää meille etsimämme kiinteistön nimen muodossa WCHAR_T. Se muunnetaan wchar_t-muotoon apumenetelmällä ja tätä tekstiä haetaan ensin englanninkielisillä termeillä ja sitten venäjänkielisillä termeillä. Meidän on palautettava kiinteistön numero. Huomaa, että findName-aputoiminto on mukana tässä. Sen toteutus on esimerkissä, mutta komponentti ei ole tyhjässä mallissa. Vaikuttaa sopivalta vetää se itseäsi kohti, jos aiot sisältää kaksikielisiä termejä komponentissasi.

Seuraavaksi GetPropName-menetelmä suorittaa käänteisen tehtävän ja saa ominaisuuden nimen numeron mukaan. Nimimerkkijono varataan myös yrityksen muistinhallinnan kautta. Epäilen, että GetPropName-menetelmää käytetään yhdessä GetNpropsin kanssa, kun laajennamme kohteen ominaisuuksia plusmerkillä debuggerissa. Sitten alusta vastaanottaa kiinteistöjen kokonaismäärän ja pyytää nimeä jokaiselle.

Seuraava menetelmäpari on IsPropReadable/IsPropWritable. Kaikki on täällä yksinkertaista, määritetylle omaisuusnumerolle on sanottava, voidaanko se lukea/kirjoittaa.

Arvojen vastaanotto ja kirjoittaminen suoritetaan GetPropVal/SetPropVal-menetelmillä. Täällä kannattaa perehtyä tarkemmin. Aloitamme työskentelyn 1C:Enterprise-tyyppien kanssa, mikä tarkoittaa, että Variant on tulossa näyttämölle.

Komponenttimalli määrittää joukon apumakroja Variantin kanssa työskentelyn yksinkertaistamiseksi. Ensimmäinen on arvotyypin tarkistus. Esimerkiksi makron TV_VT avulla voit tarkistaa/asettaa arvon tyypin. Jokaiselle tuetulle tyypille määritetään myös nimetyt vakiot. Nämä vakiot ja niiden vastaavuus 1C:Enterprise-tyypeille on lueteltu dokumentaatiossa.

TV_BOOL-makro saa Boolen arvon variantista, jota voit käyttää. Analogisesti saadaan kokonaislukuarvot (TV_INT), merkkijonot (TV_WSTR) ja muut. Tarkat arvot ovat koodissa, voit aina nähdä ne.

Tärkeä seikka on, että arvon määrittäminen variantille ei riitä, sinun on määritettävä myös todellinen tyyppi. Kiinnitä huomiota GetPropValiin. TV_BOOL = true -määrityksen lisäksi on tyyppimääritys: TV_VT = VTYPE_BOOL. Jos tyyppiä ei ole määritetty, alusta ei tiedä, minkä tyyppinen arvo sille palautettiin. Tietysti voit sotkea ja asettaa väärän tyypin. Tähän liittyy usein alustan putoaminen.

Tehdään yhteenveto yllä olevasta:

Saamme arvon vaihtoehdosta:

bool someVariable = TV_BOOL(pVariant);

Kirjoita arvo vaihtoehdolle:

TV_VT(pVariant) = VTYPE_BOOL; // kelvollinen tietotyyppi

TV_BOOL(pVariant) = jokin Boolen muuttuja; // aseta itse arvo

Ja nyt - kyttyräselkämenetelmät!

Menetelmät ovat hieman monimutkaisempia, mutta yleensä ne ovat samanlaisia ​​kuin ominaisuudet. Ensinnäkin on täsmälleen sama toiminto: menetelmän etsiminen nimellä, menetelmien kokonaismäärä, nimi numerolla. Yllä olevien lisäksi on kuitenkin lisätty seuraavat ominaisuudet:

• Jos menetelmä voi palauttaa arvon, sitä voidaan käyttää "Laske" -kohdassa ja kirjoittaa määritystoiminnon oikealle puolelle 1C-kielellä. Jos ei, se on menettely, ja sellaiset asiat aiheuttavat "Proseduurin käyttäminen funktiona" -poikkeuksen
• Menetelmällä on parametrit. Alustan on tiedettävä heidän numeronsa. Jos kutsu määrittää enemmän argumentteja kuin menetelmän allekirjoituksessa on määritetty, ilmenee "Liian monta parametria" -virhe.
• Jos menetelmälle ei välitetä tarpeeksi argumentteja, osa niistä voi olla valinnaisia, ja jos valinnaisia ​​parametreja ei ole, tapahtuu "Insufficient parameters" -virhe.
• Kutsuttaessa, jos se on proseduuri, paluuarvoa ei voi olla. Jos se on funktio, sillä on palautusarvo. Se on myös käsiteltävä.

On olemassa useita yksinkertaisia ​​menetelmiä, joiden tarkoitus on selvä niiden nimistä ja dokumentaatiosta. Näitä ovat HasRetVal, GetNParams, GetParamDefValue. Ehdotan, että niitä ei oteta huomioon. Kiinnostuksemme kohdistuu hyötykuorman suoraan toteuttamiseen. Se on toteutettu CallAsProc- ja CallAsFunc-menetelmillä. Ensimmäinen vastaa kutsumenettelyistä, toinen vastaa kutsutoiminnoista. Ne eroavat toisistaan ​​siinä, että CallAsFuncilla on lisälähtöparametri, jossa välitämme funktion palautusarvon alustalle.

Kutsu suoritetaan seuraavasti: alusta välittää meille kutsutun menetelmän numeron, joukon todellisia parametreja ja niiden numeron. Meidän on jäsennettävä menetelmän numero ja syötettävä sille hyväksytyt parametrit. Kun kyseessä on funktio, meidän on myös kirjoitettava jotain palautusarvoon.

Esimerkissä menetelmän numero analysoidaan kytkimessä/tapauksessa ja numerosta riippuen suoritetaan menetelmälogiikka. Valitse Ota käyttöön/Poista menetelmät -kohdassa valintaruutu. ShowInStatusLine-menetelmä on mielenkiintoinen. Se näyttää, mitä sille välitettiin 1C:Enterprise-ikkunan tilapalkissa. Tätä varten käytämme m_iConnect-alustan yhteysobjektia, joka "myönnettiin" meille komponenttia rekisteröitäessä. Täydellinen luettelo sen ominaisuuksista on kuvattu dokumentaatiossa.

Mielenkiintoinen pointti. Tässä esimerkissä 1C:stä tulevan arvon tyyppiä ei tarkisteta, vaan SetStatusLine kutsutaan yksinkertaisesti merkkijonoosalla Variant. Epäilen, että jos kutsut komponenttimenetelmää 1C-kielestä ja välität sinne numeron tai päivämäärän (merkkijonon sijaan), niin mikään ei toimi... Jälleen, anna gurujen korjata, mutta näyttää siltä, ​​​​että pwstrVal-osoitin osoittaa Jumala tietää mistä, jos se tulee yrityksestä, sanotaanko numero, ei rehellinen merkkijono. SetStatusLinea soitettaessa alusta yrittää lukea riviä tuntemattomasta osoitteesta ja todennäköisesti kaatuu. On parempi aina tarkistaa odotettu tyyppi. Ei sitä koskaan tiedä.

Esimerkin LoadImage-funktio on toteutettu mielenkiintoisemmalla tavalla, se ottaa huomioon merkkijonojen ja binääritietojen vaihdon alustan kanssa.

Ensin tässä tarkistetaan hyväksyttyjen parametrien määrä. Jos he eivät ole paikalla, puhelu katsotaan epäonnistuneeksi. Palauttaa false, jonka alusta tulkitsee puheluvirheeksi.

Seuraavaksi tässä tarkistetaan hyväksytyn parametrin tyyppi. Jos tämä on kapea merkkijono (VTYPE_PSTR), käytetään muunnelman char-osaa. Esimerkissä lukee paParam->pstrVal, mutta voit käyttää TV_STR-makroa, se on sama, mutta myös valinnan kanssa työskentelyn yhtenäisyys säilyy.

Jos se on leveä merkkijono (VTYPE_PWSTR), muunnos tehdään ensin muotoon wchar_t ja sitten char. Tosiasia on, että tiedoston polku välitetään 1C-kielestä tähän menetelmään, jota käytetään sitten fopen(char*)-funktiossa. Tämä toiminto vaatii syötteenä char*-tyypin, ja WCHAR_T lähetetään meille alustalta. Oikean toiminnan varmistamiseksi merkkijonomuunnokset suoritetaan.

Ja lopuksi, jos tämä ei ole merkkijono ollenkaan, puhelu katsotaan epäonnistuneeksi ja palautetaan false.

Varaamme muistia binääritiedoille käyttämällä muistinhallintaohjelmaa. Tämä on loogista; binääritiedoista tulee täysimittainen objekti alustassa, ja sen on hallittava sitä. Muistia on varattu pvarRetValue-variantille, joka on ulkoisen komponentin funktion palautusarvo.

Lisäksi koko tiedosto luetaan varattuun puskuriin; Välttämättä tavukoko määritetään strLen-option ominaisuudessa ja VTYPE_BLOB-asetuksen tietotyyppi. Jos muistin varaus on onnistunut, palautetaan true merkkinä onnistuneesta kutsusta koko funktiolle.

Joten kun 1C-kielellä kirjoitetaan:

BinaryData = Komponentti. Lataa kuva("C:\pic.jpg");

Kutsutaan komponenttiobjektin CallAsFunc-metodia, joka kulkee polun ja palauttaa binääridatan edellä kuvatulla tavalla.

Jos onnistuu, BinaryData-muuttuja sisältää täysimittaisen 1C-kieliobjektin. Kun se menee soveltamisalan ulkopuolelle, alusta vapauttaa kaiken sen käyttämän muistin. Siksi se jaettiin muistinhallinnan kautta.

Johtopäätös

Tarina on kirjoittanut teekannu nukkeille, joten se on todennäköisesti täynnä terminologisia epätarkkuuksia. Tämän artikkelin tarkoituksena on kuitenkin tarjota nopea johdatus ulkoisiin komponentteihin. Jos sinun on valmistettava komponentti nopeasti lyhyessä ajassa, ilman turhaa vaivaa, ilman pitkiä keskusteluja, toivon, että tämä artikkeli auttaa sinua. Jos jokin virheistäni saa sinut tuntemaan olosi huonoksi, C++-guruna, kerro siitä minulle kommenteissa, niin korjaamme ne.

Kiitos huomiostasi.

• Opetusohjelma

Johdanto

Ulkoiset komponentit "1C: Enterprise"

• käyttämällä alkuperäistä APIa
• käyttämällä COM-tekniikkaa

VK rakenne

Demo-VK:n käynnistäminen

Kokoelma

VK:n yhdistäminen 1C-kokoonpanoon

Sisäänrakennetun toiminnallisuuden esittely

1. Hallinnoi komponenttiobjektin tilaa
   Menetelmät: Kiihottua, Kytke pois päältä
   Ominaisuudet: Mukana
2. Ajastimen hallinta
   Joka sekunti komponentti lähettää parametreilla viestin 1C: Enterprise -järjestelmään Komponentti, Ajastin ja järjestelmän kellon laskurilinja.
   Menetelmät: Aloitusajastin, StopTimer
   Ominaisuudet: On ajastin
3. Menetelmä ShowInStatusLine, joka näyttää tilarivillä menetelmälle parametreina välitetyn tekstin
4. Menetelmä Lataa kuva. Lataa kuvan määritetystä tiedostosta ja siirtää sen 1C: Enterprise -järjestelmään binääritietojen muodossa.

Mukautettu ulkoisen komponentin nimi

VK-ominaisuuksien luettelon laajentaminen

Tarkastellaanpa yllä olevien luokkamenetelmien toteutusta CAddInNative.
Demo-VC:ssä määritellään 2 ominaisuutta: Mukana Ja On ajastin (On kytketty Ja IsTimerPresent).
Kirjastokoodin globaalissa laajuudessa määritellään kaksi taulukkoa:
static wchar_t *g_PropNames = (L"IsEnabled", L"IsTimerPresent"); static wchar_t *g_PropNamesRu = (L"Käytössä", L"Ajastin on olemassa");
joka tallentaa venäjän ja englannin kiinteistöjen nimet. Otsikkotiedostossa AddInNative.h luettelo on määritelty:
enum Props ( ePropIsEnabled = 0, ePropIsTimerPresent, ePropLast // Aina viimeinen );
ePropIsEnabled Ja ePropIsTimerPresent, joiden arvot ovat 0 ja 1, käytetään korvaamaan kiinteistöjen sarjanumerot merkityksellisillä tunnisteilla. ePropLastia, jonka arvo on 2, käytetään ominaisuuksien lukumäärän saamiseksi (GetNprops-menetelmällä). Näitä nimiä käytetään vain komponenttikoodissa, eivätkä ne ole saatavilla ulkopuolelta.
FindProp- ja GetPropName-menetelmät suorittavat taulukkohakuja g_PropNames Ja g_PropNamesRu.
Kenttien arvojen tallentamiseksi kirjastomoduuliin CAddInNative-luokassa on ominaisuuksia, jotka tallentavat komponentin ominaisuuksien arvon. menetelmät GetPropVal Ja SetPropVal palauttaa ja asettaa näiden ominaisuuksien arvot vastaavasti.
menetelmät IsPropReadable Ja IsPropWritable ja palata totta tai väärä, riippuen kiinteistön hyväksytystä järjestysnumerosta sovelluslogiikan mukaisesti.
Jotta voit lisätä mukautetun ominaisuuden, sinun on:

1. Lisää taulukoihin lisättävän ominaisuuden nimi g_PropNames Ja g_PropNamesRu(tiedosto AddInNative.cpp)
2. Listata Rekvisiitta(tiedosto AddInNative.h) ennen ePropLast lisää nimi, joka yksilöi lisättävän ominaisuuden
3. Järjestä muisti ominaisuusarvojen tallentamista varten (luo moduulikomponenttikentät, jotka tallentavat vastaavat arvot)
4. Tee muutoksia menetelmiin GetPropVal Ja SetPropVal olla vuorovaikutuksessa edellisessä vaiheessa varatun muistin kanssa
5. Tee muutoksia menetelmiin sovelluslogiikan mukaisesti IsPropReadable Ja IsPropWritable

Toinen ja kolmas viesti ovat tulosta edellisessä vaiheessa asetettujen ominaisuuksien lukemisesta. Ensimmäinen ja toinen viesti sisältävät viimeisen ominaisuusjoukon tyyppikoodin. 3 vastaa kokonaislukuarvoa, 22 merkkijonoarvoa. Tyyppien ja niiden koodien vastaavuus selvitetään tiedostosta tyypit.h, joka sijaitsee ITS-levyllä.

Menetelmien luettelon laajentaminen

1. Lisää menetelmän nimi taulukoihin g_MethodNames Ja g_MethodNamesRu(tiedosto AddInNative.cpp)
2. Lisää merkityksellinen menetelmätunniste Methods-luetteloon (tiedosto AddInNative.h)
3. Tee muutokset toimintokoodiin Hanki NParams ohjelman logiikan mukaisesti
4. Tee tarvittaessa muutoksia menetelmäkoodiin GetParamDefValue, jos haluat käyttää menetelmäparametrien oletusarvoja.
5. Tee muutoksia toimintoon HasRetVal
6. Tee muutoksia funktioiden logiikkaan CallAsProc tai CallAsFunc, sijoittamalla menetelmän suoraan suoritettavan koodin sinne

Enum Methods ( eMethEnable = 0, eMethDisable, eMethShowInStatusLine, eMethStartTimer, eMethStopTimer, eMethLoadPicture, eMethTest, eMethLast // Aina viimeinen );
Muokataan funktiota Hanki Nprops niin, että se palauttaa "Testi"-menetelmän parametrien määrän:
long CAddInNative::GetNParams(const long lMethodNum) ( switch(lMethodNum) ( case eMethShowInStatusLine: return 1; case eMethLoadPicture: return 1; case eMethTest: return 2; oletus: return 0; ) return 0; )
Tehdään muutoksia funktioon:
bool CAddInNative::GetParamDefValue(const long lMethodNum, const long lParamNum, tVariant *pvarParamDefValue) (TV_VT(pvarParamDefValue)= VTYPE_EMPTY; switch(lMethodNum) ( case e MethStartTimer: tapaus eMethStopTimer: tapaus eMethTest : / / Parametriarvoja ei ole oletusarvoisesti: return false;
Kiitos lisätyn linjan
tapaus eMethTest:
jos yksi tai useampi argumentti puuttuu, vastaavilla parametreilla on tyhjä arvo ( VTYPE_EMPTY). Jos tarvitset parametrille oletusarvon, aseta se osiossa eMethTest toimintokytkimen lausunto CAddInNative::GetParamDefValue.
Koska testimenetelmä voi palauttaa arvon, sinun on tehtävä muutoksia funktiokoodiin HasRetVal:
bool CAddInNative::HasRetVal(const long lMethodNum) ( switch(lMethodNum) ( case eMethLoadPicture: case eMethTest: return true; oletus: return false; ) return false; )
Ja lisää menetelmän suoritettava koodi funktioon CallAsFunc:
bool CAddInNative::CallAsFunc(const long lMethodNum, tVariant* pvarRetArray, tVariant* paParams, const long lSizeArray) ( ... std::wstring s1, s2; switch(lMethodNum) ( case eMethLoadT case:eMethLoadT; case eMethLoadP; if (!lSizeArray || !paParams) return s1 = (paParams) -> pwstrVal ;
Käännetään komponentti ja tuodaan konfigurointikoodi lomakkeeseen:
muuttuja DemoComp; Toimenpide, kun järjestelmä käynnistyy () Yhdistä ulkoinen komponentti ("...", "DemoVK", ulkoisen komponentin tyyppi. Alkuperäinen); DemoComp = Uusi("AddIn.DemoVK.SomeName"); kaista = DemoComp.Test("Hei", "Maailma!"); Raportti(per); Menettelyn loppu
Konfiguroinnin käynnistämisen jälkeen saamme viestin: "Hei, maailma!", joka osoittaa, että menetelmä toimi onnistuneesti.

Ajastin

Vuorovaikutus 1C: Enterprise -järjestelmän kanssa

tVariantin tietotyyppi

• seos (liitto), joka on tarkoitettu suoraan tietojen tallentamiseen
• tietotyypin tunniste

1. Muuttujaan tällä hetkellä tallennettujen tietojen tyypin määrittäminen
2. Siirry vastaavaan sekoituskenttään päästäksesi suoraan tietoihin

Sovellus

Tämä artikkeli on omistettu ulkoisten komponenttien kanssa työskentelemiseen, nimittäin niiden yhdistämiseen. Tällä hetkellä 1C Enterprisen ominaisuuksien laajentamiseksi käytetään kahta ulkoisten komponenttien teknologiaa:

• 1 Native API:n käyttäminen
• 2 COM-tekniikan käyttö

1. Oletetaan, että VK:mme sijaitsee tietyssä hakemistossa levyllä:

Voidaan käyttää "Thick Client (tavallinen sovellus)";

Tämä on yksinkertaisin esimerkki alkuperäiskomponentin kanssa työskentelystä. Huomaa, että tämän tyyppinen komponentti ei vaadi rekisteröintiä järjestelmään, mikä yksinkertaistaa huomattavasti hallintoa.

2. Edellä käsitelty esimerkki ei ole ollenkaan realistinen. Useimmiten komponentti sijoitetaan asetteluun. Asettelussa on oltava zip-arkisto komponenttitiedostoineen ja MANIFEST.xml-tiedosto
Esimerkkiluettelotiedosto:

3. Kun työskentelet ohuella ja web-asiakkaalla, muista käyttää menetelmää.
Lainaus ITS:stä:

Selitys:
%APPDATA%\1C\1Cv82\ExtCompT- hakemisto komponenttien asennusta varten Thick- ja Thin-asiakkaille.
%APPDATA%\Roaming\Mozilla\Extensions- hakemistolaajennukset (minun tapauksessani) Mozilla FF/
Kun käytät menetelmää Aseta ulkoinen komponentti(), käytetystä asiakkaasta riippuen laajennukset puretaan sopivaan hakemistoon.

Esimerkki ulkoisen komponentin asennusmenettelystä:

Asenna ulkoinen komponentti- menetelmää tulee kutsua vain komponentin alkuasennuksen aikana ja siinä tapauksessa, että komponentin asennettu versio on päivitettävä.

Ohut ja paksut asiakkaat:
Riittää, kun ulkoisen komponentin asennus suoritetaan uudelleen menetelmällä Asenna ulkoinen komponentti().

Kun kyseessä on web-asiakas päivittääksesi komponentin:

• On tarpeen poistaa laajennus verkkoselaimen lisäosien kanssa työskentelymekanismin kautta (Mozilla FF)
• Käytä menetelmää Asenna ulkoinen komponentti

Jos komponenttia ei ole asennettu, tehdään poikkeus.

2. Joissakin tapauksissa komponentti on asennettava väliaikaisesta tallennustilasta (tiedosto on saatu kolmannen osapuolen lähteestä, ulkoisesta käsittelystä), tässä tapauksessa ensimmäiset parametrit menetelmissä Yhdistä ulkoinen komponentti ja Asenna ulkoinen komponentti ovat väliaikaisessa varastossa olevan arkiston osoite. Alla on esimerkki siitä, kuinka se toimii: