miércoles, 14 de agosto de 2019

Consulta en Microsoft Access que convierte los Números a Letras

Crear nuestras propias funciones en Access nos es de mucha utilidad, nos evita generar código extra en nuestros programas.

Aquí les comparto una función propia para traducir los números a su equivalente en letras.

Supongamos que tenemos una tabla como esta:


Tenemos un campo de tipo CURRENCY por tanto es numérico, y queremos llevar este campo a letras.

Para esto nos vamos a Herramientas de Base de Datos y le datos al icono de Visual Basic, y nos abrirá la ventana de Visual Basic para Aplicaciones



Sobre la ventana de la izquierda, de Proyecto, damos clic derecho para ver el menú y agregamos un nuevo módulo



En la ventana que se abre, verán una sola línea con el texto

Option Compare Database

Esa línea la dejan tal cual aparece y por debajo de ella insertan el siguiente código:

Function CantidadEnLetra(tyCantidad As Currency) As String
Dim lyCantidad As Currency, lyCentavos As Currency, lnDigito As Byte
Dim lnPrimerDigito As Byte, lnSegundoDigito As Byte, lnTercerDigito As Byte
Dim lcBloque As String, lnNumeroBloques As Byte, lnBloqueCero

tyCantidad = Round(tyCantidad, 2)
lyCantidad = Int(tyCantidad)
lyCentavos = (tyCantidad - lyCantidad) * 100

laUnidades = Array("UN", "DOS", "TRES", "CUATRO", "CINCO", "SEIS", "SIETE", "OCHO", "NUEVE", "DIEZ", "ONCE", "DOCE", "TRECE", "CATORCE", "QUINCE", "DIESISEIS", "DIESISIETE", "DIESIOCHO", "DIESINUEVE", "VEINTE", "VEINTIUN", "VEINTIDOS", "VEINTITRES", "VEINTICUATRO", "VEINTICINCO", "VEINTISEIS", "VEINTISIETE", "VEINTIOCHO", "VEINTINUEVE")
laDecenas = Array("DIEZ", "VEINTE", "TREINTA", "CUARENTA", "CINCUENTA", "SESENTA", "SETENTA", "OCHENTA", "NOVENTA")
laCentenas = Array("CIENTO", "DOSCIENTOS", "TRESCIENTOS", "CUATROCIENTOS", "QUINIENTOS", "SEISCIENTOS", "SETECIENTOS", "OCHOCIENTOS", "NOVECIENTOS")
lnNumeroBloques = 1

 Do
        lnPrimerDigito = 0
        lnSegundoDigito = 0
        lnTercerDigito = 0
        lcBloque = ""
        lnBloqueCero = 0
        For i = 1 To 3
                lnDigito = lyCantidad Mod 10
                If lnDigito <> 0 Then
                        Select Case i
                        Case 1
                                lcBloque = " " & laUnidades(lnDigito - 1)
                                lnPrimerDigito = lnDigito
                        Case 2
                                If lnDigito <= 2 Then
                                        lcBloque = " " & laUnidades((lnDigito * 10) + lnPrimerDigito - 1)
                                Else
                                        lcBloque = " " & laDecenas(lnDigito - 1) & IIf(lnPrimerDigito <> 0, " Y", Null) & lcBloque
                                End If
                                lnSegundoDigito = lnDigito
                        Case 3
                                lcBloque = " " & IIf(lnDigito = 1 And lnPrimerDigito = 0 And lnSegundoDigito = 0, "CIEN", laCentenas(lnDigito - 1)) & lcBloque
                                lnTercerDigito = lnDigito
                        End Select
                Else
                        lnBloqueCero = lnBloqueCero + 1
                End If
                lyCantidad = Int(lyCantidad / 10)
                If lyCantidad = 0 Then
                        Exit For
                End If
        Next i
        Select Case lnNumeroBloques
        Case 1
                CantidadEnLetra = lcBloque
        Case 2
                CantidadEnLetra = lcBloque & IIf(lnBloqueCero = 3, Null, " MIL") & CantidadEnLetra
        Case 3
                CantidadEnLetra = lcBloque & IIf(lnPrimerDigito = 1 And lnSegundoDigito = 0 And lnTercerDigito = 0, " MILLON", " MILLONES") & CantidadEnLetra
        End Select
        lnNumeroBloques = lnNumeroBloques + 1
 Loop Until lyCantidad = 0

 CantidadEnLetra = " " & CantidadEnLetra & IIf(tyCantidad > 1, " PESOS ", " PESO ") & Format(Str(lyCentavos), "00") & "/100 M.N. "

