Descripción de las API disponibles

Objective

After completing this lesson, you will be able to describa las API disponibles.

API de SAP IBP

SAP Integrated Business Planning, add-in para Microsoft Excel ofrece varias API para utilizar con la codificación de Microsoft Visual Basic for Applications (VBA).

Inicialmente, varias API se pusieron a disposición con la versión de 2005. A partir de las versiones 2202.2.0 y 2205.2.0, se proporcionaron API adicionales para que las funciones básicas del add-in de Microsoft Excel fueran accesibles mediante la codificación de VBA. Por ejemplo:

  • Desencadenar las acciones principales: guardar datos, simular y actualizar
  • Recuperar y manipular las opciones de filtro basadas en atributos de una vista de planificación
  • Determinar los valores de atributo de celdas específicas en una vista de planificación
  • Borrar valores de filtro
  • Obtener tipos de datos maestros
  • Obtener datos maestros individuales
  • Actualizar datos maestros individuales

Se siguen liberando nuevas API. Se resaltan en la serie de seminarios web sobre novedades y se enumeran en la Ayuda. También hay ejemplos disponibles en GitHub. El repositorio GitHub contiene varias muestras de VBA para ilustrar los casos de uso y las capacidades existentes.

El uso de API no debe provocar una degradación del rendimiento. Los usuarios pueden esperar la misma respuesta con la API que al utilizar la función del add-in de Microsoft Excel.

De forma predeterminada, las API recién proporcionadas están desactivadas. Para activarlos, debe modificar el parámetro de configuración global EXCEL_PLANNING_VIEW_APIS en el grupo de parámetros PLAN_VIEW de NONE a uno de los siguientes valores de parámetro:

  • Lectura: Las APIs para modificar la definición de la vista de planificación están activadas y se pueden utilizar mediante la codificación de VBA.

    (API activadas: Refresh, GetFilterValues, SetFilterValues y GetAttributeValues)

  • Simular: las API para simular modificaciones de datos, incluidas las API para modificar la definición de la vista de planificación, están activadas y se pueden utilizar mediante la codificación de VBA.

    (API activadas: todas las API mencionadas en Leer y Simular)

  • Guardar: las API para guardar de forma persistente las modificaciones de datos están activadas, además de las demás API, y se pueden utilizar mediante la codificación de VBA.

    (API activadas: todas las API recién proporcionadas y SaveData)

Muestras VBA

Las APIs se pueden utilizar para ampliar los modelos de vista de planificación mediante la codificación de VBA para crear su propia lógica empresarial y automatizar algunos de los pasos manuales que los planificadores deben realizar en su trabajo diario.

Como punto de partida para la implementación, GitHub contiene artefactos que se pueden utilizar como punto de partida para explorar las capacidades de las API. La información se agrupa por caso de uso y hay muestras de código disponibles para descargar, así como vídeos que muestran el producto final.

Crear patrones de navegación entre hojas de trabajo en un modelo de vista de planificación.
Configure un modelo de vista de planificación.

Extensión de la cinta

Se puede crear una extensión de la cinta de SAP IBP mediante un archivo .xml y macros de Microsoft Office Excel. El archivo que admite la extensión de cinta debe colocarse en %LOCALAPPDATA%\SAP_IBP_Addin (de forma similar al archivo que admite capacidades gráficas en las vistas de planificación).

La cinta SAP IBP se puede ampliar utilizando un archivo .xml y la codificación VBA.

Activar la pestaña Desarrollador y trabajar con las API de SAP IBP

Tarea 1: Trabajar con modificaciones de demanda y códigos de motivo predefinidos

Desea que la planificación sea más fácil de usar para el usuario y, al mismo tiempo, asegurarse de que las modificaciones se etiqueten y comenten en consecuencia.

Pasos

  1. Acceda a la plantilla Planificación basada en la combinación y aplique su filtro Mis productos de grupo# a la última pestaña.

    1. Si tiene modelos o favoritos de ejercicios anteriores abiertos, ciérrelos.

    2. En la sección Administración de modelos de la cinta SAP IBP, seleccione Modelos y abra Planificación basada en combinación.

    3. Seleccione Vista de planificaciónHoja de trabajo Filtro aplique el filtro "Productos de mi grupo ##" a la pestaña Planificación de consenso.

    4. Seleccione OK.

  2. Realice una modificación en el valor de la demanda de consenso y guarde las modificaciones utilizando la funcionalidad estándar en la cinta SAP IBP y la API relevante.

    1. En la pestaña Planificación de consenso, realice una modificación en la demanda de consenso para su producto en el tercer período a partir de ahora. Para grabar la modificación, seleccione Grabar datos.

    2. Realice una modificación en la demanda de consenso para su producto en el cuarto período a partir de ahora. Para grabar la modificación, seleccione Grabar.

      Resultado

      Puede ver un comentario rellenado previamente (el nombre de la plantilla y la hoja de cálculo se toma del Administrador de nombres, con el que trabajó en el primer ejercicio) y un código de motivo.

Tarea 2: Visualizar el código que admite la planificación basada en combinación y probar la automatización en la vista de planificación

Para familiarizarse con el código para la planificación basada en combinación, visualice el código proporcionado en el modelo y, a continuación, desplácese por la lista de combinaciones.

Pasos

  1. Valide que tiene la pestaña Desarrollador disponible en la IU de Microsoft Excel y abra la macro en la hoja de trabajo Planificación.

    1. En la interfaz de usuario de Microsoft Excel, vaya a la pestaña Desarrollador.

      Nota

      Si no ve la pestaña, haga clic con el botón derecho en cualquier parte de la cinta y seleccione Personalizar la cinta y añada la pestaña Desarrollador.
    2. En la sección Código, seleccione Visual BasicMicrosoft Visual Basic for Applications - Combination-based Planning.xlsmSheet 2 (Planning) y lleve el código al panel derecho. Consulte la siguiente captura de pantalla como referencia.

    3. Observe cómo se declara el objeto de automatización de IBP, desplácese hacia abajo y verifique el código de las subrutinas Actualizar, Siguiente y Anterior.

      Resultado

      El código se muestra y se parece a la captura de pantalla.Código del proyecto VBA en la pestaña Desarrollador.
  2. En la vista de planificación, actualice la lista de combinaciones y desplácese por la lista.

    1. Cambie a la etiqueta "Planificación" en el modelo de planificación basado en la combinación que está abierto.

    2. Seleccione Vista de planificaciónHoja de trabajo Filtro aplique el filtro Mi grupo Productos#.

    3. Seleccione OK.

      Esto crea una lista de combinaciones que el planificador querría revisar una por una.

    4. Seleccione Actualizar pool de trabajo utilizando el botón de control VBA situado encima de la tabla de planificación. Observe que solo se muestra una combinación.

    5. Ahora seleccione Posición siguiente utilizando el botón de control VBA situado encima de la tabla de planificación. Observe que ahora se muestra la siguiente combinación con otra ubicación.

    6. Seleccione Vista de planificaciónFiltroEditar y verifique que las opciones de filtro reflejen la combinación en la vista de planificación.