Aplicación en TSD y comunicación con 1C: Enterprise 8.3 a través del servicio HTTP. Parte 2 (implementación de API en el lado 1C)

1. La elección del método de intercambio. Descripción de la API.

2. Implementación de la API en el lado de 1C.

3. Aplicación en TSD y comunicación con 1C: Enterprise 8.3 a través del servicio HTTP. Parte 3 (BroadcastReceiver. Obtención de datos)

Hay muchos manuales sobre cómo crear un servicio HTTP en Internet. Por lo tanto, describiré de inmediato la implementación. Nuestro servicio consta de tres patrones de URL:

• Directorios - / v1 / catalogs / {Directory} / {Action}
• Documentos - / v1 / documents / {Document} / {Action}
• Servicios - / v1 / services / {Action}

Para no inflar el artículo, considere el ejemplo con el libro de referencia "Nomenclatura". 1C no nos permite tener rutas diferentes para los métodos HTTP. Por lo tanto, el patrón URL será (/ v1 / catalogs / wares / {Action}, para el cual se definen dos métodos HTTP GET, POST. En otros patrones también usaremos GET, POST.

• / v1 : nos permitirá admitir varias opciones de API en el futuro. Podremos agregar la plantilla de URL v_V2_Directories y, en consecuencia, la ruta para comenzar con / v2
• / catalogs / wares / - catalogs integra todos los directorios. Esta es la parte estática del camino. wares cumple con el Directorio de nomenclatura. 1C pondrá "mercancías" en los parámetros de URL. Cabe señalar que nosotros mismos encontramos formas. Y luego también pensamos cómo procesarlos en 1C nosotros mismos
• {Acción} : aquí pasaremos lo que queremos obtener de 1C. Por ejemplo getByParam o getAll

Desde el punto de vista de Retrofit, baseUrl se verá así "http://192.168.0.1/unf/hs/inntsd/v1/" donde:

• 192.168.0.1 : servidor donde se publica el servicio HTTP
• / unf : nombre de la base de datos 1C
• / hs : parte estática para servicios HTTP
• / inntsd es la URL raíz de todo el servicio. Llama como queramos

Considere el procedimiento para recibir una solicitud.

  Get() //  .       Get   //Post  = (, "GET"); //middleware.      .  = ();     = ();  (, )   = (); //   {}  = (); //   {}  = (); //     URL.      .URL  =(); //      .     Firefox ,  Google Chrome   =  ; .("", ); .("", ); .("", ); .("", ); .("", );  ;   ()  = ..("Content-Type");  =  ; .("", ); //     "Content-Type","content-type", "Content-type"   =    = ..("content-type"); ;   =    = ..("ontent-type"); ;   =   .("", );  ; ;  ((), "multipart/form-data") > 0   = ();  ((), "application/json") > 0   = JSON();  .("", ); ;  ;  //      JSON    .     .  JSON(); JSON =  JSON;  = .(); JSON.();   = JSON(JSON,,"sampleDate",JSON.ISO); .("", );   =  ; .("", ); ; JSON.();  ;  

Hay muchos malos consejos en este ejemplo. Por ejemplo, Nombre del directorio, Acción debe convertirse en una enumeración o en un nuevo directorio con coincidencias. Pero qué tan elegante es implementarlo en el suplemento, aún no lo he decidido.

Analicemos la solicitud getByParam . Dirección completa: / v1 / catalogs / wares / getByParam? Prop = byCode & compare = similarly searchString = 239

Averigüe con qué directorio estamos trabajando.

  ()  . = ""   = ();  . = ""   = ()   = (100, "    " + .); ;  ;  

Obtenga el método de solicitud. Y verificamos que todos los parámetros estén asociados al método. Aquí debe tenerse en cuenta una comprobación profunda que no. Como estoy escribiendo para 1C y Android.

  ()  . = ""   = ..("prop");  = ..("comparison");  = ..("searchString");  ( = )  ( = )  ( = )   = (103, "     /      ");  ; ;  = (, , );  = (0, ""); .("payload", );  . = ""   = ();  = (0, ""); .("payload", );   = ("102", "     " + .); ;  ;  

Si todo esta bien. Preparamos los datos para la respuesta.

  (, , )  =  ;  = "  | .  , | .  , | .  , | .  , | ..   | | .   | |  . |  {}";  = "";  () = ("byCode")   = ".";  () = ("byArticle")   = ".";  () = ("byName")   = "."; ;  () = ("equally")   =  + " = &";  () = ("similarly")   =  + "  &"; ;  = (, "{}", ); . = ;  () = ("similarly")   = "%" +  + "%"; ; .("", );  = .().();  = .();  =  ;       .( ("code,article, name, fullName, unit", ., ., ., ., .)); ;  =  ; .("quantity", ); .("wares", );  ;  

Y finalmente, unimos todo juntos. Ponemos esto en JSON y enviamos la respuesta.

  = (0, ""); .("payload", );  ;  (, )   = (); HTTP =  HTTP(); HTTP.["Content-Type"] = "application/json; charset=utf-8"; //   json UTF-8 // ToDo CORS //HTTP.["Access-Control-Allow-Origin"] = ; //HTTP.["Access-Control-Allow-Credentials"] = "true"; HTTP.();  HTTP;   () JSON =  JSON(, .,,,,,,,);  =  JSON; . = ; .(JSON);  =  JSON; . = JSON.; . = JSON.ISO; JSON(, , );  = .();  ;  

Y se lo damos todo al cliente.

  = (200, )  ; 

Independientemente de lo que obtuvimos de 1C. Siempre tratamos de responder correctamente.

  (, )  =  ;  =  (); .("code", ); .("description", ); .("result", ); .("payload",  );  ;  

Eso es todo. Todos los demás métodos se implementan de manera similar. Haga preguntas. Estaré encantado de responder.