Modalità di integrazione con 1C

Quali sono i requisiti fondamentali per le applicazioni aziendali? Alcuni dei principali obiettivi sono i seguenti:

• Facilità di modifica/adattamento della logica operativa dell'applicazione alle mutevoli sfide aziendali.
• Facilità di integrazione con altre applicazioni.

Come viene affrontata la prima sfida in 1C è stato descritto brevemente nella sezione 'Customizzazione e Supporto'; torneremo su questo interessante argomento in uno dei prossimi articoli. Oggi parleremo invece della seconda sfida, ossia l'integrazione. di questo articolo; мы еще вернемся к этой интересной теме в одной из будущих статей. Сегодня же речь пойдет о второй задаче, об интеграции.

Sfide di integrazione

I compiti di integrazione possono variare. Per alcune soluzioni è sufficiente uno scambio dati interattivo semplice, ad esempio per inviare in banca l'elenco dei dipendenti per l'emissione di carte plastificate per stipendi. Per compiti più complessi potrebbe essere necessario uno scambio dati completamente automatizzato, possibilmente con accesso alla logica aziendale di un sistema esterno. Ci sono compiti di natura specializzata, come l'integrazione con attrezzature esterne (ad esempio, attrezzature commerciali, scanner mobili, ecc.) o con sistemi ereditati o specializzati (ad esempio, con sistemi di riconoscimento delle etichette RFID). È estremamente importante scegliere il meccanismo di integrazione più adatto per ogni compito.

Possibilità di integrazione con 1C

Esistono diversi approcci per implementare integrazioni con le applicazioni 1C; quale scegliere dipende dalle esigenze del compito.

1. Implementazione basata su meccanismi di integrazione, forniti dalla piattaforma, della propria API specializzata dal lato dell'applicazione 1C (ad esempio, un insieme di servizi Web o HTTP che invocheranno applicazioni di terze parti per scambiare dati con l'applicazione 1C). Il vantaggio di questo approccio è la resistenza dell'API ai cambiamenti dell'implementazione dal lato dell'applicazione 1C. La peculiarità di questo approccio è che è necessario modificare il codice sorgente della soluzione standard 1C, il che può richiedere potenzialmente sforzi per fondere i codici sorgente durante il passaggio a una nuova versione della configurazione. In questo caso, potrebbe tornare utile una nuova funzionalità progressiva — estensioni della configurazione. Le estensioni sono, in sostanza, un meccanismo di plugin che consente di creare aggiunte alle soluzioni applicative senza modificare le stesse soluzioni applicative. Spostare l'API di integrazione nell'estensione della configurazione eviterà complessità durante la fusione delle configurazioni al passaggio a una nuova versione della soluzione standard.
2. Utilizzo dei meccanismi di integrazione della piattaforma, che forniscono accesso esterno al modello a oggetti dell'applicazione e non richiedono modifiche all'applicazione o la creazione di estensioni. Il vantaggio di questo approccio è che non è necessario modificare l'applicazione 1C. Lo svantaggio è che se l'applicazione 1C è stata modificata, potrebbero essere necessarie ulteriori modifiche all'applicazione integrata. Un esempio di tale approccio è l'uso del protocollo OData per l'integrazione, implementato nella piattaforma 1C:Enterprise (maggiore dettaglio qui sotto).
3. Utilizzo di protocolli applicativi pronti all'uso, implementati nelle soluzioni standard di 1C. Molte soluzioni standard di 1C e dei partner implementano, basandosi sui meccanismi di integrazione forniti dalla piattaforma, i propri protocolli applicativi mirati a compiti specifici. Utilizzando questi meccanismi, non è necessario scrivere codice all'interno dell'applicazione 1C poiché ci avvaliamo delle funzionalità standard della soluzione applicativa. Dallato dell'applicazione 1C, è necessario solo effettuare alcune configurazioni.

Meccanismi di integrazione nella piattaforma 1C:Enterprise

Import/esportazione di file

Immaginiamo di dover effettuare uno scambio bidirezionale di dati tra l'applicazione 1C e un'applicazione a scelta. Ad esempio, dobbiamo sincronizzare l'elenco dei prodotti (il catalogo Nomenclatura) tra l'applicazione 1C e un'applicazione a scelta.

Per risolvere questo problema, si può scrivere un'estensione che esporta il catalogo Nomenclatura in un file di un formato specifico (testuale, XML, JSON, ...) e che è in grado di leggere questo formato.

La piattaforma implementa un meccanismo di serializzazione degli oggetti applicativi in XML sia direttamente, tramite i metodi del contesto globale ScriviXML/LeggiXML, sia con l'ausilio di un oggetto secondario XDTO (XML Data Transfer Objects).