End Function


Y guardan el módulo


Yo lo estoy guardando con el nombre de NumEnLetra

Ahora, desde la ventana de la base de datos, le damos Crear una nueva Consulta en Diseño de Consulta


Y agregamos la tabla donde están nuestros datos



Una vez añadidos los campos que nos interesa, incluso filtros que deseen, vamos a añadir nuestra función que recién creamos. Para esto utilizaremos el Asistente de Consultas


En la ventana que se abre, expandimos los Elementos de Expresión y buscamos el módulo que creamos


Al darle clic, nos mostrará la función que copiamos, y al darle doble clic, nos copiará la función en la ventana de Expresiones


Si observamos, vemos que nos pide un parámetro, que es el valor numérico que deseamos pasar a Letras. Así que ahora en los elementos de expresión, buscamos la tabla con la que estamos trabajando y agregaremos como parámetro para la función en campo CURRENCY que nos interesa.


Y, teniendo seleccionado el parámetro en la función, le damos doble clic al campo SALARIO y lo va a insertar como parámetro



Y listo, le damos ACEPTAR.


Vemos el campo que insertó, con el alias de Expr1, así que sería buen momento para cambiarlo


Listo!  Ahora solo ejecutamos la consulta



Y tenemos ya los números en Letras


Saludos!







domingo, 11 de agosto de 2019

ExcelToCi

 ExcelToCi  (Excel-to-Component Interface)


Se puede usar la utilería de Excel To CI para cargar datos de Microsoft Excel a las bases de datos PeopleSoft. Cada hoja de trabajo de excel contiene tanto hojas de trabajo como módulos de código de Excel Visual Basic que ejecutan lógica de negocios para cada transacción.

Usando estos documentos de Microsoft Excel como plantilla, se pueden crear hojas de trabajo que sean específicas de la lógica empresarial que necesita usar cuando carga datos en el sistema PeopleSoft. Puede copiar la hoja de entrada de datos a otras hojas de excel para su distribución sin copiar los módulos de código.

El código formatea los datos de la hoja de cálculo en una estructura del Modelo de objetos de documento (DOM) legible de PeopleSoft y los envía a la base de datos de PeopleSoft. A continuación, un programa PeopleCode analiza la estructura DOM y utiliza el CI (Component Interface) para crear entradas en la base de datos PeopleSoft, validando los datos enviados contra la lógica empresarial que está integrada en el componente PeopleSoft.

El Component Interface ejecuta todos los eventos PeopleCode necesarios y las ediciones a nivel de campo. Según los resultados de guardar el Component Interface, se crea otro DOM en el PeopleCode que devuelve el guardado exitoso, advertencias, errores o una combinación de los tres al documento de Microsoft Excel. Los registros por error se pueden corregir y volver a enviar.

Prerequisitos para usar Excel to CI


Para usar la utilidad Excel to CI, debe tener instalado el siguiente software.

(En My Oracle Support se puede revisar las versiones que actualmente están certificadas).

- Microsoft Excel.
- Microsoft Visual Basic 6.0 SP5: Paquete de redistribución en tiempo de ejecución.
  Puede descargar este software del sitio web de Microsoft en http://www.microsoft.com/downloads/Search.aspx?displaylang=en
- Microsoft Core XML Services (MSXML) 6.0 o superior.
  Puede descargar este software del sitio web de Microsoft en http://www.microsoft.com/downloads/Search.aspx?displaylang=en

Comportamiento y limitaciones del PeopleCode 


Ciertas funciones y eventos de PeopleCode que son específicos de la interfaz de usuario no se ejecutan a través del Component Interface. Se deberá modificar PeopleCode para el componente, las páginas y los registros cuando cree el Component Interface específico para el cada componente.

Los eventos y funciones de PeopleCode que se relacionan exclusivamente con la interfaz de la página y el procesamiento en línea no pueden ser utilizados por los Component Interface. Éstos incluyen:

