Prerrequisitos

Para poder sacar provecho de este tutorial, es necesario tener:

• Conocimientos básicos del formato JSON.
• Conocimiento de las distintas opciones disponibles en los archivos de configuración.
• Conocimientos básicos de conceptos de bases de datos y términos relacionados: datos, actualizaciones, etc.

Caso de Uso 1

Este caso describe el archivo de configuración para el universo “myuniverse_crm”.

Josh Beets es el responsable de CRM en su empresa, lo que le hace responsable de la creación y el mantenimiento del archivo de configuración para las importaciones.

Contexto: contactos

Josh define dos subsecuencias para este contexto, PRCL y MGTSB:

1. La subsecuencia PRCL permite crear y actualizar los contactos existentes (“create contacts”: “1”, “update contacts”: “1”). Además, la lista 0 se restablece para esta importación («init lists»: [0]), la denominamos sincronización “full-mode”. De esta manera, si todos los contactos importados están suscritos a esta lista, siempre será posible seleccionar la importación más reciente.
2. El objetivo de la subsecuencia MGTSB es insertar los contactos en la lista 1. La lista se borra antes de cada importación (“init lists”: [1]) y se impide la creación de nuevos contactos (“create contacts”: “0”).

Dado que se supone que todos los contactos procedan de Francia, Josh quiere aplicar el prefijo internacional francés a todos los números de teléfono que no lo contengan (“default cellphone prefix”: “+33”).

Contexto: productos

En este caso, las subsecuencias también se utilizan con distintos fines.

1. La subsecuencia ERP se utiliza para actualizar los productos existentes en la base de datos y se utilizará siempre que sea necesario modificar la descripción o el precio de un producto. No se pueden añadir nuevos productos con esta importación (“crear productos”: “0”, “actualizar productos”: “1”).
2. En cambio, tanto MGTEN como MGTFR están diseñados para añadir nuevos productos. Cuando una opción no está disponible, Splio adopta su valor por defecto (“crear productos”: “1”, “actualizar productos”: “1”).

Más detalles

Los contextos restantes, orders y ordersitems, no contienen restricciones.

Antes de reenviar el archivo, Josh debe asegurarse de que ha proporcionado las direcciones de correo electrónico para recibir los informes de importación («destinatarios de informes»: [«[email protected]»]) y las alertas («destinatarios de alertas»: [«[email protected]»]).

Además, ha puesto a cero la opción de sobrescritura («sobrescribir con valores vacíos»: «0»). Esto es importante cuando se importan contactos u otros datos que ya están en la base de datos. Con esta opción a 0, Josh está seguro de que el valor en la base se mantendrá si el campo en el archivo está vacío.

Una vez revisado todo, Josh envía el archivo a Splio.

El archivo JSON

A continuación puedes ver el archivo JSON enviado a Splio.

 "myuniverse_crm":{
     "contacts":{
       "PRCL":{
         "report recipients": ["[email protected]"],
         "alert recipients": ["[email protected]"], 
         "overwrite with empty values": "0", 
         "default cellphone prefix": "33",
         "create contacts": "1", 
         "update contacts": "1",
         "init lists": [0]
       },
       "MGTSB":{
         "report recipients": ["[email protected]"],
         "alert recipients": ["[email protected]"], 
         "overwrite with empty values": "0", 
         "default cellphone prefix": "33",
         "create contacts": "0", 
         "update contacts": "1",
         "init lists": [1]
       }
     },
     "orders":{
       "ERP":{
         "report recipients": ["[email protected]"],
         "alert recipients": ["[email protected]"], 
         "overwrite with empty values": "0"
       }
     },
     "ordersitems":{
       "ERP":{
         "report recipients": ["[email protected]"],
         "alert recipients": ["[email protected]"], 
         "overwrite with empty values": "0"
       }
     },
     "products":{
       "ERP":{
         "report recipients": ["[email protected]"],
         "alert recipients": ["[email protected]"], 
         "overwrite with empty values": "0",
         "create products": "0", 
         "update products": "1"
       },
       "MGTEN":{
         "report recipients": ["[email protected]"],
         "alert recipients": ["[email protected]"], 
         "overwrite with empty values": "0"
       },
       "MGTFR":{
         "report recipients": ["[email protected]"],
         "alert recipients": ["[email protected]"], 
         "overwrite with empty values": "0"
       }
     }
   }
 }