Qualsiasi oggetto nel sistema 1C:Enterprise può essere serializzato in un formato XML e viceversa.

Questa funzione restituirà la rappresentazione dell'oggetto in formato XML:

Funzione Oggetto_In_XML(Oggetto)
    ScritturaXML = Nuova ScritturaXML();
    ScritturaXML.ImpostaStringa();
    ScriviXML(ScritturaXML, Oggetto);
    Restituisci ScritturaXML.Chiudi();
FineFunzione

Ecco come apparirà l'esportazione del catalogo Nomenclatura in XML utilizzando XDTO:

&
Procedura EsportaXMLSuServere()	
	NuovoSerializzatoreXDTO  = SerializzatoreXDTO;
	NuovaRegistroXML = Nuovo RegistroXML();
	NuovaRegistroXML.ApriFile("C:DataNomenclatura.xml", "UTF-8");
	
	NuovaRegistroXML.ScriviAnnuncioXML();
	NuovaRegistroXML.ScriviInizioElemento("CatalogoNomenclatura");
	
	Selezione = Cataloghi.Nomenclatura.Seleziona();
	
	Mentre Selezione.Siguiente() Ciclo 
		OggettoNomenclatura = Selezione.OttieniOggetto();
		NuovoSerializzatoreXDTO.ScriviXML(NuovaRegistroXML, OggettoNomenclatura, DestinazioneTipoXML.Esplicito);
	FineCiclo;
	
	NuovaRegistroXML.ScriviFineElemento();
	NuovaRegistroXML.Chiudi();	
FineProcedura

Attraverso una semplice modifica del codice esportiamo il catalogo in JSON. I prodotti saranno scritti in un array; per varietà presenteremo una versione in inglese della sintassi:

&AtServer
Procedure ExportJSONOnServer()
	NewXDTOSerializer  = XDTOSerializer;
	NewJSONWriter = New JSONWriter();
	NewJSONWriter.OpenFile("C:DataNomenclatura.json", "UTF-8");
	
	NewJSONWriter.WriteStartObject();
	NewJSONWriter.WritePropertyName("CatalogNomenclatura");
	NewJSONWriter.WriteStartArray();
	
	Selection = Catalogs.Nomenclatura.Select();	
	
	While Selection.Next() Do 
		NomenclatureObject = Selection.GetObject();
		
		NewJSONWriter.WriteStartObject();
		
		NewJSONWriter.WritePropertyName("Nomenclatura");
		NewXDTOSerializer.WriteJSON(NewJSONWriter, NomenclatureObject, XMLTypeAssignment.Implicit);
		
		NewJSONWriter.WriteEndObject();
	EndDo;
	
	NewJSONWriter.WriteEndArray();
	NewJSONWriter.WriteEndObject();
	NewJSONWriter.Close();	
EndProcedure

Dopo, resterà solo da trasferire i dati all'utente finale. La piattaforma 1C:Enterprise supporta i principali protocolli Internet, come HTTP, FTP, POP3, SMTP, IMAP, comprese le loro versioni sicure. È inoltre possibile utilizzare HTTP e/o Web services per il trasferimento dei dati.

Servizi HTTP e web

Le applicazioni 1C possono implementare i propri servizi HTTP e web, e anche chiamare i servizi HTTP e web realizzati da applicazioni di terze parti.

Interfaccia REST e protocollo OData

A partire dalla versione 8.3.5, la piattaforma 1C:Enterprise può generare automaticamente l'interfaccia REST per l'intera soluzione applicativa. Qualsiasi oggetto di configurazione (riferimento, documento, registro informazioni, ecc.) può essere reso accessibile per recuperare e modificare dati attraverso l'interfaccia REST. La piattaforma utilizza il protocollo OData versione 3.0. La pubblicazione dei servizi OData viene eseguita dal menu del Configuratore 'Amministrazione -> Pubblicazione sul server web', deve essere selezionata l'opzione 'Pubblica interfaccia standard OData'. Sono supportati i formati atom/XML e JSON. Una volta che la soluzione applicativa è pubblicata sul server web, i sistemi esterni possono accedervi tramite l'interfaccia REST utilizzando richieste HTTP. Non è richiesta programmazione sul lato 1C per lavorare con l'applicazione 1C tramite il protocollo OData.

Pertanto, un URL del tipo http:////odata/standard.odata/Catalog_Номенклатура restituirà il contenuto del catalogo Nomenclatura in formato XML — una collezione di elementi entry (l'intestazione del messaggio è omessa per brevità):

http://server/Config/odata/standard.odata/Catalog_Номенклатура(guid'35d1f6e4-289b-11e6-8ba4-e03f49b16074')