Terrasoft վեբ ծառայությունների հետ աշխատել արտաքին հավելվածներից: Վեբ ծառայություններ Մենք ընդունում ենք ֆայլը՝ օգտագործելով 1c վեբ ծառայությունը

SelectionList=FormElements.AirportSelection.SelectionList; SelectionList.Clear(); AirportList=Aeroflot Service.AirportList().GetList("list"); TotalAirports=ListAirports.Count(); Համար ui=0 to TotalAirports-1 Cycle Airport=ListAirports.Get(ներ); SelectionList.Add(Airport.code, ""+Airport.city+" : "+Airport.name); End Cycle;
Այստեղ մեզ անհրաժեշտ է մի փոքրիկ մեկնաբանություն Airport List = ServiceAeroflot.AirportList().GetList("list");
Փաստն այն է, որ վեբ ծառայության մեթոդներով վերադարձված արժեքները հարթակում ներկայացված են XDTO Object տեսակի օբյեկտներով: Քանի որ XDTO տեխնոլոգիայի թեման դուրս է այս հոդվածի շրջանակներից, ես կասեմ միայն դրա համար փոխակերպումներայս օբյեկտը ցուցակի մեջ է (որն այն է), ես անվանեցի դրա GetList() մեթոդը: Մնացած ծածկագիրը բավականին ակնհայտ է, ներառյալ Օդանավակայանի կառուցվածքի դաշտերի անվանումները, որոնք ես գտա վեբ ծառայության նկարագրության էջում։
Այժմ դուք կարող եք գործարկել կոնֆիգուրացիան և համոզվել, որ ընտրության դաշտի ցանկը լցված է օդանավակայանների անուններով.

«Հեռանալու օր, ժամանման օր...».