Caso de Uso 2

El caso 2 presenta un archivo de configuración con criterios ligeramente diferentes a los del caso 1. Da prioridad al archivo importado (“sobrescribir con valores vacíos”: “1”), lo que significa que si se actualiza un dato, se sobrescribirán todos los datos, aunque el campo del archivo importado esté vacío.

Bill Hook, segundo director de marketing, se encarga de preparar el archivo de configuración. Utilizará las mismas direcciones de correo electrónico para los informes y alertas en todos los contextos y subsecuencias.

Contexto: contactos

En este contexto, Bill definirá dos subsecuencias:

1. La subsecuencia “full” está pensada para reimportar toda la recopilación de contactos desde una fuente externa. Por este motivo, permite crear cuentas (“create contacts”: “1”) y actualizarlas (“update contacts”: “1”). La regla para reemplazar valores por NULLs (“sobrescribir con valores vacíos”: “1”) será útil aquí: si alguna información ha sido eliminada en la fuente, también será eliminada de la base de contactos en Splio. Bill también se asegura de restablecer la lista 0 (“init lists”: [0]), que entonces se rellenará con los datos importados.
2. La subsecuencia “incremental” es definida de la misma manera que la “full” con una diferencia importante: la lista 0 no se vacía, lo que significa que esta importación podrá agregar y eliminar miembros de la lista utilizando los valores del campo “inscripción” o dejándola sin cambios.

Ambos procedimientos suponen que los números de teléfono importados son franceses (“prefijo predefinido para móviles”: “33”), indicando a Splio que utilice el prefijo francés para todos los números que no lo tengan.

Contexto: pedidos, ordersitems y productos

Los contextos que quedan no utilizan ninguna restricción específica. Bill mantiene las opciones para permitir la creación y actualización de los datos de productos tal como estaban en la versión anterior del archivo (“create products”: “1”, “update products”: “1”). Aunque estos son los valores predefinidos y podrían ser eliminados, los deja para acordarse de que este procedimiento durante la importación es importante.

El archivo JSON

El archivo JSON se muestra a continuación.

{
   "mybrand2":{
     "contacts":{
       "full":{
         "report recipients": ["[email protected] , [email protected]"],
         "alert recipients": ["[email protected] , [email protected]"], 
         "overwrite with empty values": "1", 
         "default cellphone prefix": "33",
         "create contacts": "1", 
         "update contacts": "1",
         "init lists": [0]
       },
       "incremental":{
         "report recipients": ["[email protected] , [email protected]"],
         "alert recipients": ["[email protected] , [email protected]"], 
         "overwrite with empty values": "1", 
         "default cellphone prefix": "33",
         "create contacts": "1", 
         "update contacts": "1"
       }
     },
     "orders":{
       "default":{
         "report recipients": ["[email protected] , [email protected]"],
         "alert recipients": ["[email protected] , [email protected]"], 
         "overwrite with empty values": "1"
       }
     },
     "ordersitems":{
       "default":{
         "report recipients": ["[email protected] , [email protected]"],
         "alert recipients": ["[email protected] , [email protected]"], 
         "overwrite with empty values": "1"
       }
     },
     "products":{
       "default":{
         "report recipients": ["[email protected] , [email protected]"],
         "alert recipients": ["[email protected] , [email protected]"], 
         "overwrite with empty values": "1",
         "create products": "1", 
         "update products": "1"
       }
     }
   } 
 }