- Procesamiento de diálogo de búsqueda.
- Menú PeopleCode y menús emergentes.
- Transferencias entre componentes, incluidas las transferencias modales.
- Controles dinámicos de árbol.
- Controles ActiveX.
- DoSave y DoSaveNow.
- Funciones que se ignoran en una llamada del Component Interface.

Otorgar permisos a la librería WEBLIB_SOAPTOCI iScript


Para utilizar la utilidad de Excel To CI, se debe otorgar acceso a la librería de WEBLIB_SOAPTOCI de iScript en la lista de permisos del usuario que está creando la plantilla.

Habilitando el menú de desarrollador en Microsoft Excel 2007 y versiones posteriores


El menú Desarrollador en Microsoft Excel contiene opciones para trabajar con Microsoft Visual Basic, macros, propiedades de hoja, etc.

En Microsoft Excel 2007 y versiones posteriores, el menú de Desarrollador no está habilitado automáticamente y no aparece en la cinta de menú en la vista predeterminada del espacio de trabajo de Excel. En las otras versiones de Microsoft Excel admitidas para su uso con el Component Interface, el menú Desarrollador aparece de forma predeterminada.

El siguiente ejemplo muestra la cinta de menú que aparece en la vista predeterminada del espacio de trabajo de Microsoft Excel 2007:

Microsoft Excel 2007 menu ribbon

Para utilizar la utilidad del Excel To CI, necesita acceder a algunas de las funciones a las que se accede a través del menú de Desarrollador y, por lo tanto, debe habilitar el menú. El siguiente ejemplo muestra el espacio de trabajo de Microsoft Excel 2007 con el menú de Desarrollador habilitado en la cinta de menú:

Microsoft Excel 2007 menu ribbon

Para habilitar el menú Desarrollador en Microsoft Excel 2007 y versiones posteriores:

  1. Inicie Microsoft Excel 2007 o su versión posterior.
  2. En la esquina superior izquierda del espacio de trabajo, haga clic en el icono circular de Microsoft Office.
    Aparece el menú Documentos recientes.
  3. Haga clic en el botón Opciones de Excel en la parte inferior del menú.
    Aparece la página de Opciones de Excel.
  4. En la sección Opciones principales para trabajar con Excel, marque la pestaña Mostrar desarrollador en la opción de la cinta de opciones.
  5. Haz clic en el botón Aceptar.

Aparece el espacio de trabajo de Microsoft Excel 2007 y el menú de Desarrollador aparece en la cinta de menú.

Habilitando las macros en Excel

La utilidad Excel to CI se basa en macros; por lo tanto, debe habilitar macros en Microsoft Excel para que la utilidad funcione. Cuando se abre una hoja de cálculo de Microsoft Excel, el sistema muestra un cuadro de diálogo que le pide que seleccione si desea habilitar macros en la hoja de cálculo. Siempre seleccione Habilitar macros para que puedan funcionar las macros entregadas con la utilidad de interfaz Excel a componente.

Para asegurarse de que las macros estén disponibles para ejecutarse, debe establecer el nivel de seguridad en Microsoft Excel para permitir que se abran las macros.

Para habilitar macros en Microsoft Excel:

  1. Teniendo abierto el documento de excel con la utilería del ExcelToCI.
  2. En el menú de Excel, seleccione seleccione Herramientas, luego seleccione Macros, luego seleccione Seguridad.
  3. Seleccione Medio o Bajo para habilitar las macros.
  4. Selecciona OK.

Iniciando la utilería del Excel To CI

La hoja de cálculo de la utilería del Excel to CI se encuentra en el directorio PS_HOME/excel. El nombre del archivo es ExcelToCI2007.xlsm.

NOTA: Este archivo se sugiere copiar y pegar con un nombre diferente, para conservar este archivo en su estado original y trabajar sobre la copia.

Conversión del documento de Excel a la versión actual de MS Excel

Puede usar plantillas personalizadas de Excel To CI basadas en versiones de Microsoft Excel lanzadas antes del Excel 2007. Para preservar las macros incrustadas en sus plantillas personalizadas de Excel To CI, debe convertir las plantillas a formato Excel 2007 o su versión actual.

Los archivos de Microsoft Excel 2007 y posteriores tienen la extensión .xlsm.

