Definición de servicios de interfaz

Para definir un servicio de interfaz:

Nota: Para definir un servicio de interfaz a partir de otro existente o para editar un servicio de interfaz, consulte Edición de servicios de interfaz.
  1. Seleccione Configuración > Común > Servicios de interfaz.
  2. Haga clic en Nuevo.
  3. En la ventana Nuevo servicio de interfaz, especifique esta información:
    Tipo de interfaz
    Seleccione el tipo de interfaz. Estas son las opciones:
    • Planificación avanzada
    • CSV
    • Base de datos
    • EXCEL
    Entidad de datos
    Seleccione la entidad de datos que se debe mapear a la interfaz. Los tipos de entidades de datos:
    • Calendario
    • Lista de códigos
    • Vista de escenario
      Nota: Si selecciona esta opción, debe especificar el Comportamiento de importación.
    • Datos transaccionales
    Dirección de interfaz
    En función de lo que haya seleccionado anteriormente, especifique Exportar, Importar o Importar y exportar, según sea necesario.
    Columna por medida
    Si se selecciona esta casilla de verificación, cada medida se mostrará en una nueva columna en la interfaz. En la ficha Mapeos puede añadir nuevas filas y medidas con estas dimensiones:
    • Artículo
    • Ubicación
    • Período de calendario

    Si no se selecciona esta casilla de verificación, la lista de dimensiones de la ficha Mapeos se fija en cinco columnas con estas dimensiones:

    • Artículo
    • Ubicación
    • Período de calendario
    • Medida
    • Valor
    Nota: Este campo se muestra únicamente si Entidad de datos está establecido en Valor de escenario, para todos los tipos de interfaz.
  4. Haga clic en Aceptar. Un formulario de detalles sustituye a la lista. En dicho formulario, los valores de los campos Tipo de interfaz y Entidad de datos se basan en la selección realizada.
  5. Según la entidad de datos seleccionada, especifique esta información:
    Módulo
    El módulo al que está vinculado el servicio de interfaz. Seleccione el módulo correspondiente.
    Lista de códigos de destino
    Nombre del origen de datos utilizado como parte del servicio de interfaz.
  6. Especifique esta información:
    Nombre
    Especifique el nombre del servicio de interfaz de interpolación.
    Nombre para mostrar
    Especifique el nombre que se debe mostrar en la aplicación. Se trata de un campo opcional.
    Sistema
    Se trata de un campo de solo lectura.
    Origen de datos
    Nombre del origen de datos utilizado como parte del servicio de interfaz.
  7. En función del tipo de interfaz que haya seleccionado, especifique la información necesaria:
    Si selecciona CSV:
    Opción Descripción
    Archivos Nombre del archivo CSV utilizado como parte del servicio de interfaz.
    Nombres de campo en fila de cabecera

    Seleccione esta casilla de verificación para indicar una de las opciones siguientes:

    • La primera fila del archivo de importación contiene etiquetas de campo y se puede omitir.
    • La primera fila del archivo de exportación debe contener cabeceras de campo.
    Definición de período del calendario Indica si los períodos de calendario se exportan con la fecha de inicio de período, la fecha de fin de período o el nombre de período que se define en el formato de calendario, por ejemplo AF10 M03.
    Si selecciona Base de datos y, para el Origen, utiliza la selección de Tabla predeterminada, especifique esta información:
    Opción Descripción
    Tablas Nombre de la tabla utilizada como parte del servicio de interfaz.
    Filtro de importación

    Especifique un filtro para los datos transmitidos mediante el servicio de interfaz; de otro modo, se podrán aplicar todos los registros de la tabla de origen seleccionada. El texto debe presentar el formato de cláusula SQL estándar "WHERE", aunque la palabra clave "WHERE" esté implícita.

    Para filtrar los datos mediante dimensiones, también puede utilizar estas variables:

    • %cycle%: El nombre del ciclo.
    • %cycleperiod%: La etiqueta de período de ciclo.
    • %cycleperiod-Startdate%: La fecha de inicio del período de calendario de ciclo actual (en Ciclo.Periodicidad), en el formato de fecha correspondiente. No es la fecha en que se inicia el período de ciclo.
    • %cycleperiod-Enddate%: La fecha de finalización del período de calendario de ciclo actual (en Ciclo.Periodicidad), en el formato de fecha correspondiente. No es la fecha en que se completa el período de ciclo ni el fin del horizonte del período de ciclo.
    • %horizon-start%: La fecha de inicio del horizonte del período de ciclo, en el formato de fecha correspondiente; es el primer período base (el más antiguo) dentro del período de ciclo actual.
    • %horizon-end%: La fecha de finalización del horizonte del período de ciclo, en el formato de fecha correspondiente; es el último período base (el más reciente) dentro del período de ciclo actual.
    • %scenario%: El nombre del escenario.

    Ejemplos:

    CHAN_ID <> 'TOTAL' AND End_date > %CyclePeriod-StartDate% o PROD_GROUP = %scenario% AND PERIOD >= %horizon-start% AND PERIOD <= %horizon-end%
    Si selecciona Base de datos > Origen > Consulta:
    Opción Descripción
    Consulta Especifique una instrucción SQL y haga clic en Verificar para validar el texto de la consulta.
    Nota:  Si la consulta se valida satisfactoriamente, los campos devueltos se almacenan para su uso en las fichas Mapeos e Importar/Exportar medidas, lo que le permite seleccionar los campos para mapear.

    En caso contrario, debe añadir manualmente los campos para mapear en el origen de datos de esta interfaz.

  8. Para cualquiera de los tipos de interfaz:
    Definición de período del calendario
    Indica si los períodos de calendario se exportan con la fecha de inicio de período, la fecha de fin de período o el nombre de período que se define en el formato de calendario, por ejemplo AF10 M03.
  9. Seleccione la casilla de verificación Borrar valores de escenario no cambiados para restablecer los valores de escenario que no se hayan modificado, después de importar los datos según el filtro de medidas.
    Nota:  Si se especifica el filtro de medidas, se restablecen todos los valores no cambiados para las medidas del filtro. Si no se especifica, se restablecen todos los valores no cambiados para las medidas actualizadas durante la importación.
  10. La ficha Mapeos contiene una lista de dimensiones que se van a mapear y la configuración de módulo, si es aplicable. En esta ficha, cambie las etiquetas de campo relacionadas según sea necesario.
  11. La ficha Importar/Exportar medidas contiene una lista de medidas (filas) que hacen las veces de origen o destino de la transferencia y el identificador correspondiente del servicio de interfaz. En esta ficha, haga clic en Nuevo para introducir medidas que sirvan como filtro para el servicio de interfaz, para importar o exportar únicamente las medidas que se definan aquí.
  12. Para el tipo de interfaz Base de datos, la ficha Exportar constantes adicional enumera los datos constantes aplicables para exportar. En esta ficha, cambie las etiquetas de campo relacionadas y los valores según sea necesario. Las constantes de exportación especificadas en esta ficha pueden usarse para exportar varios escenarios con una única definición de interfaz utilizando las variables del Filtro de importación. Por ejemplo, si la constante de exportación usa la variable %scenario%, esta puede usar una definición de interfaz única para exportar varios escenarios.

    Para filtrar los datos mediante dimensiones, también puede utilizar estas variables:

    • %cycle%: El nombre del ciclo.
    • %cycleperiod%: La etiqueta de período de ciclo.
    • %cycleperiod-Startdate%: La fecha de inicio del período de calendario de ciclo actual (en Ciclo.Periodicidad), en el formato de fecha correspondiente. No es la fecha en que se inicia el período de ciclo.
    • %cycleperiod-Enddate%: La fecha de finalización del período de calendario de ciclo actual (en Ciclo.Periodicidad), en el formato de fecha correspondiente. No es la fecha en que se completa el período de ciclo ni el fin del horizonte del período de ciclo.
    • %horizon-start%: La fecha de inicio del horizonte del período de ciclo, en el formato de fecha correspondiente; es el primer período base (el más antiguo) dentro del período de ciclo actual.
    • %horizon-end%: La fecha de finalización del horizonte del período de ciclo, en el formato de fecha correspondiente; es el último período base (el más reciente) dentro del período de ciclo actual.
    • %scenario%: el nombre de escenario.
  13. Haga clic en Enviar.
Temas relacionados