← Índice de manuales
Manual funcional · Sistema Plenario v14

Importación de Clientes desde otra Base

El formulario Importación de Clientes (frmclientes_Importacion_Base) permite traer clientes desde otra base de datos Plenario configurada como sistema de origen hacia la base de datos en la que el usuario está…

Módulo: Inicio / ClientesVersión: 1.1Actualizado: 2026-07-21

Importación de Clientes desde otra Base

Detalle

Campo Descripción
Manual de Usuario Importación de Clientes desde otra Base - Plenario v14
Módulo Inicio / Clientes
Objetivo Copiar clientes existentes en otra base de datos Plenario (sistema de origen) hacia la base de datos actual.
Qué resuelve Migración/replicación puntual de clientes entre bases del mismo entorno, con alta automática del oficial si no existe en destino.
Permisos El acceso depende de permisos asignados por el administrador del sistema.

Introducción

El formulario Importación de Clientes (frmclientes_Importacion_Base) permite traer clientes desde otra base de datos Plenario configurada como sistema de origen hacia la base de datos en la que el usuario está trabajando. Se elige el sistema de origen, se buscan los clientes en esa base, se seleccionan y se importan a la base destino.

Relación con el Importador desde Excel: NO es el mismo circuito que FormClientes_Importador. Aunque ambos comparten el título genérico "Importación de Clientes" y el permiso Clientes.Busquedas.Operaciones_Importar, son formularios distintos: FormClientes_Importador (C#) importa desde un archivo Excel, mientras que frmclientes_Importacion_Base (VB) copia clientes desde otra base de datos Plenario. Ver la sección HALLAZGOS para más detalle.

Acceso al módulo

  1. Iniciá sesión — Ingresá al sistema Plenario con tu usuario habitual.
  2. Abrí el formulario de Clientes — Desde la solapa Inicio.
  3. Ejecutá la importación desde otra base — Desde el menú/operación "Importar" del formulario de Clientes, que invoca la rutina ImportarClientes_Base() y abre esta ventana.

La ventana se abre como diálogo modal (ShowDialog). Al cerrarse, si se importó un cliente, el formulario de Clientes puede refrescar su búsqueda.

Pantalla principal

La ventana Importación de Clientes (modal, no maximizable) tiene tres zonas:

  • Panel de búsqueda (superior): selección del sistema de origen y filtros.
  • Grilla de clientes (centro): lista los clientes encontrados en la base de origen.
  • Panel de botones (inferior): botón Importar.

Filtros de búsqueda

Filtro / Control Caption Descripción
Sistema de Origen "Sistema de Origen:" Combo con las bases de datos disponibles (leídas de VisualPlenarioNET_Setup.xml), excluyendo la base actual. Define desde dónde se importan los clientes.
Id Cliente "Id Cliente:" Filtra por Id de cliente en la base de origen.
Asociado "Asociado:" Filtra por número de asociado.
Nombre "Nombre:" Filtra por razón social / nombre.
CUIT "CUIT:" Filtra por CUIT (máscara 00-00000000-0).
Nro Doc "Nro Doc:" Filtra por número de documento.
Buscar "Buscar" Ejecuta la búsqueda en la base de origen.
Limpiar parámetros (ícono) Limpia todos los campos de filtro.

La grilla de resultados muestra: Id, Asoc, Razón Social, CUIT/CUIL, Teléfono, Localidad y EMail.

Resultado del proceso

Al seleccionar uno o varios clientes y presionar Importar (o hacer doble clic / Enter sobre la grilla), por cada cliente:

  1. Se carga el cliente desde la base de origen.
  2. Se busca en la base de destino por CUIT.
  3. Si ya existe en destino, no se da de alta: se informa que el cliente fue encontrado con su Id en el sistema destino.
  4. Si no existe, se da de alta el cliente en destino. Si el oficial del cliente no existe en la base destino (búsqueda por CUIT del oficial), se da de alta también el oficial automáticamente.

Al finalizar se muestra un cuadro de mensaje (frmMessageBox) con el detalle de cada operación (clientes encontrados, dados de alta o errores).

Acciones disponibles

Acción Descripción
Seleccionar sistema de origen Elige la base de datos desde la cual importar.
Buscar Ejecuta la búsqueda de clientes con los filtros ingresados.
Limpiar parámetros Borra los filtros de búsqueda.
Importar Importa a la base destino los clientes seleccionados en la grilla.
Doble clic / Enter sobre la grilla Equivalen a Importar el/los cliente/s seleccionado/s.

Ejemplo práctico

  1. Abrí la ventana de importación desde otra base.
  2. En Sistema de Origen, elegí la base de datos desde la que querés traer clientes.
  3. Ingresá un filtro (por ejemplo, parte del Nombre o el CUIT) y presioná Buscar.
  4. Seleccioná en la grilla uno o más clientes (multiselección permitida).
  5. Presioná Importar.
  6. Leé el cuadro de mensaje final: indicará qué clientes ya existían y cuáles se dieron de alta en la base actual.

Consejos útiles

  • El sistema de origen es la base de datos seleccionada en el combo; nunca aparece la base actual entre las opciones (se excluye automáticamente).
  • La detección de duplicados en destino se hace por CUIT: si el CUIT ya existe, el cliente no se duplica.
  • Si el oficial del cliente no está en la base destino, se crea automáticamente; verificá luego los datos del oficial importado.
  • Podés seleccionar varios clientes a la vez para importarlos en un solo paso.

Preguntas frecuentes

¿De dónde salen los sistemas de origen disponibles? Se leen del archivo de configuración VisualPlenarioNET_Setup.xml, mostrando todas las bases configuradas excepto la base de datos actual.
¿Qué pasa si el cliente ya existe en la base destino? No se duplica. El sistema lo detecta por CUIT e informa que el cliente fue encontrado con su Id en el sistema destino.
¿Y si el oficial del cliente no existe en destino? Se da de alta automáticamente el oficial en la base destino antes de guardar el cliente.
¿Es lo mismo que importar desde Excel? No. Importar desde Excel usa el asistente FormClientes_Importador. Este formulario copia clientes desde otra base de datos Plenario.
¿Puedo importar varios clientes a la vez? Sí, la grilla admite multiselección; al presionar Importar se procesan todos los seleccionados.

Permisos

El acceso a la importación desde otra base se gobierna con el permiso Clientes.Busquedas.Operaciones_Importar (descripción "Permite Importar Clientes de otra Base de datos", grupo Clientes.Busquedas), verificado en ImportarToolStripMenuItem_Click / ImportarToolStripMenuItem1_Click del formulario de Clientes antes de invocar ImportarClientes_Base().

Información técnica

Basada en el análisis del formulario real de la v14.

Formularios y pantallas

Form Rol
frmclientes_Importacion_Base Ventana modal de importación de clientes desde otra base Plenario. Combo cboSistema2 (orígenes), grilla GridClientes/GridView1, botón btnImport. VisualPlenarioNET (VB).
frmClientes Formulario de Clientes; invoca esta ventana vía ImportarClientes_Base() (con ShowDialog). VisualPlenarioNET (VB).
frmMessageBox Muestra el detalle del resultado de la importación (clientes encontrados / dados de alta / errores).

Managers y clases de negocio

Componente Detalle
clsClientes (ClassVisualPlenarioNET / VPNET_Common_BL) Clase de negocio VB legacy. Busca en origen y destino por CUIT (Search), carga (Load) y da de alta el cliente en destino (Save, con id = 0).
clsOficiales (ClassVisualPlenarioNET) Busca el oficial en destino por CUIT (Search) y, si no existe, lo da de alta automáticamente (Save) antes de guardar el cliente.
clsConnection Arma la conexión a la base de origen a partir de DataSource, InitialCatalog, UserId y Password (HandleConnection).
VisualPlenarioNET_Setup.xml Archivo de configuración del que se leen las bases disponibles; se excluye la base actual (VPNetApp.Conexion.Database).

Stored Procedures y funciones

SP Uso
(sin SP directo) El formulario no invoca stored procedures directamente. Toda la persistencia (búsqueda/alta de clientes y oficiales, en origen y destino) pasa por las clases de negocio legacy clsClientes / clsOficiales, que encapsulan su propio SQL. Los SP internos deben verificarse contra el binario instalado.

Tablas de base de datos

Tabla Uso
Clientes Tabla de clientes en la base de origen y de destino (clsClientes.Search / Load / Save).
Oficiales Búsqueda y alta automática del oficial del cliente en la base de destino (clsOficiales.Search / Save).

Permisos reales

Permiso Acción
Clientes.Busquedas.Operaciones_Importar Descripción en código: "Permite Importar Clientes de otra Base de datos", grupo Clientes.Busquedas. Se valida en frmClientes (ImportarToolStripMenuItem_Click / ImportarToolStripMenuItem1_Click / btnImportar_ItemClick) antes de llamar a ImportarClientes_Base().

Atención (posible bypass): existe un botón dinámico "Desde base" (btnImportarDesdeBase) cuyo ItemClick llama a ImportarClientes_Base() sin chequear el permiso, y el propio método ImportarClientes_Base() tampoco lo valida. Según por dónde se acceda, la ventana puede abrirse sin el permiso Clientes.Busquedas.Operaciones_Importar. Verificar contra el binario instalado.

Relación con otros módulos / manuales

Se conecta con Cómo
Importador de Clientes (Excel) Circuito de importación alternativo: comparte título genérico y permiso, pero aquél lee un archivo Excel (form C#) y éste copia clientes base→base (form VB).
Clientes (ABM) Los clientes se dan de alta en la misma tabla Clientes que administra el ABM de la base de destino.
Módulo Clientes La ventana se lanza desde el formulario de Clientes (ImportarClientes_Base).

Notas para soporte

  • Las bases de origen disponibles dependen del archivo VisualPlenarioNET_Setup.xml; la conexión a la base de origen se arma con clsConnection a partir de DataSource, InitialCatalog, UserId y Password.
  • La importación es base→base dentro del mismo entorno Plenario, no una importación de archivo plano.
  • Formulario legacy (VB). Verificar contra el binario instalado: los textos y el comportamiento pueden variar según la versión desplegada.
¿Te resultó útil este manual?