Para convertir una plantilla de Excel To CI al formato actual de Excel:

  1. Abra una plantilla en Excel (su actual versión).
  2. Haga clic en el botón de Microsoft Office y elija Guardar como.
  3. Haga clic en Libro de Excel habilitado para macros.
    Aparece un cuadro de diálogo Guardar como.
  4. Elija una ubicación para guardar e ingrese un nombre para el libro.
  5. El nombre del libro de trabajo debe tener la extensión xlsm, como myworkbook.xlsm
  6. Haz clic en el botón Guardar.

Información de conexión

Acceda a la pestaña Información de conexión en ExcelToCI2007.xlsm haciendo clic en la pestaña Información de conexión:

Connection Information tab

La información en esta página es necesaria para crear una nueva plantilla o para enviar datos a la base de datos. Deberá especificar información del entorno, así como información sobre cómo se deben transmitir los datos. El campo Acción se completará automáticamente en función de su configuración y el Component Interface con el que está asociada la plantilla.

La configuración de conexión inicial serán los valores predeterminados de PeopleSoft. Deberá modificar estos valores para su implementación específica de PeopleSoft. Si no está seguro de qué ingresar para estos valores, consulte con el administrador del sistema.

Las opciones de conexión son:

Web Server Machine Name
El nombre del servidor web PeopleSoft al que se está conectando.


Protocol
El protocolo utilizado para acceder al servidor web. El valor predeterminado es HTTP. El protocolo preferido es HTTPS.

HTTP Port
El número de puerto HTTP que usa el servidor web. El valor predeterminado es 80.

Portal
El nombre del portal que está utilizando. EMPLOYEE es un portal predeterminado enviado con PeopleSoft.

PeopleSoft Site Name
El nombre del sitio de PeopleSoft que ingresó cuando instaló la Arquitectura de Internet de PeopleSoft. El valor predeterminado es ps.


Node
El nombre del nodo local predeterminado de PeopleSoft. El valor predeterminado es PT_LOCAL.

Language Code
El código para el idioma en el que se envían los datos a la base de datos. Si no se especifica ningún código de idioma, se utiliza el idioma base.

Chunking Factor
El número de filas de datos que se transmitirán a la base de datos al mismo tiempo. El valor predeterminado es 40.

Error Threshold
El número total de errores permitidos antes de que finalice el envío a la base de datos Cuando se supera el umbral de error, aparece un mensaje de error y se detiene el envío a la base de datos.

Submit Blanks as Input
Cuando esta opción se establece en Sí y un campo de entrada de caracteres seleccionado para la entrada contiene solo espacios en blanco, el campo se incluirá para el envío en lugar de ser ignorado. Esta opción está configurada en No de forma predeterminada, por compatibilidad con versiones anteriores.
Si se ingresan caracteres Unicode de espacio en blanco de ancho completo como un valor de entrada en ExcelToCI (esto se logra mediante el uso de una codificación que admita dichos caracteres Unicode), se enviará el campo, se enviarán los espacios en blanco y el valor no se recortará antes de que se guarde en la base de datos.
Si se ingresan espacios en blanco ASCII regulares (también conocidos como caracteres de ancho medio) como un valor para un campo de caracteres, el campo se enviará, pero el valor se recortará, por lo que se guardará una cadena vacía. En esencia, el valor del campo se borrará.

Action
El sistema proporciona el valor de este campo cuando la interfaz del componente se recupera de la base de datos. Sin embargo, puede cambiar el valor proporcionado seleccionándolo de la lista desplegable Acción.
Los tipos de acciones disponibles se basan en la estructura de la interfaz del componente. Las acciones son:
Crear (CREATE).
Esta opción está disponible si la interfaz del componente tiene claves de creación. Utilice este modo cuando se agreguen nuevas claves en el nivel 0.
Actualizar (UPDATE).
Esta opción está disponible si la interfaz del componente no tiene claves de creación. Use este modo si está agregando nuevos hijos a un padre existente.
Actualizar datos (UPDATE DATA).
Use esta opción para actualizar valores no clave específicos que ya existen. El sistema usa las teclas para localizar la fila, y cuando se encuentra una coincidencia, la fila se actualiza con nuevos datos. Si el sistema no encuentra una coincidencia de clave, muestra un mensaje de error que indica a qué colección le falta una coincidencia de clave.
Al usar la acción UpdateData, debe proporcionar todas las claves de la colección para que el sistema modifique los datos.
Nota: Si desea insertar una colección con fecha de vigencia en el Nivel 1 que contiene una colección secundaria en el Nivel 2, es posible que necesite usar UPDATE para insertar la fila principal en el nivel 1 y luego usar UPDATEDATA para insertar la fila secundaria en el nivel 2. Esto se debe a que las filas secundarias se copian hacia adelante desde la colección actual con fecha efectiva como resultado de la inserción de una nueva fila principal con fecha efectiva. El procesador de componentes actualizará estas filas secundarias con la nueva fecha de vigencia y puede tener las mismas claves de nivel 2 que la fila secundaria de nivel 2 que está intentando enviar desde ExcelToCI.

