Deschiderea programatică a prelucrării externe se realizează folosind obiectul context global ExternalProcessing, care are tipul ExternalProcessingManager. Pentru fiecare mod de operare al platformei 1C (modul de aplicare obișnuit și modul de aplicație gestionată), sunt utilizate diferite metode obiect pentru a lucra cu procesare externă.
Rularea procesării externe în modul normal de aplicare
Într-o aplicație tipică, trebuie să utilizați metoda Create() a obiectului ExternalProcessing, căruia i se transmite numele complet al fișierului de procesare externă. Metoda returnează un obiect de tip Procesare externă, acest obiect este procesarea externă care se deschide. Dacă trebuie să deschideți un formular de procesare extern, atunci apelați metoda GetForm() pe obiectul primit, care va returna formularul principal, apoi apelați metoda Open() pentru a-l deschide.Procesare = ExternalProcessing.Create(FullFileName);
Procesare.GetForm().Open();
În procesarea externă, forma principală trebuie să fie întotdeauna una obișnuită, iar forma controlată trebuie să fie întotdeauna una suplimentară, altfel metoda GetForm() nu va funcționa în modul de aplicare normal.
Rularea procesării externe în modul aplicație gestionată
În modul formulare gestionate, algoritmul este împărțit în funcție de contextul de execuție. Pe client, primim date binare folosind numele complet al fișierului de procesare extern. Transferăm datele binare primite pe server și le plasăm în stocare temporară. Apoi, trebuie să apelați metoda Connect() a obiectului ExternalProcessing, la care este transmisă adresa pentru stocarea temporară. Metoda returnează numele procesării externe conectate. Returnăm clientului numele procesării externe, creăm o cale de șir către formularul de procesare și folosim metoda OpenForm() pentru a deschide formularul de procesare externă.&OnServer
Funcția GetExternalProcessingName(BinaryData)
AddressInTemporaryStorage = PlaceInTemporaryStorage(BinaryData);
Return ExternalProcessing.Connect(AddressInTemporaryStorage);
EndFunction
&OnClient
FullFileName = ""; // Numele complet al fișierului de procesare externă.
FileData = new BinaryData(FullFileName);
ExternalProcessingName = GetExternalProcessingName(FileData);
OpenForm("ExternalProcessing." + ExternalProcessingName + ".Form");
Modul sigur pentru procesare externă
Metodele Create() și Connect() ale obiectului ExternalProcessing au un parametru de intrare SafeMode - un semn al conectării procesării externe în modul sigur. Dacă parametrul nu este specificat, conexiunea se va face în mod securizat.Modul sigur este conceput pentru a proteja sistemul de executarea codului de program „neîncrezător” pe server. Potențialul pericol provine din procesarea externă sau codul de program introdus de utilizator pentru a fi utilizat în metodele Run() și Calculate().
Modul sigur impune următoarele restricții:
- modul privilegiat este anulat dacă a fost instalat;
- încercările de a intra în modul privilegiat sunt ignorate;
- operațiunile cu obiecte COM sunt interzise;
- este interzisă încărcarea și conectarea componentelor externe;
- accesul la sistemul de fișiere este interzis (cu excepția fișierelor temporare);
- Accesul la internet este interzis.
Pentru a interzice deschiderea interactivă a prelucrării, în toate rolurile atribuite utilizatorului, este necesar să eliminați dreptul „Deschiderea interactivă a prelucrării externe” (vezi Figura 1).
| Figura 1. Drepturi de a deschide interactiv procesări/rapoarte externe |
Deschiderea programatică a rapoartelor externe este similară cu procesarea externă, dar ar trebui să utilizați obiectul context global ExternalReports, care are tipul ExternalReportsManager.
Folosind „Trade Management 11.3” ca exemplu, vom lua în considerare procesul simplu de conectare a unui formular de imprimare extern. Vom lua în considerare și caracteristicile noului sistem de securitate.
Salt rapid
Acțiuni preliminare
Mai întâi ar trebui activați funcționalitatea sau verificați disponibilitatea acestuia
1. Conectați-vă cu drepturi depline la baza de date cu informații.
2. Accesați meniul „Date principale și administrare”/Bloc „Administrare”/Comandă „Formulare tipărite, rapoarte și procesare”.
Plus
În secțiunea care se deschide:
Adăugăm procesare folosind butonul „Creare” (acest lucru este important) sau „Actualizare!” existent:
- Selectați-l în listă (dacă nu este selectat sau este gol, comanda nu va funcționa, dar nu va spune nimic).
- Faceți clic pe butonul „Încărcare din fișier”.
După apariția pentru 1C în procesarea externă, verificările de securitate au apărut în configurații noi.
Ar trebui să instalați numai procesări create independent sau primite prin canale de comunicare cunoscute (nu din e-mail, doar de pe un site web cu certificat valabil sau furnizate de angajații dezvoltatorului, confirmate de acesta prin telefon).
Dacă totul în procesare este prescris de dezvoltator, atunci va fi setat „Plasarea” - obiectele în care va fi implicată procesarea, vor apărea comenzile.
Pentru a lucra, faceți clic pe „Salvați și închideți”.
Examinare
Imediat după aceasta, în funcție de tipul de tratament:
- Formularul tipărit devine disponibil la deschiderea unui document sau din lista acestuia (pentru unul deja deschis când îl deschideți din nou) făcând clic pe butonul „Imprimare”.
- Procesarea este disponibilă în secțiunile „Procesare suplimentară” din fiecare subsistem
- Procesarea completării utilizând butonul „Umplere” al listei sau panoul de comandă principal al formularului obiect.
Pentru procesarea de mai sus, lansarea va arăta astfel:
Dacă documentul este nou, ar trebui să fie notat, mecanismul extern de procesare vă va avertiza despre acest lucru:
Comportamentul suplimentar depinde de funcționalitatea încorporată: este posibil să deschideți un formular sau pur și simplu să procesați date.
Avertismente de securitate în 1C
Noile versiuni și configurații ale platformei au o protecție sporită împotriva lansării de programe rău intenționate.
Procesarea poate determina lansarea Excel pentru a încărca, caz în care noul subsistem de securitate vă va avertiza și:
În acest caz, codul de gestionare este întrerupt.
Dacă faceți clic pe „Da”, sistemul vă va cere să executați din nou comanda:
Este posibil ca un utilizator al bazei de informații să dezactiveze protecția împotriva acțiunilor periculoase prin „Configurator”:
Acest lucru nu poate fi schimbat din modul „Enterprise”, poate că a fost făcut intenționat și poate apărea după actualizare.
De asemenea, trebuie remarcat faptul că, dacă procesarea folosește Excel, trebuie să ruleze în modul nesigur (așa era cazul înainte de introducerea noului sistem, acesta funcționează în paralel):
„Nu se poate încărca MS EXCEL!!!” „Modul sigur a fost setat. Operațiunea este interzisă”
În procesarea externă, arată astfel:
Dezvoltatorul ar trebui să îl seteze la „False” în descrierea procesării interne, apoi totul va fi bine:
Funcție InformationOnExternalProcessing() ExportRegistrationParameters = Structură nouă;
Parametri de înregistrare.Insert("SafeMode", False);
Faptul este că atunci când se utilizează versiunea client-server a 1C, procesarea/rapoartele externe sunt deschise în modul sigur, în care utilizarea modului privilegiat este interzisă. Iar modul privilegiat este folosit foarte des în configurații tipice: generarea de formulare tipărite, diverse verificări de servicii (înregistrarea schimburilor), etc. Ca urmare, chiar și folosind un raport regulat asupra sistemului de control al accesului fără formular (în mod implicit, se folosește formularul general „ReportForm”) și salvarea setărilor personalizate ale raportului (în directorul corespunzător), veți primi o eroare despre acces insuficient drepturi la diferite constante și parametri de sesiune utilizați în scopuri oficiale după linie SetPrivilegedMode(True) ;
Soluția „corectă” ar fi conectarea prelucrărilor și rapoartelor externe prin mecanismele BSP „Rapoarte și procesare suplimentare” cu dezactivarea modului sigur sau adăugarea de permisiuni (în opinia mea, din versiunea BSP 2.2.2.1). Dar dacă dintr-un motiv oarecare este necesar să utilizați fișiere externe de raportare/procesare, atunci puteți configura un profil de securitate cluster utilizat ca profil de securitate în mod sigur pentru o anumită bază de informații.
Aș dori să observ imediat că această opțiune nu este de preferat, dar din cauza diverselor circumstanțe poate fi utilizată într-o formă atât de simplificată. De exemplu, am mai multe baze de date în diferite orașe, una comună locală cu drepturi strict limitate, USB închis etc., undeva folosesc Accounting 2.0, iar undeva 3.0, fac aproape toate rapoartele folosind instrumente ACS fără formulare, astfel încât acestea deschis în ambele versiuni. Menținerea tuturor acestor rapoarte pentru versiuni diferite și baze de date diferite este laborioasă și inutilă, deoarece Există planuri de a trece la o singură configurație și bază...
Să creăm un profil.
În consola clusterului, creăm un profil de securitate în care setăm steagurile „Poate fi folosit ca profil de securitate Safe Mode”și „ în secțiunea „Acces complet permis:” „în modul privilegiat”.
În multe cazuri de utilizare a rapoartelor și procesare simplă, această metodă va fi aplicabilă. Pentru situații mai complexe, nu are rost să descriem procesul, deoarece este subliniat în documentație (capacitatea de a configura profiluri de securitate pentru anumite fișiere externe prin specificarea cantității de hash, etc.).
P.S. Credeam că profilurile de securitate funcționează doar atunci când se folosesc licențe de platformă și server la nivel de CORP, dar această funcționalitate funcționează și pe platforma 1C:Enterprise 8.3 (se poate numi condiționat PROF, prin analogie cu configurațiile standard Basic/PROF/CORP)
Când rulați programul de încărcare a documentelor ca utilizator obișnuit, eroarea „Modul sigur este setat. Operația este interzisă”.
Această dificultate apare deoarece Nu există suficiente drepturi pentru a începe procesarea externă. Pentru a configura drepturile de acces, conectați-vă la baza de date în modul 1C Enterprise în numele Administratorși mergi la secțiune Setări utilizator și drepturi / Profiluri de acces de grup, clic Creați un grup.
Introduceți numele grupului și bifați casetele pentru rolurile disponibile pentru utilizatorii acestui grup -
- Deschiderea interactivă a rapoartelor externe și procesare
- Utilizarea rapoartelor și procesării suplimentare
Clic Salvați și închideți
Reveniți la meniul Utilizatori și selectați din listă angajatul care va lucra cu programul de încărcare document. Faceți clic pe Permisiuni. În lista de profiluri, selectați profilul creat anterior. Clic Scrieți.
Pentru ca utilizatorii să înceapă procesarea, este recomandat să adăugați Încărcarea documentului la lista de procesare externă. Pentru a face acest lucru în meniu Administrare / Formulare tipărite și procesare / Rapoarte suplimentare și procesare creați o nouă prelucrare. Specificați calea către fișierul „Download Documents.epf” și atribuiți un nume. Specificați locația procesării în meniu, de unde utilizatorul o poate lansa mai târziu, de exemplu, selectați meniul Directoare
Făcând clic pe elementul Acces rapid, indicați ce utilizatori au acces la procesare:
După setare, faceți clic Salvați și închideți. Pentru a începe procesarea, utilizatorii vor trebui doar să reintroducă baza de date și să o deschidă din meniul de acces (în exemplu - Directoare) și să facă clic pe Executa.
Deschide Meniu - Toate funcțiile.... și găsiți opțiunea „Se folosesc profiluri de securitate” din listă.
Doar debifați opțiunea „Se folosesc profiluri de securitate”.
După aceasta, programul se va lansa cu succes.
Imprimare (Ctrl+P)
Obiecte de configurare
Dacă este necesar să folosiți cod de program „neîncrezător” pe server: procesare externă sau cod de program introdus de utilizator pentru a fi utilizat în metodele Run() și Calculate(), puteți utiliza modul de operare sigur.
În modul sigur:
- Mod privilegiat anulat.
- Trecerea la modul privilegiat ignorat.
- Interzis operațiuni care conduc la utilizarea mijloacelor externe în legătură cu platforma 1C:Enterprise (inclusiv analogi neblocatori ai metodelor specificate):
- Mecanisme COM:
- COMObject();
- GetCOMObject();
- WrapperHTMLDocument.GetCOMObject().
- Încărcarea componentelor externe:
- LoadExternalComponent();
- ConnectExternalComponent().
- Acces la sistemul de fișiere:
- ValueInFile();
- CopyFile();
- MergeFiles();
- MutareFișier();
- SplitFile();
- CreateDirectory();
- DeleteFiles();
- Fișier nou;
- xBase nou;
- EntryHTML.OpenFile();
- ReadHTML.OpenFile();
- ReadXML.OpenFile();
- WriteXML.OpenFile();
- ReadingFastInfoset.OpenFile();
- RecordFastInfoset.OpenFile();
- CanonicalXMLRecord.OpenFile();
- TransformXSL.LoadFromFile();
- WriteZipFile.Open();
- ReadingZipFile.Open();
- New ReadText(), dacă primul parametru este un șir;
- ReadText.Open(), dacă primul parametru este un șir;
- NewTextRecord(), dacă primul parametru este un șir;
- WriteText.Open(), dacă primul parametru este un șir;
- NewTextExtract();
- modificarea proprietății ExtractText.FileName;
- ExtractText.Write();
- New Picture(), dacă primul parametru este un șir;
- Imagine.Scrie();
- nou BinaryData();
- BinaryData.Write();
- NewDataRecord(), dacă primul parametru este un șir;
- New ReadData(), există un prim parametru - un șir;
- toate metodele obiectului FileStreamManager;
- New FileStream();
- FormattedDocument.Write();
- GeographicScheme.Read();
- GeographicScheme.Write();
- GeographicScheme.Print();
- TabularDocument.Read();
- TabularDocument.Write();
- TabularDocument.Print(); GraphicScheme.Read();
- GraphicScheme.Write();
- GraphicScheme.Print();
- TextDocument.Read();
- TextDocument.Write().
- Acces la internet:
- Noua conexiune la internet,
- InternetMail nou,
- Nou InternetProxy,
- Noua conexiune HTTP,
- Noua conexiune FTP.
ATENŢIE! Când se efectuează operațiuni interzise, se aruncă o excepție în timpul execuției.
Nota. Rapoartele externe și procesările deschise folosind meniul Fișier - Deschidere sunt executate în modul sigur dacă utilizatorul nu are drepturi de acces administrativ.
Numărul de activări în modul sigur trebuie să se potrivească cu numărul de dezactivări. Cu toate acestea, dacă modul sigur a fost activat în cadrul unei proceduri sau funcție (o dată sau mai multe), dar nu a fost oprit, sistemul se va opri automat de câte ori au fost porniri incomplete în procedura sau funcția rămasă.
Dacă într-o procedură sau funcție apelează o metodă SetSafeMode(False) a făcut mai mult decât apeluri de metodă SetSafeMode (Adevărat), atunci va fi aruncată o excepție.
Instalarea software-ului în modul sigur poate fi necesară în cazul în care dezvoltatorul de configurație intenționează să utilizeze cod de program terță parte (în legătură cu configurația), a cărui fiabilitate dezvoltatorul nu poate garanta. Un exemplu de astfel de cod este executarea metodelor Execute() și Compute() în cazurile în care codul executabil este obținut din lumea exterioară. În acest caz, o practică bună ar fi să setați modul sigur înainte de a executa aceste metode:
// Se generează cod de program care ar trebui executat // Este posibil ca codul să fie încărcat din surse externe // sau introdus manual ExecutableCode = GetExecutedCodeFromExternalWorld(); // Activează modul sigur SetSafeMode(True); // Executați cod potențial periculos Execute(ExecutableCode); // Opriți modul sigur SetSafeMode(False);
În unele cazuri, setările modului sigur pot intra în conflict cu setările modului privilegiat. Un exemplu de astfel de conflict este postarea unui document pentru care este setat modul Privilegiat la postare, din codul în limbajul încorporat care este executat în modul sigur. În acest caz, modul privilegiat este dezactivat și încercările de a-l activa sunt ignorate. Drept urmare, codul din limbajul încorporat, care „contează” pe modul privilegiat activat, „întâlnește” absența acestuia, ceea ce duce la erori cu motive neevidente ale apariției lor. Pentru a preveni această situație, sistemul 1C:Enterprise dezactivează automat modul sigur pentru gestionatorii de evenimente care sunt disponibili în modulul obiect sau modulul manager, cu condiția ca codul executabil în limbajul încorporat să nu fie localizat în extensia de configurare. Astfel de handlere sunt marcate într-un mod special în asistentul de sintaxă.
De asemenea, oferă posibilitatea de a dezactiva modul sigur din limbajul încorporat (dacă codul programului care încearcă să îl dezactiveze nu se află într-o extensie de configurare). Pentru a dezactiva modul sigur, există o metodă SetDisableSafeMode(). Puteți verifica dacă modul sigur este dezactivat în prezent (automat sau apelând o metodă) folosind metoda GetDisableSafeMode().
Într-o singură metodă în limbajul încorporat, nu poate exista mai mult de un nivel de imbricare de setare a modului sigur (prin apelarea metodei SetSafeMode()) și setarea dezactivării modului sigur (automat în timpul execuției evenimentului obiect metadate). handlere sau apelând metoda SetSafeModeDisable()). Când încercați să creșteți imbricarea, se face o excepție:
// Utilizarea corectă a ProcedureProcedureName() SetDisableSafeMode(True);