Importación automatizada de la lista de destinatarios

Basado en archivos

Pasos de implementación

TareaParte responsable

Proporcionar decisión sobre el método de entrega:

  1. SFTP alojado por FacilityOS
    1. Con lista de acceso IP
    2. Sin lista de acceso IP
  2. SFTP alojado por el cliente 
Cliente  
Proporcionar detalles de acceso y credenciales SFTP, según correspondaFacilityOS o Cliente (según la decisión del cliente arriba)
Especificar tipo de notificaciones por correo electrónico y direcciones de correo de los destinatariosCliente
Subir al SFTP un archivo de importación que cumpla con los requisitos de formatoCliente
Configurar trabajo automatizado para importar datosFacilityOS
Revisar datos y confirmar precisiónCliente
Configurar trabajo automatizado para enviar archivo de datosCliente
Habilitar los trabajos respectivos para la importación programadaFacilityOS y Cliente

 

Métodos de entrega

El primer paso es que el cliente seleccione un método de entrega.  Por favor, seleccione entre los siguientes:

  1. Archivo al SFTP de FacilityOS – FacilityOS establece una carpeta SFTP dedicada con credenciales únicas y el cliente sube el archivo (MÁS COMÚN)
    1. Con lista de acceso IP (RECOMENDADO)
      1. Para escenarios donde la máquina que sube el archivo tendrá una dirección IP estática o rango de IP
      2. El cliente debe proporcionar la dirección IP o rango de IP
    2. Sin lista de acceso IP
  2. Archivo al SFTP del cliente – El cliente establece una carpeta SFTP dedicada con credenciales únicas y un trabajo construido por FacilityOS recupera los archivos

Requisitos de contenido y formato

CategoríaRequisitos
ContenidoLista completa de todos los destinatarios activos (personas o ubicaciones)
Fila de encabezadoRequerido
Columnas
  • Ver la tabla que sigue para columnas soportadas
  • Los nombres de columnas en la fila de encabezado deben coincidir con la tabla que sigue
    • No es sensible a mayúsculas
  • El orden de las columnas no importa
  • El cliente puede agregar o eliminar cualquier columna no marcada como requerida en cualquier momento sin necesidad de consultar a FacilityOS
Carpeta SFTP/RecipientImport
Nombre del archivo(Cualquier valor)
Formato de archivo

Debe ser uno de los siguientes:

  • .csv
  • .txt
Separadores de campo

Debe ser uno de los siguientes:

  • Coma
    • Si se usan separadores de coma, asegúrese de eliminar las comas de los valores de campo durante la creación del archivo o use calificadores de texto con comillas dobles
  • Barra vertical
  • Tabulación
Calificadores de texto

Debe ser uno de los siguientes:

  • Comillas dobles
  • (ninguno)
Fin de línea

Debe ser uno de los siguientes:

  • CR
  • LF
  • CRLF

 

Columnas en el archivo

Nombre de columnaTipo de datoDescripción
EmpIDNvarchar(50)

REQUERIDO

Un identificador único alfanumérico para el registro.  Ejemplos incluyen ID de empleado, ID de registrador de tiempo, nombre de usuario AD y dirección de correo electrónico.

Este valor no debe cambiar 

FirstNameNvarchar(50)

Recomendado para registros de personas

Nombre legal

LastNameNvarchar(50)

REQUERIDO para registros de personas y ubicaciones

Para ubicaciones, use esto para el nombre de la ubicación

PreferredNameNvarchar(50)Para usar cuando el nombre preferido es diferente del nombre legal
CardIDNvarchar(50)ID de tarjeta
EmailNvarchar(641)REQUERIDO para enviar notificación por correo electrónico desde LogisticsOS
PhoneNumberNvarchar(50)REQUERIDO para enviar notificación por texto/SMS desde LogisticsOS
DepartmentNvarchar(50) 
DeliveryLocationNvarchar(50)

REQUERIDO*

*Usar uno de los siguientes: 

  • DeliveryLocation, o
  • Al menos uno de Edificio, Sala y Piso
BuildingNvarchar(50)

REQUERIDO*

*Usar uno de los siguientes: 

  • DeliveryLocation, o
  • Al menos uno de Edificio, Sala y Piso
FloorNvarchar(50)

REQUERIDO*

*Usar uno de los siguientes: 

  • DeliveryLocation, o
  • Al menos uno de Edificio, Sala y Piso
RoomNvarchar(50)

REQUERIDO*

*Usar uno de los siguientes: 

  • DeliveryLocation, o
  • Al menos uno de Edificio, Sala y Piso
MailStopNvarchar(50)Se requiere complemento para usar este campo

 

Tiempo y frecuencia

  • Actualizaciones una vez por noche, fuera del horario laboral típico (PREDETERMINADO)
  • Alternativamente, se pueden configurar otras frecuencias según solicitud del cliente

Lógica de importación

La lógica estándar de importación es la siguiente:

  • Agregar nuevos registros
  • Actualizar registros existentes que hayan cambiado
  • Deshabilitar registros que ya no están presentes en el último archivo/datos fuente
    • Solo aplica a registros que estaban en un archivo anterior
    • Como medida de seguridad, este paso solo se aplicará cuando el conteo de filas de datos en el archivo sea >50% de la lista de destinatarios

Notificaciones por correo electrónico

El trabajo de importación puede configurarse para enviar avisos estándar por correo electrónico para los siguientes eventos:

  • Éxito
  • Fallo

Archivo y retención

  • Después de una importación exitosa, el archivo fuente será archivado en un directorio dedicado
  • Los archivos archivados serán eliminados después de 14 días
¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 0