Ejemplo:

Conexión a la base de datos para crear una plantilla y enviar datos

Su información de inicio de sesión de PeopleSoft es necesaria tanto para crear la plantilla como para enviar datos a la base de datos.

Acceda al cuadro de diálogo Iniciar sesión seleccionando la pestaña Plantilla y luego haciendo clic en el botón Nueva plantilla, o haciendo clic en el botón Enviar datos en la pestaña Puesta en escena y envío:

Login dialog box

El sistema usa su ID de usuario y contraseña para asegurarse de que tiene los permisos correctos para acceder a la interfaz del componente en el que está creando la plantilla. Debe tener permiso para acceder al Component Interface que está utilizando.


User ID/Password
Ingrese su ID de usuario y contraseña de PeopleSoft.
Ingrese el nombre de la interfaz del componente para el que desea crear la plantilla.
Generate Log
Seleccione la casilla de verificación Generar registro para crear un archivo de registro para ExcelToCI2007.xlsm y uno para la Biblioteca web SOAPTOCI.


Crear plantillas

La página de la plantilla es una representación gráfica de la estructura del Component Interface que usará para cargar datos. La estructura del Component Interface se recupera de la base de datos cuando se crea una nueva plantilla. Todos los campos que están expuestos a través del Component Interface aparecen en la página de la plantilla. Los campos que son de solo lectura en el Component Interface no aparecerán en la plantilla.

La nueva macro de plantilla construye la relación padre-hijo dentro de Microsoft Excel según la definición de nivel de desplazamiento en el Component Interface. El sistema agrega una nueva fila para cada nivel de desplazamiento y le asigna un identificador único.

Acceda a la pestaña Plantilla en ExcelToCI.xlsm para crear su plantilla:

Template tab


Collection
El nombre de la colección de interfaz de componentes. Una colección es una propiedad que apunta a un desplazamiento, en lugar de un campo, en el componente subyacente para una interfaz de componente.
Property
El nombre de propiedad de la interfaz del componente. Por lo general, este también es el nombre del campo en la página.
Record Type
Este número representa la relación padre / hijo de los registros. El registro de desplazamiento de nivel 0 siempre está representado por 000. Los registros de desplazamiento de nivel 1 aparecen con números que comienzan con 100 y siempre tienen 00 como los dos últimos números.
Los pergaminos de nivel 2 se identifican con números que comienzan con el identificador de su padre de nivel 1 y terminan con un 0.
Los pergaminos de nivel 3 se identifican por el primer número del padre de nivel 1, el segundo número de su padre de nivel 2 y luego el tercer número de su propia posición en la lista.
Los números para cada nivel de desplazamiento se incrementan en función del número de registros que existen en ese nivel. Por ejemplo, el nivel 0 sería 000, el nivel 1 sería 100, el nivel 2 sería 110, y así sucesivamente.
Nota: Las interfaces de componentes que tienen más de 10 colecciones en un nivel dado se incrementarán con identificadores alfabéticos. Por ejemplo, 800, 900, A00, etc.
Field Type
El tipo de PeopleSoft estándar para el campo, por ejemplo, Fecha, Carácter, etc.
Field Length
La longitud del campo según lo definido por PeopleSoft. Para campos numéricos y campos de números con signo, la longitud se divide en números enteros y decimales. Por ejemplo, una longitud de 15.3 indica 15 posiciones enteras y tres posiciones decimales.
Key/Required
Si el campo es un campo clave, el sistema mostrará una Y a la izquierda de la barra diagonal. Cuando el campo no es una clave, estará en blanco. Si el campo es un campo obligatorio, el sistema mostrará una R a la derecha de la barra diagonal. Cuando el campo no es obligatorio, estará en blanco. Esta información proviene de la definición del registro en sí.
Nota: Los campos que son claves u obligatorios deben establecerse para enviar datos correctamente.
Sequence
El número de secuencia representa el orden de las propiedades en la plantilla..
Status
Este campo muestra el estado de carga en la página Puesta en escena y envío.
Line No line number
Esto corresponde al número de línea en los datos de entrada y las páginas de ensayo y envío.