Ընթացակարգ FillTableboard(Arrival=True) TableTableboard.Columns.Clear(); TableTableboard.Columns.Add («Թռիչքի կոդը», «Թռիչքի կոդը»); TableTableboard.Columns.Add(" Ավիաընկերության կոդը", "Airline"); TableTable.Columns.Add("FlightNumber", "Number"); TableTable.Columns.Add(" Օդանավակայանի տրանզիտ", "Օդանավակայանի տարանցում"); TableTable.Columns.Add("Օդանավակայան", "Օդանավակայան"+?(Ժամանումներ, մեկնումներ","ժամանումներ")); TableTable.Columns.Add(" Ժամանակացույց", "On ժամանակացույցով"); TableTableboard.Columns.Add(" Պլանավորված ժամանակ", "Planned"); TableTableboard.Columns.Add(" TimeActual«, «Փաստացի»); TableTable.Columns.Add («Հաշվարկված ժամանակ», «Հաշվարկված»); TableTable.Columns.Add («Վայրէջքի ժամանակ», ?(Ժամանում, վայրէջք», «Թռիչք»)); Աղյուսակ: Սյունակներ: Ավելացնել («Համակցված թռիչք», «Համակցված թռիչք»); TableTable.Columns.Add («Կարգավիճակ», «Կարգավիճակ»); Եթե ոչ ժամանումը, ապա TableTable.Columns.Add («Գրանցում», «Գրանցում»); TableTable .Սյունակներ .Ավելացնել("Վայրէջք", "Վայրէջք"); EndIf; Ձևի տարրեր. Ցուցատախտակի աղյուսակ. Ստեղծել սյունակներ(); Ձևի տարրեր. Ցուցատախտակի աղյուսակ. Սյունակներ. Թռիչքի կոդ. Տեսանելիություն = Սխալ; Եթե ոչ Ժամանում, ապա ձևի տարրեր. Ցուցատախտակ Աղյուսակ. Սյունակներ. Մոտավոր ժամանակ. Տեսանելիություն = Սխալ; Վերջ Եթե; Եթե Ժամանում, Ապա Տվյալներ = Աերոֆլոտ Ծառայություն. Ժամանում (Օդանավակայանի ընտրություն, Թռիչքի ամսաթիվ). Ստացեք ցուցակ («ցուցակ»); Հակառակ դեպքում Տվյալներ=Աերոֆլոտ ծառայություն. Մեկնում (օդանավակայանի ընտրություն, թռիչք Ամսաթիվ): Ստացեք ցուցակ ("ցուցակ"); EndIf; Ընդհանուր գրառումներ=Տվյալներ.Համար(); ii=0 համար TotalRecords-1 ցիկլի գրառում=DATA.Get(ներ); NewRow=TableTable.Add(); NewRow: AirlineCode=Record.company; NewLine.FlightNumber = Entry.flight_no; NewLine.AirportTransit = Entry.airport_inter; NewLine.Airport = Entry.airport; NewLine.TimeSchedule=Record.sched; NewLine.TimePlanned=Record.plan; NewLine.TimeActual=Գրառել.փաստ; NewLine.TimeCalculated=Record.calc; NewLine.LandingTime=Record.real; NewLine.UnionFlight=Record.union_flight_no; NewRow.Status=Record.status; If Not Arrival then NewLine.Registration=Record.is_check; NewLine.Landing = Entry.is_board; վերջԵթե; End Cycle; Ընթացակարգի ավարտը

Որպեսզի ստուգեմ, թե ինչպես է այդ ամենը աշխատում, ես ձևի հրամանի վահանակին ավելացրի «Թարմացնել» կոճակը՝ համապատասխան նկարով, և դրա մշակիչում գրեցի հետևյալը.

Ընթացակարգ CommandPanel1 Update(Button) FillTableboard(FormElements.TableboardPanel.CurrentPage=FormElements.TableboardPanel.Pages.Arrivals); Ընթացակարգի ավարտը
Ես պահպանում եմ, գործարկում, ընտրում, սեղմում, ստանում.

Հետբառ

Տպել (Ctrl+P)

Վեբ ծառայությունների մեխանիզմը 1C:Enterprise համակարգում սպասարկման վրա հիմնված ճարտարապետության (SOA) աջակցության միջոց է:
Ծառայության վրա հիմնված ճարտարապետությունը կիրառական ճարտարապետություն է, որտեղ բոլոր գործառույթները սահմանվում են որպես անկախ ծառայություններ՝ կանչվող միջերեսներով: Այս ծառայություններին որոշակի հաջորդականությամբ մուտք գործելը թույլ է տալիս իրականացնել այս կամ այն ​​բիզնես գործընթաց:
Ծառայությունների վրա հիմնված ճարտարապետությունը նոր մոտեցում է առաջարկում բաշխված տեղեկատվական համակարգեր ստեղծելու համար, որոնցում ծրագրային ապահովման ռեսուրսները դիտվում են որպես ցանցի միջոցով մատուցվող ծառայություններ: Այս մոտեցումը թույլ է տալիս բաշխված բաղադրիչների (ծառայությունների) արագ համախմբումը մեկ լուծման մեջ՝ աջակցելու կոնկրետ բիզնես գործընթացներին:
Վեբ ծառայությունների մեխանիզմը թույլ է տալիս օգտագործել 1C:Enterprise համակարգը որպես ծառայությունների մի շարք բարդ բաշխված և տարասեռ համակարգերում, ինչպես նաև թույլ է տալիս այն ինտեգրել այլ արդյունաբերական համակարգերի հետ՝ օգտագործելով սպասարկման վրա հիմնված ճարտարապետություն:
1C:Enterprise համակարգի կոնֆիգուրացիան կարող է արտահանել իր ֆունկցիոնալությունը վեբ ծառայությունների միջոցով: Վեբ ծառայության սահմանումները նշված են կազմաձևման ծառում և հասանելի են դառնում բոլորի համար տեղեկատվական համակարգերդրանք հրապարակելով վեբ սերվերում:
Բացի այդ, 1C:Enterprise համակարգը կարող է մուտք գործել երրորդ կողմի վեբ ծառայություններ ինչպես կազմաձևման ծառում սահմանված ստատիկ հղումների, այնպես էլ ներկառուցված լեզվով ստեղծված դինամիկ հղումների միջոցով: Բրինձ. 1. Վեբ ծառայություններ

1C:Enterprise 8 համակարգի սպասարկման ճարտարապետության հիմքում սպասարկման մենեջերն է: Սպասարկման մենեջերը կատարում է հետևյալ գործառույթները.
● տեղեկատվական բազաների հետ կապերի ֆոնդի կառավարում;
● WSDL ծառայության նկարագրության աջակցություն;
● SOAP արձանագրության ներդրում, հաղորդագրությունների սերիականացում, համապատասխան ծառայության զանգահարում։
Ծառայության մենեջերն աշխատում է ծառայության հյուրընկալող գործընթացում, որն իրականացնում է ծառայության կառավարիչից/դեպի հաղորդագրություններ ստանալու/փոխանցելու գործառույթը: IIS կամ Apache վեբ սերվերը կարող է օգտագործվել որպես ծառայության հոսթ:
Ծառայությունների կառավարիչը պարունակում է կապերի մի լողավազան, որի միջոցով փոխազդեցություն է տեղի ունենում 1C:Enterprise համակարգի տվյալների բազաների հետ:
1C:Enterprise համակարգում ներդրված վեբ ծառայությունների մեխանիզմը աջակցում է հետևյալ ստանդարտներին.
● SOAP 1.1,
● Օճառ 1.2,
● WSDL 1.1,
● WS-I Հիմնական պրոֆիլ 1.1,
● HTTP 1.1,
● TLS 1.x (TLS 1.1-ը և 1.2-ն աջակցվում են, եթե հաճախորդի վկայականը չի պահանջվում ուղարկել սերվեր), ներառյալ գաղտնագրման ալգորիթմները,
համապատասխան ԳՕՍՏ Ռ 34.10-2001, Ռ 34.10-94, Ռ 34.11-94 և 28147-89;
● MTOM;
● Նույնականացում. Հիմնական, NTLM/Բանակցել:

Վեբ ծառայություն մուտք գործելու համար դուք պետք է օգտագործեք հասցե, որը ձևավորվում է հետևյալ կերպ.

http://host/base/ws/WebServiceName

Http://host/base/ws/WebServiceAddress.

Եկեք մանրամասն նայենք հասցեի բաղադրիչներին.

http://host/base-ը սովորական URL է, որն օգտագործվում է մուտք գործելու համար, օրինակ, վեբ հաճախորդ օգտագործող տեղեկատվական բազա: Եթե ​​առկա են սահմանազատիչներ, Z պարամետրի միջոցով սահմանազատող արժեքների նշումը չի ապահովվում հրամանի տողգործարկել հաճախորդի հավելվածը:

ws-ը նշան է, որ վեբ ծառայություն մուտք է գործում (ի տարբերություն hs-ի, որը սահմանում է մուտք դեպի HTTP ծառայություն, տես այստեղ):

WebServiceName – վեբ ծառայության անվանումը: Սահմանել Վեբ ծառայության օբյեկտի հատկությունը:

WebServiceAddress – նկարագրում է վեբ ծառայություն մուտք գործելու այլընտրանքային անուն: Այն դրված է Վեբ ծառայության օբյեկտի Publishing file name հատկության մեջ: Այն կարող է փոփոխվել Վեբ ծառայությունը հրապարակելիս:

WebServiceName անունով և վեբ ծառայության WebServiceAddress հասցեով զանգերը համարժեք են:

Վեբ ծառայությունների միջոցով ֆունկցիոնալության ապահովում

Որպեսզի 1C:Enterprise համակարգի ֆունկցիոնալությունը հասանելի դառնա վեբ ծառայությունների արտաքին սպառողների համար, դուք պետք է կատարեք հետևյալ քայլերը.
● ստեղծել անհրաժեշտ թվով վեբ ծառայություններ կոնֆիգուրացիայի մեջ,
● հրապարակել վեբ ծառայությունները հատուկ կոնֆիգուրատորի գործիքի միջոցով:
Վեբ ծառայությունների հրապարակման ընթացակարգի նկարագրությունը և 1C:Enterprise մուտք գործելու համար Reverse Proxy-ի օգտագործման նկարագրությունը գրված է 7-րդ գլխում «Ադմինիստրատորի ուղեցույց» ITS սկավառակի վրա:
Վեբ ծառայության ստեղծումը բաղկացած է.
● ավելացնելով վեբ ծառայության կազմաձևման օբյեկտ մետատվյալների ծառին,
● այն գործողությունների նկարագրությունը, որը կարող է կատարել ստեղծված վեբ ծառայությունը,
● Վեբ ծառայության գործառնությունների պարամետրերի նկարագրությունը:
Վեբ ծառայության կազմաձևման օբյեկտը պարունակում է մոդուլ, որտեղ ներկառուցված լեզվով ստեղծվում են ընթացակարգեր, որոնք կատարվում են, երբ կանչվում են վեբ ծառայության որոշակի գործողություններ: Վեբ ծառայության գործարկման պարամետրերի տեսակները նկարագրված են XDTO տեսակների միջոցով և կարող են լինել կամ XDTO արժեքներ կամ XDTO օբյեկտներ:
Վեբ ծառայությունը կոչվում է հետևյալ կերպ.
● հետ կապի լողավազանից ընտրված է համապատասխան միացում տեղեկատվական բազան; եթե չկա պահանջվող կապ, ստեղծվում է կապ.
● ստեղծվում է նոր նիստ, և ստեղծված նիստի համար բարձրացվում է իրադարձություն SettingSessionParameters(սեսիայի մոդուլում);
● կանչվում է պահանջվող վեբ ծառայության մեթոդը և կանչվում է մշակիչը SettingSessionParameters()(սեսիայի մոդուլում) ամեն անգամ, երբ մուտք է գործում չնախնականացված նստաշրջանի պարամետր:
ԽՈՐՀՈՒՐԴ. Խորհուրդ չի տրվում իրականացնել ռեսուրսների ինտենսիվ գործողություններ իրադարձությունների մշակիչում SettingSessionParameters.
Իրադարձություն SettingSessionParametersՍեսիայի մոդուլը կանչվում է սերվերի վրա արտոնյալ ռեժիմով: Զանգված ծառայության մոդուլը գործարկվում է
սերվեր նորմալ ռեժիմում:
Սեսիայի մոդուլն օգտագործվում է նիստի պարամետրերը սկզբնավորելու և հրամանների որոշակի փաթեթ կատարելու համար 1C:Enterprise համակարգի ցանկացած վեբ ծառայություն զանգահարելիս:

Վեբ ծառայության իրականացման օրինակ

Օրինակ, դուք պետք է ստեղծեք 1C:Enterprise համակարգի վեբ ծառայություն, որը պետք է վերադարձնի իր աղյուսակային մասի կազմը՝ օգտագործելով փոխանցված հաշիվ-ապրանքագրի համարը: Նմանատիպ օրինակ, օգտագործելով HTTP ծառայությունները, կքննարկվի մեկ այլ հոդվածում:
Վերադարձի արժեքը նկարագրելու համար եկեք ստեղծենք XDTO փաթեթ Հաշիվ-ապրանքագրի տվյալներանվանատարածքով http://www.MyCompany.ru/shipment,պարունակում է երեք տեսակի XDTO օբյեկտներ.
● Nomenclature – Nomenclature directory տարրից տվյալներ փոխանցելու համար: Այս XDTO օբյեկտի տեսակը կպարունակի հետևյալ հատկությունները.
● Անուն – տողի տեսակը անվանատարածքից
● Ամբողջական անուն- տողի տեսակը անվանատարածքից http://www.w3.org/2001/XMLSchema;
● Շտրիխ կոդ – տողի տեսակը անվանատարածքից http://www.w3.org/2001/XMLSchema;
● PurchasePrice – int մուտքագրեք անվանատարածքից http://www.w3.org/2001/XMLSchema.
● Հաշիվ-ապրանքագրի տող- հաշիվ-ապրանքագրի մեկ տողով տվյալներ փոխանցելու համար: Այս XDTO օբյեկտի տեսակը կպարունակի հետևյալ հատկությունները.
● Անվանակարգ – անվանատարածքից մուտքագրեք Անվանակարգ; հղում է XDTO օբյեկտին,
որը մենք սահմանեցինք վերևում;
● Քանակ – int տեսակը անվանատարածքից http://www.w3.org/2001/XMLSchema;
● Գին – int մուտքագրեք անվանատարածքից http://www.w3.org/2001/XMLSchema;
● Sum – int տեսակը անվանատարածքից http://www.w3.org/2001/XMLSchema:
● Վաճառքի հաշիվ-ապրանքագիր- հաշիվ-ապրանքագրի բոլոր տողերի վերաբերյալ տվյալները փոխանցելու համար: Այս XDTO օբյեկտի տեսակը կպարունակի մեկ հատկություն.
● Կազմը – տեսակ Հաշիվ-ապրանքագրի տողանունների տարածությունից http://www.MyCompany.ru/shipment. Ներկայացնում է հղում XDTO օբյեկտին,
որը մենք սահմանեցինք վերևում: Որպեսզի այս հատկությունը պահպանի անսահմանափակ թվով արժեքներ, դուք պետք է այն սահմանեք
գույք Վերին սահմանը -1.
Երբ ստեղծվեն անհրաժեշտ XDTO տեսակները, դուք պետք է նոր վեբ ծառայություն ավելացնեք կազմաձևում Հաշիվ-ապրանքագրի տվյալներգույքի հետևյալ արժեքներով.

● Անվանատարածքի URI – http://www.MyCompany.ru/shipment;
● XDTO փաթեթներ – Հաշիվ-ապրանքագրի տվյալներ;
● Հրապարակման ֆայլի անվանումը– առաքում.1cws.
Ստեղծված վեբ ծառայությունը պետք է ունենա Get օպերացիան սահմանված հետևյալ հատկության արժեքներով.
● Վերադարձի տեսակը – Վաճառքի հաշիվ-ապրանքագիրանունների տարածությունից http://www.MyCompany.ru/shipment;
● Հնարավոր դատարկ արժեք- Տեղադրվել;
● Ընթացակարգի անվանումը – Ստացեք:
Get գործողության համար դուք պետք է սահմանեք DocumentNumber պարամետրը հետևյալ հատկության արժեքներով.
● Արժեքի տեսակ – տողի տեսակը անվանատարածքից http://www.w3.org/2001/XMLSchema;
● Փոխանցման ուղղություն – Մուտք.
Դրանից հետո դուք պետք է բացեք ստեղծված վեբ ծառայության մոդուլը և այս մոդուլում տեղադրեք Get() ֆունկցիան, որը կկատարվի այս վեբ ծառայության կանչի ժամանակ։

Երրորդ կողմի վեբ ծառայությունների հետ աշխատելը

1C:Enterprise համակարգը կարող է օգտագործել այլ մատակարարների կողմից տրամադրվող վեբ ծառայությունները մի քանի ձևով.
● օգտագործելով ստատիկ հղումներ, որոնք ստեղծված են կազմաձևման ծառում;
● օգտագործելով ներկառուցված լեզվական գործիքներով ստեղծված դինամիկ հղումներ;
● նախորդ մեթոդների համադրություն.
Ստատիկ հղումների օգտագործման առավելությունն ավելի մեծ արագությունն է, քանի որ մատակարարի վեբ ծառայության նկարագրությունը ստացվում է միայն մեկ անգամ՝ հղումը ստեղծելիս։ Հետագայում այս վեբ ծառայություն մուտք գործելիս օգտագործվում է վեբ ծառայության առկա նկարագրությունը:
Դինամիկ հղումներ օգտագործելիս մատակարարի վեբ ծառայության նկարագրությունը կստանա 1C:Enterprise համակարգը ամեն անգամ, երբ վեբ ծառայությունը կանչվի, ինչը, բնականաբար, կդանդաղեցնի այս վեբ ծառայության հետ աշխատանքը: Այնուամենայնիվ, այս մոտեցման առավելությունը մատակարարի վեբ ծառայության արդի նկարագրություն ստանալու հնարավորությունն է: Ստատիկ հղումներ օգտագործելիս վեբ ծառայության ընթացիկ նկարագրությունը ստանալու համար դուք պետք է նորից ներմուծեք WSDL նկարագրությունը՝ օգտագործելով կոնֆիգուրատորը և պահպանեք փոխված կոնֆիգուրացիան:
Հավելվածային լուծումների գործարկման ժամանակ կարող է առաջանալ մի իրավիճակ, երբ նույն վեբ ծառայությունը տրամադրվում է տարբեր հասցեներով (URL), բայց ունի ճիշտ նույն նկարագրությունը (WSDL): Այս դեպքում անհրաժեշտություն կա բեռնել վեբ ծառայության նկարագրությունը կոնֆիգուրացիայի մեջ (ստեղծել օբյեկտ կոնֆիգուրացիայի օբյեկտների ծառում), բայց օգտագործման ընթացքում նշեք կոնկրետ հասցեն, որտեղ գտնվում է վեբ ծառայությունը: Համակցված մեթոդը թույլ է տալիս աշխատել այս կերպ. Որպես օրինակ, դիտարկեք հետևյալ իրավիճակը. կա կրկնօրինակված վեբ ծառայություն, որը գործում է
որոշ գործառույթ: 1C:Enterprise-ում գրված կիրառական լուծումն օգտագործում է այս ծառայության ծառայությունները, մինչդեռ ծառայության հասցեն կարող է տարբեր լինել (ծառայությունը կրկնօրինակելի է), և նկարագրությունը ամրագրված է: Այնուհետև վեբ ծառայության նկարագրությունը կարող է բեռնվել հավելվածի լուծման մեջ, և հավելվածի լուծման կարգավորումներում նախատեսել մուտքագրել ծառայության կոնկրետ օրինակի հասցեն, որը (հասցեն) կօգտագործվի շահագործման ընթացքում:
Հասանելի է նաև մեկ այլ մեթոդ՝ օգտագործվում է դինամիկ հղում, սակայն վեբ ծառայության գտնվելու վայրի հասցեն չի ստացվում նկարագրության ֆայլից (WSDL), այլ ուղղակիորեն նշվում է օբյեկտը ստեղծելիս։
Երբ փորձում եք բեռնել վեբ ծառայության նկարագրությունը կոնֆիգուրատորում (ստատիկ հղում ստեղծելով) կամ դինամիկ հղում օգտագործելիս (օգտագործելով WS Definition օբյեկտը), համակարգը ստուգում է բեռնված վեբ ծառայության նկարագրությունը (WSDL): Եթե ​​վեբ ծառայության նկարագրության մեջ սխալ կա (1C:Enterprise համակարգի «տեսանկյունից»), ապա նկարագրությունը չի բեռնվի և կստեղծվի բացառություն: Բացառության տեքստը կպարունակի ներբեռնման ձախողման պատճառների մանրամասն ախտորոշում: WSDL-ի սխալները թվարկված են այն հերթականությամբ, որով դրանք հանդիպել են: WSDL-ի յուրաքանչյուր սխալ պարունակում է հետևյալ մանրամասն նկարագրությամբ գրառում.

<Тип элемента с ошибкой>.<Имя>
[<Тип элемента с ошибкой>.<Имя>[…]]
<Описание ошибки>
<Тип элемента с ошибкой>
<Имя>
Այս նկարագրության մեջ.
● Սխալով տարրի տեսակը WSDL տարրի տեսակն է: Ամենից հաճախ համապատասխանում է վեբ ծառայությունը նկարագրող xml ֆայլի պիտակի անվանը:
● Սխալի նկարագրություն – կոնկրետ սխալի նկարագրություն:
● Անուն — WSDL օբյեկտի անվանումը, որտեղ տեղի է ունեցել սխալը:

Ստատիկ WS հղում օգտագործելու օրինակ

Որպես երրորդ կողմի վեբ ծառայությունների օգտագործման օրինակ, հաշվի առեք զանգահարել վեբ ծառայություն, որը նախկինում ստեղծվել է վերը նշված օրինակում

Առաջին հերթին, դուք պետք է ավելացնեք նոր WS-հղման կոնֆիգուրացիայի օբյեկտ՝ Invoice Data անունով, կազմաձևման ծառին, որը վերաբերում է հրապարակված ծառայությանը: Դա անելու համար ներմուծեք հրապարակված ծառայության WSDL նկարագրությունը և նշեք որպես URL http://www.MyCompany.ru/shipment/ws/Shipment.1cws?wsdl. WSDL նկարագրության ներմուծման նկարագրությունը գրված է մեկ այլ հոդվածում:
Դրանից հետո, օրինակ, հաշիվ-ապրանքագրի մոդուլում կարող եք ստեղծել ստորև ներկայացված ընթացակարգը: Այն լրացնում է փաստաթղթի աղյուսակային մասը մատակարարի վեբ ծառայության միջոցով ստացված մատակարարի հաշիվ-ապրանքագրերով:

Եթե ​​ծառայության իրական գտնվելու վայրի հասցեն տարբերվում է այն հասցեից, որն օգտագործվել է վեբ ծառայության նկարագրությունը կոնֆիգուրացիայի մեջ բեռնելիս,
ապա նոր հասցեն պետք է հստակորեն նշվի WSProxy օբյեկտը ստեղծելիս.

Դինամիկ WS հղում օգտագործելու օրինակ

Դինամիկ կապի օգտագործումը տարբերվում է ստատիկ հղումից միայն այն ձևով, որով ստեղծվում է WS վստահված անձը, և կարիք չկա ստեղծել WS հղում կոնֆիգուրացիայի ծառում:
Եթե ​​համեմատենք նախորդ բաժնում ներկայացված օրինակի հետ, ապա, ի տարբերություն ստատիկ հղման վրա հիմնված պրոքսի ստեղծելու, դինամիկ հղում օգտագործելիս, WS վստահված անձը ստեղծվում է հետևյալ կոնստրուկտորի միջոցով.

// Ստեղծեք WS վստահված անձ՝ հիմնվելով WS սահմանման վրա
Սահմանում = Նոր WSD սահմանում («http://www.MyCompany.ru/shipment/ws/Shipment.1cws?wsdl»);
Proxy = New WSPProxy (Սահմանում, «http://www.MyCompany.ru/shipment», «Invoice Data», «Soap Invoice Data»);
Ստատիկ հղման վրա հիմնված WS վստահված անձ ստեղծելիս այսպիսի տեսք ունի.

// Ստեղծեք WS վստահված անձի հղման հիման վրա
Վստահված անձ = WSLinks.InvoiceData: CreateWSProxy («http://www.MyCompany.ru/shipment», «InvoiceData», «InvoiceData»);
Եթե ​​ծառայության իրական գտնվելու վայրի հասցեն տարբերվում է WSDL ֆայլում նշված հասցեից, որն օգտագործվում է վեբ ծառայությունների սահմանումը ստեղծելու համար, ապա նոր հասցեն պետք է հստակորեն նշվի WSProxy օբյեկտը վեբ ծառայությունների սահմանումից ստեղծելիս.

Վեբ ծառայության հատկությունների խմբագրում

Հիմնական ներդիրում մուտքագրեք օբյեկտի անունը, հոմանիշը և մեկնաբանությունը:
Գործողություններ ներդիրում ստեղծվում են ենթակա Գործողությունների օբյեկտներ, որոնք, իր հերթին, կարող են ունենալ ստորադաս Պարամետրերի օբյեկտներ, որոնք անհրաժեշտ են այս տեսակի օբյեկտների հետ աշխատելու համար: Ստորադաս օբյեկտների նկարագրությունը կատարվում է հատկությունների ներկապնակում:

Գործողության հատկություններ

Բացի կազմաձևման օբյեկտների ընդհանուր հատկություններից, վեբ ծառայության գործողությունը պարունակում է հետևյալ հատկությունները.

● Վերադարձի արժեքի տեսակ – արժեքի տեսակը, որը վերադարձնում է վեբ ծառայության գործողությունը: Կարող է լինել XDTO արժեքի տեսակ կամ օբյեկտի տեսակ
XDTO.
● Null Possible — Ցույց է տալիս, թե արդյոք վերադարձվող արժեքը կարող է լինել զրոյական:
● Գործարքում – ցույց է տալիս, թե արդյոք վեբ ծառայության մոդուլի կոդը կկատարվի գործարքի ժամանակ, թե ոչ: Եթե ​​հատկությունը սահմանված է, ապա երբ վեբ ծառայությունը կանչվի, գործարքը ավտոմատ կերպով կսկսվի, և երբ վեբ ծառայությունն ավարտվի, գործարքը կամ կկատարվի, կամ գործարքը հետ կվերցվի (կախված կատարման արդյունքներից): Եթե ​​հատկությունը սահմանված չէ, երբ վեբ ծառայության մոդուլը սկսում է գործարկել
գործարքը չի սկսվի.
● Մեթոդի անվանում – Վեբ ծառայության մոդուլի արտահանվող ընթացակարգի անվանումը, որը կկատարվի այս հատկությունը կանչելիս:
Ենթահամակարգեր ներդիրը ցույց է տալիս, թե այս տեսակի օբյեկտները որ ենթահամակարգերին են պատկանում:
Այլ ներդիրում սահմանվում են հետևյալ հատկությունները.
● Անվանատարածության URI — պարունակում է վեբ ծառայության անվանատարածքի URI: Յուրաքանչյուր վեբ ծառայություն կարող է եզակիորեն նույնականացվել իր կողմից
անվանումը և URI, որին այն պատկանում է: Ծառայության անվանումների տարածքը չպետք է լինի նույնը, ինչ հայտնի անունների տարածքները, որոնք արդեն օգտագործվում են կամ վերապահված են այլ կազմակերպությունների կողմից: Խորհուրդ է տրվում, որ ծառայության անվանումների տարածքը ներառի մի հատված, որը եզակի է վեբ ծառայությունը մշակող կազմակերպության համար: Օրինակ, Promresurs կոչվող կազմակերպության համար իմաստ ունի բոլոր անվանատարածքները սկսել նախածանցով, օրինակ՝ http://promresurs.com: Այնուհետև վեբ ծառայության անվանատարածքի URI-ն նման կլինի http://promresurs.com/public/services/OurService.
● XDTO փաթեթներ – XDTO փաթեթների ցանկ, որոնց տեսակները կարող են օգտագործվել որպես վեբ ծառայության գործառնական վերադարձի տեսակներ և գործառնական պարամետրերի տեսակներ:
● Հրապարակման ֆայլի անվանում – Վեբ ծառայության նկարագրության ֆայլի անվանումը, որը գտնվում է վեբ սերվերում:
Սեղմելով Module կոճակը, բացվում է վեբ ծառայության մոդուլի խմբագրիչը:

Պարամետրային հատկություններ
Բացի կազմաձևման օբյեկտների ընդհանուր հատկություններից, Վեբ ծառայության գործառնական պարամետրը պարունակում է հետևյալ հատկությունները.
● Արժեքի տեսակ՝ Վեբ ծառայության գործառնական պարամետրի արժեքի տեսակը: Կարող է լինել XDTO արժեքի տեսակ կամ XDTO օբյեկտի տեսակ:
● Null Possible – ցույց է տալիս, թե արդյոք գործողության պարամետրի արժեքը կարող է զրո լինել:
● Հաղորդման ուղղություն – որոշում է տվյալների փոխանցման ուղղությունը՝ օգտագործելով այս պարամետրը: Հնարավոր արժեքներ.
● Մուտք – նշանակում է, որ պարամետրն օգտագործվում է տվյալների վեբ ծառայությանը փոխանցելու համար;
● Արդյունք – նշանակում է, որ պարամետրն օգտագործվում է վեբ ծառայությունից տվյալներ ստանալու համար;
● Մուտք-Ելք – նշանակում է, որ պարամետրը կարող է օգտագործվել ինչպես տվյալների փոխանցման, այնպես էլ վեբ ծառայությունից ստանալու համար:

Թեմայի վերնագիրը իսկապես հարցական է, քանի որ... Ես ինքս չգիտեմ, թե դա ինչ է և առաջին անգամ կփորձեմ աշխատել դրա հետ այս հոդվածի շրջանակներում: Միակ բանը, որ կարող եմ երաշխավորել, այն է, որ ստորև ներկայացված կոդը կաշխատի, բայց իմ արտահայտությունները կլինեն միայն ենթադրություններ և ենթադրություններ այն մասին, թե ես ինքս ինչպես եմ հասկանում այս ամենը։ Այսպիսով, եկեք գնանք ...

Ներածություն

1. Օճառ. Նախքան հեռակա ընթացակարգ կանչելը, դուք պետք է նկարագրեք այս զանգը XML ֆայլում SOAP ձևաչափով: SOAP-ը պարզապես XML նշումներից մեկն է, որն օգտագործվում է վեբ ծառայություններում: Այն ամենը, ինչ մենք ուզում ենք ինչ-որ տեղ ուղարկել HTTP-ի միջոցով, սկզբում վերածվում է XML SOAP-ի նկարագրության, այնուհետև լցվում է HTTP փաթեթի մեջ և ուղարկվում է ցանցի մեկ այլ համակարգչի՝ TCP/IP-ի միջոցով:
2. WSDL. Կա վեբ ծառայություն, այսինքն. ծրագիր, որի մեթոդները կարելի է զանգահարել հեռակա կարգով: Բայց ստանդարտը պահանջում է, որ այս ծրագիրը ուղեկցվի նկարագրությամբ, որն ասում է, որ «այո, դուք իրավացի եք. սա իսկապես վեբ ծառայություն է, և դուք կարող եք զանգահարել այս կամ այն ​​մեթոդներից»: Այս նկարագրությունը ներկայացված է մեկ այլ XML ֆայլով, որն ունի այլ ձևաչափ, այն է՝ WSDL: Նրանք. WSDL-ը պարզապես XML ֆայլ է, որը նկարագրում է վեբ ծառայությունը և ոչ ավելին:

Ընդհանուր մոտեցում

1. Նկարագրեք մեր վեբ ծառայության ինտերֆեյսը
2. Իրականացնել այս ինտերֆեյսը
3. Գործարկեք մեր վեբ ծառայությունը
4. Գրեք հաճախորդ և հեռակա կարգով զանգահարեք վեբ ծառայության ցանկալի մեթոդը

Սերվեր

Հաճախորդ

Եզրակացություն

Այս հոդվածում ես ձեզ կասեմ արտաքին հավելվածներից Terrasoft վեբ ծառայությունների հետ աշխատելու սկզբունքները: Օգտագործելով այս մեխանիզմները, դուք կարող եք իրականացնել ինտեգրման տարբեր առաջադրանքներ ցանկացած արտաքին համակարգի հետ:

Երրորդ կողմի հավելվածներից վեբ ծառայությունների հետ աշխատելու երկու եղանակ կա, ամեն ինչ կախված է օգտագործման նպատակից և ծրագրավորման հատուկ լեզվից.
1. Terrasoft COM օբյեկտների միջոցով աշխատելը
2. Ուղիղ աշխատել վեբ ծառայությունների հետ

Աշխատեք COM օբյեկտների միջոցով

Առաջին տարբերակը ամենաքիչ աշխատատար է և ավելի հարմար, սակայն պահանջում է, որ Terrasoft գրադարանները գրանցվեն հաճախորդի մեքենայում (COM օբյեկտներ օգտագործելու համար): Այս դեպքում վեբ ծառայությունների հետ ամբողջ աշխատանքը կիրականացվի Terrasoft COM օբյեկտների կողմից՝ ապահովելով տվյալների և օբյեկտների հասանելիություն Terrasoft հարթակի օբյեկտային մոդելի միջոցով՝ IDataset, ISelectQuery և այլն:

Ծրագրային կերպով միանալու համար հարկավոր է գործարկել հետևյալ կոդը (օրինակ Jscript-ում, բայց դա կարող է իրականացվել ցանկացած լեզվով, որն աշխատում է COM օբյեկտների հետ).

// Ստեղծեք միակցիչ և կոնֆիգուրացիա COM օբյեկտների օրինակներ
WSConnector = նոր ActiveXObject( «TSDskObjectLibrary.DskConnector») ; // 3.4.0+ տարբերակների համար օբյեկտը ստեղծվում է ActiveXObject("TSObjectLibrary.Connector")
var WSCconfiguration = նոր ActiveXObject( «TSObjectLibrary.Configuration») ;
WSConfiguration.DBExecutorTypeCode = "WebServices" ;

// Ստեղծված կապի քեշավորում
Connector.Attributes("WSConnector") = WSCconnector;

// Սահմանել կապի տողը և սերվերի վրա կազմաձևված կազմաձևի անվանումը
WSConfiguration.SetConnectionString(
""URL=http://192.168.227.128/TSWebServicesServerLibrary.dll/soap/IServer"" +
","ConfigurationName=Dev332"" );

// Բացել կոնֆիգուրացիան
var IsConnected = WSConnector.OpenConfiguration (
WSC կոնֆիգուրացիա
1 , // Նույնականացման տեսակը՝ 0 - Windows Authentication, 1 - Server
«ddd» // Օգտագործողի անունը
""); // Գաղտնաբառ

Հաջող կապից հետո մենք կարող ենք մուտք գործել ցանկացած օբյեկտ, ստանալ տվյալներ և այլն: Օրինակ՝ կոնտրագենտների մասին տվյալներ ստանալը.

// ds_Account ծառայության ստացում վեբ ծառայությունների միակցիչից
var AccountDataset = WSConnector.Services .GetSingleItemByUSI ("ds_Account");

// Տվյալների հավաքածուի պատրաստում. ֆիլտրերի փակում և մաքրում
AccountDataset.Close();
EnableDatasetFilters (AccountDataset, false);

// Զտել ընթացիկ գրառման ID-ով
ApplyDatasetFilter(AccountDataset, «ID» , dlData.Dataset («ID») , true);

// Տվյալների հավաքածուի բացում
AccountDataset.Open();

// Կարդացեք տվյալները
եթե (AccountDataset.IsEOF) (
var Value = "(տվյալներ չկան)" ; !}
edtWSName.Value = Արժեք;
edtWSOfficialName.Value = Արժեք;
edtWSCode.Value = Արժեք;
) ուրիշ (
edtWSName.Value = AccountDataset.ValAsStr («Անուն»);
edtWSOfficialName.Value = AccountDataset.ValAsStr ("OfficialAccountName");
edtWSCode.Value = AccountDataset.ValAsStr («Կոդ»);
}

// Տվյալների հավաքածուի փակում
AccountDataset.Close();

Կցված է Jscript-ում վեբ ծառայությունների հետ աշխատելու ամբողջական օրինակ՝ օգտագործելով COM օբյեկտները:

Անմիջականորեն աշխատել վեբ ծառայությունների հետ

Այս տեսակի աշխատանքն ավելի դժվար է, քանի որ... Վեբ ծառայություններին ուղղված բոլոր հարցումները պետք է ուղարկվեն ինքնուրույն, և դուք պետք է նաև ինքներդ մշակեք սերվերի պատասխանը: Սա չի օգտագործում Terrasoft COM օբյեկտներ, հետևաբար կարիք չկա տեղադրել և գրանցել Terrasoft գրադարանները յուրաքանչյուր հաճախորդի համակարգչի վրա, որտեղից կպահանջվեն վեբ ծառայություններ:

Վեբ ծառայություններին հարցումները կարող են ուղարկվել դրանց ինտերֆեյսի (WSDL) հիման վրա՝ պարամետրերով բոլոր մեթոդների նկարագրությունը:

Վեբ ծառայությունների հետ աշխատելու ծրագրերի մշակումը պարզեցնելու համար որոշ IDE-ներ, օրինակ՝ Visual Studio-ն, ապահովում են WSDL-ի ներմուծում (Add WebService Reference), մինչդեռ IDE-ն ինքն է ստեղծում վեբ ծառայությունների հետ աշխատելու փաթաթման դասեր: Նման դասի մեթոդներ կանչելով՝ դուք պարզապես կկանչեք վեբ ծառայության համապատասխան մեթոդները։

Պարզեցումը կայանում է նրանում, որ վեբ ծառայության մեթոդ կանչելու համար անհրաժեշտ է ուղարկել ամբողջական XML հարցում, իսկ wrapper դասերի օգնությամբ պարզապես զանգահարել համապատասխան մեթոդը պարամետրերով:

Օրինակ C#-ում.

// Ստեղծեք վեբ ծառայության հաճախորդ
ws. ISserver sc = նոր ws. ServerClient (); // ws.IServer – փաթաթման դաս Terrasoft վեբ ծառայությունների հետ աշխատելու համար
ws. OpenConfigurationRequest rqOpenConfiguration = նոր ws: OpenConfigurationRequest(); // Խնդրում է բացել կոնֆիգուրացիան
ws. OpenConfigurationResponse rsOpenConfiguration = նոր ws: OpenConfigurationResponse();

// Բացել կոնֆիգուրացիան
rqOpenConfiguration. ACompressionLevel = 0; //Առանց սեղմման (zip)
rqOpenConfiguration. AConfigurationName = Կազմաձևում;
rqOpenConfiguration. ADExecutorTypeCode = "MSSQL" ;
rqOpenConfiguration. AUserName = Username;
rqOpenConfiguration. AUserPassword = Գաղտնաբառ;
rsOpenConfiguration = sc. OpenConfiguration (rqOpenConfiguration);

Միևնույն ժամանակ տվյալների փոխանցում, մեծ տվյալների փաթեթների բաժանում, սերվերի պատասխանի վերլուծություն և այլն: դուք պետք է դա իրականացնեք ինքներդ:

Կցվում է C#-ով վեբ ծառայությունների հետ աշխատելու ամբողջական օրինակ:

Հատուկ շնորհակալություն Ալեքսանդր Կրավչուկին ներկայացված օրինակների համար։

Բարեբախտաբար, վեբ ծառայությունների հետ աշխատելու սահմանափակումներ չկան:

Մետատվյալներին վեբ ծառայության ավելացում

Բացեք կազմաձևման ծառը, ճյուղը Ընդհանուր են, Հետագա Վեբ ծառայություններ, ավելացրեք նոր վեբ ծառայություն (ես այն կանվանեմ my_ws) և լրացրեք հատկությունները, ինչպես ցույց է տրված նկարում։

Վեբ ծառայությունների հատկությունների վերաբերյալ մի քանի պարզաբանումներ պետք է արվեն։

• XDTO փաթեթներ- Այս դաշտը նշում է XDTO փաթեթների ցանկը, որոնց տեսակները կարող են օգտագործվել այն արժեքով, որը վերադարձվում է վեբ ծառայության գործողությունների արդյունքում:
• Անվանատարածքի URIտող է, որը սահմանում է այս վեբ ծառայության անվանատարածքի URI: Ցանկացած վեբ ծառայություն կարող է եզակիորեն նույնականացվել իր անվան և անվանատարածքի համադրությամբ: Պետք է հստակ հասկանալ, որ այս հատկությունը կապ չունի վեբ սերվերի ֆիզիկական հասցեի կամ կազմակերպության կայքի և այլնի հետ: Դա պարզապես վիրտուալ հասցե է: Հետևաբար, դուք պետք է հստակ անուն նշանակեք, որը կարող է պատմել, օրինակ, վեբ ծառայության գտնվելու վայրի և կիրառման տարածքի մասին: Մասնավորապես, կարող է լինել ստանդարտ կոնֆիգուրացիայի հապավումը, որին պատկանում է վեբ ծառայությունը:

Վեբ ծառայության գործառնություններ

Վեբ ծառայության գործունեությունը ապահովելու համար անհրաժեշտ է դրա համար ստեղծել գործողություններ, որոնք կկատարեն որոշակի գործողություններ և անհրաժեշտության դեպքում կվերադարձնեն անհրաժեշտ տվյալները:

Որպես օրինակ՝ եկեք ստեղծենք գործողություն մեր վեբ ծառայության համար, որը կվերադարձնի «Բարև աշխարհ» դասական արտահայտությունը: Եկեք զանգենք նրան Բարեւ:

Եկեք վեբ ծառայության մոդուլում ստեղծենք ֆունկցիա Բարեւ աշխարհ(), որի հղումը կտեղադրվի գործողության համապատասխան հատկության մեջ։

Բայց այս գործողությունը մեկ թերություն ունի. Դուք չեք կարող բնօրինակ տվյալները փոխանցել դրան: Այս նպատակների համար վեբ ծառայությունների գործառնություններն օգտագործում են իրենց ենթակա օբյեկտները. Ընտրանքներ.

Ավելացնենք ևս մեկ գործողություն. Բարև Ձեզ, և դրա համար ստեղծեք պարամետր Անուն.

Այս գործողությունը ողջույն կվերադարձնի օգտագործողին՝ զանգահարելով հետևյալ գործառույթը.

Վեբ ծառայության հրապարակում

Այժմ մենք պատրաստ ենք հրապարակել վեբ ծառայությունը։ Դա անելու համար դուք պետք է մուտք գործեք կոնֆիգուրատոր՝ ադմինիստրատորի իրավունքներով: Կտտացրեք 1C դյուրանցմանը սեղմեք աջև ընտրեք ցանկի համապատասխան տարրը՝

Ընտրեք ցանկից Վարչություն —> Հրապարակում վեբ սերվերում

Բացվող պատուհանում մուտքագրեք հրապարակման անունը և նշեք վանդակը Հրապարակեք վեբ ծառայություններև նաև նշեք մեր ստեղծած վեբ ծառայությունը.

WS հղումներ

Վեբ ծառայությունների հետ աշխատելու համար օգտագործվում է հետևյալ 1C օբյեկտը. WS-հղում. Դա վեբ ծառայության WSDL նկարագրությունն է, որը ստացվում է ներմուծման միջոցով այն աղբյուրից, որի վրա գտնվում է վեբ ծառայությունը: Այսինքն, առաջին հերթին մենք պետք է իմանանք այն հասցեն, որտեղից կարող ենք ստանալ վեբ ծառայության WSDL նկարագրությունը։ Մեր օրինակի հետ կապված, վեբ ծառայության ստեղծման և հրապարակման ընթացքում մեր կողմից կատարված կարգավորումների համաձայն, այս հասցեն կունենա հետևյալ տեսքը.

Http://localhost/professia1c/ws/my_ws.1cws?wsdl

Տեսնենք, թե ինչ մասերից է բաղկացած այս հասցեն։

• http://localhost/- Այս հասցեն ցույց է տալիս վեբ սերվերի ֆիզիկական գտնվելու վայրը: Քանի որ ես այն ունեմ տեղական մեքենայի վրա, դա localhost է, բայց գործնականում սա կամ սերվերի IP հասցեն է կամ նրա անունը
• մասնագիտություն1cհրապարակման անվանումն է։ Մենք այն մտցրինք դաշտ Անուներկխոսության մեջ, երբ վեբ ծառայությունը հրապարակվեց
• ws- նշան, որ մենք մուտք ենք գործում վեբ ծառայություն
• my_ws.1cws— հրապարակման ֆայլի անվանումը, որը մենք նշել ենք վեբ ծառայությունը ստեղծելիս հատկություններում
• wsdl- պարամետր, որը ցույց է տալիս, որ մենք պետք է ստանանք WSDL նկարագրություն

Վեբ ծառայության հրապարակումից հետո, որպեսզի համոզվեք, որ այն հաջողությամբ հրապարակվել է, կարող եք մուտքագրել դրա WSDL նկարագրության հասցեն ձեր բրաուզերի հասցեագոտում: Այս դեպքում մենք պետք է ստանանք XML ֆայլ բրաուզերի պատուհանում մոտավորապես հետևյալ բովանդակությամբ.

1. Օգտագործելով դինամիկ ws հղում:
2. Ստատիկ ws հղումի ստեղծում:

Եկեք նայենք այս մեթոդներից յուրաքանչյուրին:

Դինամիկ WS հղումներ

Ինչպես կարող եք կռահել, այս ընթացակարգի արդյունքը կլինի «Բարև, Վասյա» հաղորդագրության պատուհանի տեքստը:

Ստատիկ WS հղումներ

Ծրագրային կերպով օբյեկտ ստեղծելու փոխարեն WS սահմանումներմենք կարող ենք ուղղակիորեն ստեղծել WS-link մետատվյալների օբյեկտ կոնֆիգուրացիայի ծառում: Ստեղծման գործընթացում կցուցադրվի պատուհան՝ խնդրելով նշել WSDL սահմանման հասցեն՝ այն ներմուծելու համար.

Այնուհետև մենք կարող ենք ուղղակիորեն անդրադառնալ այս WS հղումին կոդով: Իսկ վեբ ծառայություն մուտք գործելու կարգը կունենա հետևյալ ձևը.