Comprender la barra de herramientas de acciones de plantilla

La barra de herramientas de acciones de plantilla está compuesta por botones que usa para crear y modificar una plantilla, así como para crear una hoja de entrada de datos. Puede cambiar el tamaño de la barra de herramientas y moverla a cualquier ubicación de la página o incluso arrastrarla a la barra de herramientas estándar existente de Microsoft Excel. Cuando haya movido la barra de herramientas a una ubicación, permanecerá allí hasta que la mueva nuevamente. No necesita mover la barra de herramientas cada vez que abre el libro.

Cada botón de la barra de herramientas tiene un texto de ayuda que describe el propósito y el uso de cada uno de los botones cuando coloca el cursor sobre el botón.


Crea una nueva plantilla basada en una interfaz de componente. La macro Nueva plantilla construye la relación padre-hijo dentro de Microsoft Excel basada en la estructura de la interfaz del componente.
Cuando crea una nueva plantilla, el sistema le solicita su información de inicio de sesión.
New Data Input
Crea una nueva hoja de entrada de datos basada en las celdas de entrada seleccionadas. Cuando crea una nueva hoja de entrada de datos, el sistema le pregunta si desea sobrescribir la hoja existente. Si selecciona Sí, se crea una nueva hoja de entrada de datos, sobrescribiendo la anterior.
Select Input Cell
Selecciona una celda individual para incluirla en la hoja de entrada de datos. Las celdas que se han seleccionado como celdas de entrada se resaltan en rosa.
Select All Input Cells
Selecciona todas las propiedades que se incluirán en la entrada de datos como celdas de entrada. Cuando se selecciona una celda como celda de entrada, se resalta en rosa.
Restore Input Cells
Restaura la plantilla a su estado original y borra los valores predeterminados. Los campos en la plantilla se resaltarán en gris, lo que indica que no se incluye nada para enviar.
Insert New Child
Copia la fila seleccionada para insertarla como un nuevo hijo. Esto crea múltiples ocurrencias del mismo tipo de registro.
Por ejemplo, si la fila seleccionada tiene un identificador de plantilla de 100, se inserta una nueva fila que también tiene un identificador de 100 y es un duplicado exacto de la fila seleccionada.
Nota: Use Insert New Child cuando se deben enviar varios hijos bajo el mismo registro padre. No se deben crear varios hijos en el identificador 000.
Include All for Submission
Incluye todas las propiedades en la hoja de cálculo que se incluirán para su envío a la base de datos. Las celdas que se incluyen para el envío aparecen solo en la hoja de ensayo y envío y no aparecen en la hoja de entrada de datos. Las propiedades que se incluyen para el envío se resaltan en azul.
Include for Submission
Incluye una sola propiedad que se incluirá en la hoja de Presentación y Presentación. Las propiedades que usan valores predeterminados de la plantilla deben incluirse para el envío. Las celdas que se incluyen para el envío generalmente son propiedades que contienen valores predeterminados o propiedades que le gustaría ver en la estructura de la hoja de Presentación y Presentación. Las propiedades que se incluyen para el envío se resaltan en azul.
Deselect Input Cell
Cambia una celda que se seleccionó previamente como celda de entrada a una celda que se incluye para su envío. La celda ya no se incluye en la hoja de entrada de datos, pero aparece como parte de la estructura en la hoja de Presentación y Presentación.
Clear Template
Borra todos los datos y estructuras en esta hoja.
Do Not Include for Submission
No incluye la propiedad seleccionada para enviar a la base de datos. Si una propiedad no se incluye para su presentación, no aparecerá en la estructura que se envía a la base de datos en la hoja de Presentación y Presentación. Las propiedades que no están incluidas para el envío aparecerán solo en la hoja de trabajo de la plantilla y no se enviarán a la base de datos. Las propiedades que no están incluidas para el envío se resaltan en gris.

Nota: Cuando crea una nueva plantilla o una nueva hoja de entrada de datos, el sistema borra la hoja de trabajo existente de toda la información existente. Si tiene una plantilla u hoja de entrada de datos que necesita guardar de cargas anteriores, guarde una copia de la hoja de trabajo antes de crear una nueva plantilla u hoja de entrada de datos.

Introducir datos en la plantilla

Al determinar qué propiedades incluir como celdas de entrada y qué propiedades incluir para el envío, recuerde que la interfaz del componente utiliza la misma lógica de negocios y ejecuta el mismo PeopleCode como si el registro se ingresara en línea usando la página en su aplicación PeopleSoft. Para proporcionar los datos mínimos necesarios, estos campos deben proporcionarse con valores predeterminados (codificados) o valores que proporcione utilizando la hoja de entrada de datos.

Nota: Debe probar la plantilla que creó con algunas entradas de muestra y luego verificar sus resultados antes de usar la interfaz para la entrada masiva. Por ejemplo, si olvidó seleccionar una propiedad, deberá crear una nueva hoja de entrada de datos. Si los resultados del envío son satisfactorios, continúe ingresando datos.

Agregar un nuevo registro secundario

Por defecto, cada colección se representa una vez en la plantilla. Para insertar copias de una colección determinada, seleccione esa colección y haga clic en el botón Insertar nuevo hijo para crear una copia de la fila seleccionada. La colección que seleccionó se copia para que pueda tener dos filas bajo el mismo padre.

Template tab

Agregar valores predeterminados

Algunos campos tienen valores predeterminados asociados, ya sea en la definición de registro o en tiempo de ejecución cuando el registro se crea en la base de datos. Además, muchos componentes activan PeopleCode, que también proporciona valores predeterminados. Para aceptar el valor predeterminado de la base de datos, incluya la propiedad para el envío y se utilizará el valor predeterminado del sistema.

Es posible que existan algunos campos para los que desea crear su propio valor predeterminado. Por ejemplo, si desea establecer el valor de un campo denominado Estado a partir de la fecha de vigencia en A para cada fila que envíe, ingrese ese valor para el campo en la plantilla. Luego incluya la celda para enviar en la plantilla. El campo no aparecerá en la página de entrada de datos, pero el valor aparecerá en el campo en la página Enviar a la base de datos. Esto es útil para fechas efectivas, campos de estado, ID de conjuntos para importaciones simples, etc.

Al proporcionar valores para campos de traducción o tablas de solicitud, proporcione el valor del campo en lugar de la descripción corta o larga para el valor de traducción. Si no está seguro de los valores de campo, verifique el registro o la definición de campo en PeopleSoft Application Designer.

Introducción de datos en la hoja de entrada de datos

La hoja de entrada de datos le permite ingresar datos en la utilidad Excel a la interfaz de componentes para que pueda cargarse en la base de datos utilizando la interfaz de componentes que ha seleccionado. Puede ingresar datos manualmente o puede cortarlos y pegarlos desde otra hoja de cálculo o aplicación de terceros.

Usando la hoja de entrada de datos

Acceda a la pestaña de ingreso de datos para ingresar datos:

Data Input tab

Las etiquetas de campo que aparecen en la hoja de entrada de datos son aquellas propiedades que seleccionó como celdas de entrada en la plantilla. Cada nivel de desplazamiento se identifica por color. El tipo de registro de la plantilla también se muestra para cada propiedad.

El sistema crea formatos predeterminados de fecha, hora y número cuando crea la plantilla. Puede modificar este formato utilizando el formato de celda predeterminado de Microsoft Excel al ingresar datos, con la excepción del formato d/m/aa para fechas y horas. En su lugar, utilice siempre un formato d/m/aaaa para fechas y horas. Para acceder a la función de formato, seleccione seleccionar Formato, luego seleccione Celdas en el menú de Excel.

La hoja de entrada de datos también se utiliza para corregir los datos que no se pudieron enviar a la base de datos. Los errores marcados en la página Enviar a la base de datos se publican en la página de entrada de datos y, cuando los haya corregido, los elementos marcados con error se pueden volver a colocar en la hoja de Presentación y Presentación.

Acciones de entrada de datos

La barra de herramientas Acciones de entrada de datos contiene el botón Datos de etapa para envío, que toma los datos que ingresó en la hoja de ingreso de datos y los prepara para enviarlos a la base de datos. Cuando los datos están organizados, aparecen en la hoja de Presentación y Presentación en la estructura de plantilla jerárquica. En este punto, debe verificar que todos los campos se llenen como se esperaba. Cuando los datos se organizan, muestra tanto los datos en la hoja de entrada de datos como los datos que especificó como valores predeterminados.

Ver los datos por etapas

Acceda a la pestaña  Staging and Submission:

Staging &amp; Submission tab


Barra de Herramientas de Staging and Submission

Post Results
Los resultados del envío se copian en la hoja de entrada de datos, donde puede ver el estado de cada fila que se envía y hacer las correcciones necesarias a las filas que tienen el estado de Error.
Submit Data
Aparece el cuadro de diálogo de inicio de sesión. Debe especificar su ID de usuario y contraseña.
El sistema envía los datos a la base de datos en los fragmentos que especificó en la hoja de Información de conexión.
Después de corregir cualquier error en la hoja de entrada de datos, puede enviar los datos nuevamente. Los elementos que se marcaron como Error se volverán a enviar, mientras que los marcados como Aceptar y Advertencia se ignorarán.

Error al enviar claves existentes

Si recibe el mensaje de error La fila ya existe con las claves especificadas y está en modo CREAR, la clave ya existe en el nivel 0 o es parte del registro de búsqueda.

Para verificar que la clave existe:

  1. Abra la interfaz del componente en PeopleSoft Application Designer.
  2. Inicie el probador de interfaz de componentes seleccionando Herramientas, luego seleccione Probar interfaz de componentes.
    Aparece el cuadro de diálogo de búsqueda de Tester de la interfaz del componente. Este cuadro de diálogo muestra las teclas (en las columnas de la izquierda) para obtener, crear o encontrar una instancia de la interfaz del componente.
  3. Ingrese el valor de la clave que está probando.
  4. Haga clic en Obtener existente para obtener la clave que está a punto de agregar, utilizando la utilidad de interfaz Excel a componente.
    Si el comando Obtener claves devuelve la clave, la clave ya existe y debe agregar datos mediante el modo UPDATE.
    Si recibe un mensaje de que no existe una fila para la clave, entonces la clave no existe en el nivel 0 y los datos deben agregarse utilizando el modo CREATE.

Corrección y reenvío de datos

Después de enviar los datos a la base de datos, los resultados del proceso aparecen en la hoja de Presentación y Presentación. Si un envío tuvo un error, el estado de error aparece en la hoja de Presentación y Envío. Use la página de entrada de datos para corregir los datos y luego vuelva a enviarlos a la base de datos. Continúe este proceso de corrección de errores y reenvío de datos hasta que no queden errores.

Nota: Los datos que no se enviaron porque se alcanzó el umbral de error no tendrán estado. Cuando los datos que crearon el error se corrigen en la hoja de entrada de datos, los datos que no se enviaron se almacenarán en la base de datos.

Estados de envío

Los errores recibidos para cada registro enviado aparecen en un campo de comentarios cuando mueve el cursor sobre la columna de estado. Los registros marcados como OK en verde se han enviado correctamente y no se pueden volver a clasificar para su envío y se pueden guardar como un registro del trabajo completado.

Uno de los siguientes tres valores de estado puede aparecer cuando envía datos a la base de datos:


Ok
El envío a la base de datos finalizó con éxito. El campo se resalta en verde.
Estos registros no se pueden volver a clasificar para su envío.
Los datos se guardaron en la base de datos con éxito, pero se generó una advertencia en el proceso. El campo está resaltado en amarillo.
Error
Los datos no se guardaron en la base de datos debido a un error. Este campo está resaltado en rojo.
Para ver el mensaje de error que generó la interfaz del componente, coloque el cursor sobre el campo Estado. Este mensaje indica cómo deben corregirse los datos.



Referencias útiles

Translate