Pack SAP PM — Mantenimiento
El pack de mantenimiento tiene dos usos bastante distintos, y conviene elegir cuál interesa antes de instalar:
- Mantenimiento reactivo — la línea se rompe, el operador abre un aviso desde la tablet, el técnico notifica el tiempo dedicado y el aviso se cierra.
- Mantenimiento preventivo por medición — el horímetro del activo, el contador de piezas o la temperatura del sensor se convierten en documento de medición en SAP, y SAP dispara el plan preventivo solo.
El segundo es el que más impresiona, y donde el CMS hace algo que una integración común no hace.
Antes de instalar, lea Packs SAP — el asistente y los parámetros son comunes a los tres packs.
Medición sin escribir código
El CMS ya lee OPC UA, Modbus, PI Web API y MQTT. El pack PM cierra el otro lado. Junte los dos y el camino queda así:
Usted configura la recolección de la tag, la reenvía a la interfaz de medición del pack, y el horímetro del activo pasa a alimentar el mantenimiento preventivo de SAP. Sin una línea de código.
Dos recetas de medición — cuál usar
| Integración MES de EAM | Por punto de medición | |
|---|---|---|
| Función | EAM_MES_CREATE_MEASUREM_DOCUM | MEASUREM_DOCUM_RFC_SINGLE_001 |
| Usted informa | El equipo | El número del punto de medición |
| Cuándo usar | El MES conoce el activo, no la estructura de medición de SAP | El MES ya fue configurado con los números de los puntos |
| Extra | — | Puede crear un aviso automático cuando la lectura supera el límite |
La primera es más simple y la recomendada para empezar. Exige el código de rol de la medición, que identifica qué magnitud se registra — confírmelo con el equipo de mantenimiento y complételo en el paso 3 del asistente.
No existe BAPI de medición en este release de SAP. Las funciones son módulos clásicos
(MEASUREM_*), sin el prefijo BAPI_. Una de ellas hace su propio commit, y por eso es la única
entrega del pack con “commit tras la llamada” desactivado — activar ambos haría commit doble.
Aviso de mantenimiento
La clase del aviso (M1 avería, M2 solicitud, M3 actividad) es un parámetro del pack. Confirme
cuáles están activas en el Customizing de su planta antes de instalar.
Igual que en QM, crear por sí solo no persiste: BAPI_ALM_NOTIF_CREATE solo arma el aviso en la
memoria de la sesión RFC. Por eso la receta Abrir aviso llama a BAPI_ALM_NOTIF_SAVE a
continuación, en la misma sesión, y hace el commit — ver
llamadas siguientes. El número
definitivo es el que devuelve el SAVE (NOTIFHEADER.NOTIF_NO); el del CREATE es provisorio
(%00000000001).
Dos Entregas no forman el par. Reenviar la respuesta de “Abrir” a “Grabar” parece funcionar y no graba nada: cada mensaje abre su propia conexión RFC, y el aviso creado en la primera no existe en la segunda. Es la misma sesión o nada.
Esta es la receta que usa Help Desk para abrir un aviso a partir de una alerta.
El ciclo completo disponible es crear → grabar → en proceso → cerrar, más aplazar y concluir tarea.
Note que BAPI_ALM_NOTIF_COMPLETE no existe en este release — el par real es PUTINPROGRESS y
CLOSE.
Detalles a tener en cuenta
El contador solo crece. Registrar una lectura menor que la última falla. Si hubo cambio de
instrumento o puesta a cero, use lectura diferencial (leituraDiferencial) en vez del valor
absoluto.
Volumen. La interfaz de medición nace con paquete de 50 mensajes y alerta en 2000, contra 10 y 500 de las demás: la medición suele ser, de lejos, el mayor volumen del pack. Si va a registrar por minuto, revise la programación de la interfaz antes de activarla.
Equipo sin punto de medición. Si el activo no tiene punto registrado para esa magnitud, SAP lo rechaza. El pack traduce el error; el maestro es tarea del equipo de mantenimiento.
Resumen
31 recetas — 14 recolección, 17 entrega — de las cuales 12 esenciales.
Recetas
Orden
| Receta | Dirección | Función SAP | Resuelve |
|---|---|---|---|
| Detalle de la orden de mantenimiento ·esencial | Recolección | BAPI_ALM_ORDER_GET_DETAIL | Cabecera, operaciones y componentes de una orden PM — lo que el técnico necesita antes de ir a campo. |
| Cartera de órdenes de mantenimiento ·esencial | Recolección | BAPI_ALM_ORDERHEAD_GET_LIST | Lista las órdenes PM por rango de selección — la cartera del panel de mantenimiento. |
| Notificación de tiempo de orden PM ·esencial | Entrega | BAPI_ALM_CONF_CREATE | El técnico notifica el tiempo dedicado a la operación de la orden desde la tablet. |
| Distribuir orden PM al MES | Recolección | EAM_MES_DISTRIBUTE_PMORD | Distribuir orden PM al MES. Receta generada a partir de la firma de EAM_MES_DISTRIBUTE_PMORD en SAP. |
| Notificaciones PM | Recolección | BAPI_ALM_CONF_GETLIST | Notificaciones PM. Receta generada a partir de la firma de BAPI_ALM_CONF_GETLIST en SAP. |
| Detalle de la notificación PM | Recolección | BAPI_ALM_CONF_GETDETAIL | Detalle de la notificación PM. Receta generada a partir de la firma de BAPI_ALM_CONF_GETDETAIL en SAP. |
| Anular notificación | Entrega | BAPI_ALM_CONF_CANCEL | Anular notificación. Receta generada a partir de la firma de BAPI_ALM_CONF_CANCEL en SAP. |
Aviso
| Receta | Dirección | Función SAP | Resuelve |
|---|---|---|---|
| Detalle del aviso de mantenimiento ·esencial | Recolección | BAPI_ALM_NOTIF_GET_DETAIL | Ítem, causa, actividad y textos largos de un aviso — el historial del problema. |
| Crear aviso de mantenimiento ·esencial | Entrega | BAPI_ALM_NOTIF_CREATE | Una avería o anomalía en la línea se convierte en aviso PM al instante, ya vinculado al equipo. |
| Grabar aviso de mantenimiento ·esencial | Entrega | BAPI_ALM_NOTIF_SAVE | Persiste el aviso creado en el paso anterior. |
| Cerrar aviso de mantenimiento ·esencial | Entrega | BAPI_ALM_NOTIF_CLOSE | Cierra el aviso cuando termina la reparación — el otro extremo del ciclo abierto en la línea. |
| Avisos de un equipo | Recolección | BAPI_ALM_NOTIF_LIST_EQUI | Avisos de un equipo. Receta generada a partir de la firma de BAPI_ALM_NOTIF_LIST_EQUI en SAP. |
| Avisos de una ubicación técnica | Recolección | BAPI_ALM_NOTIF_LIST_FUNCLOC | Avisos de una ubicación técnica. Receta generada a partir de la firma de BAPI_ALM_NOTIF_LIST_FUNCLOC en SAP. |
| Complementar el aviso | Entrega | BAPI_ALM_NOTIF_DATA_ADD | Complementar el aviso. Receta generada a partir de la firma de BAPI_ALM_NOTIF_DATA_ADD en SAP. |
| Modificar datos del aviso | Entrega | BAPI_ALM_NOTIF_DATA_MODIFY | Modificar datos del aviso. Receta generada a partir de la firma de BAPI_ALM_NOTIF_DATA_MODIFY en SAP. |
| Poner el aviso en proceso | Entrega | BAPI_ALM_NOTIF_PUTINPROGRESS | Poner el aviso en proceso. Receta generada a partir de la firma de BAPI_ALM_NOTIF_PUTINPROGRESS en SAP. |
| Aplazar el aviso | Entrega | BAPI_ALM_NOTIF_POSTPONE | Aplazar el aviso. Receta generada a partir de la firma de BAPI_ALM_NOTIF_POSTPONE en SAP. |
| Concluir tarea del aviso | Entrega | BAPI_ALM_NOTIF_TASK_COMPLETE | Concluir tarea del aviso. Receta generada a partir de la firma de BAPI_ALM_NOTIF_TASK_COMPLETE en SAP. |
Activos
| Receta | Dirección | Función SAP | Resuelve |
|---|---|---|---|
| Equipo ·esencial | Recolección | BAPI_EQUI_GETDETAIL | Datos maestros del activo — lo que el MES refleja para vincular línea, máquina y orden. |
| Ubicación técnica ·esencial | Recolección | BAPI_FUNCLOC_GETDETAIL | Posición del activo en la jerarquía técnica de la planta — para agrupar indicadores por área o línea. |
| Punto de medición ·esencial | Recolección | MEASUREM_POINT_RFC_SINGLE_002 | Datos del punto de medición: magnitud, unidad y límites. Lo que el SCADA necesita para registrar la lectura correcta. |
| Lista de equipos | Recolección | BAPI_EQUI_GETLIST | Lista de equipos. Receta generada a partir de la firma de BAPI_EQUI_GETLIST en SAP. |
| Lista de ubicaciones técnicas | Recolección | BAPI_FUNCLOC_GETLIST | Lista de ubicaciones técnicas. Receta generada a partir de la firma de BAPI_FUNCLOC_GETLIST en SAP. |
| Instalar equipo | Entrega | BAPI_EQUI_INSTALL | Instalar equipo. Receta generada a partir de la firma de BAPI_EQUI_INSTALL en SAP. |
| Desmontar equipo | Entrega | BAPI_EQUI_DISMANTLE | Desmontar equipo. Receta generada a partir de la firma de BAPI_EQUI_DISMANTLE en SAP. |
| Modificar equipo | Entrega | BAPI_EQUI_CHANGE | Modificar equipo. Receta generada a partir de la firma de BAPI_EQUI_CHANGE en SAP. |
Punto de medición
| Receta | Dirección | Función SAP | Resuelve |
|---|---|---|---|
| Registrar medición vía integración MES de EAM ·esencial | Entrega | EAM_MES_CREATE_MEASUREM_DOCUM | Una lectura de contador o sensor se convierte en documento de medición en SAP. Junto con una recolección OPC UA, Modbus o PI, alimenta el mantenimiento preventivo sin código. |
| Registrar medición por punto de medición ·esencial | Entrega | MEASUREM_DOCUM_RFC_SINGLE_001 | Alternativa cuando el MES conoce el número del punto de medición en vez del equipo. También puede crear aviso automático al superar el límite. |
| Lista de entrada de mediciones | Recolección | MEASUREM_ENTRYLIST_READ_DB | Lista de entrada de mediciones. Receta generada a partir de la firma de MEASUREM_ENTRYLIST_READ_DB en SAP. |
| Registrar documento de medición — variante | Entrega | MEASUREM_DOCUM_RFC_SINGLE_002 | Registrar documento de medición — variante. Receta generada a partir de la firma de MEASUREM_DOCUM_RFC_SINGLE_002 en SAP. |
| Anular documento de medición | Entrega | MEASUREM_DOCUM_RFC_CANCEL | Anular documento de medición. Receta generada a partir de la firma de MEASUREM_DOCUM_RFC_CANCEL en SAP. |
Contratos de campo
Detalle de la orden de mantenimiento
PREFIXO_PM_ORDEM_DETALHE — Su sistema informa estos campos al llamar la URL de la recolección.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
ordem | sí | NUMBER |
Cartera de órdenes de mantenimiento
PREFIXO_PM_ORDEM_LISTA — Su sistema informa estos campos al llamar la URL de la recolección.
Necesita revisión antes de activar. Creada inactiva con un rango de selección de ejemplo en IT_RANGES. Ajuste campo y valor antes de activarla.
Sin campos de entrada: la receta corre por el planificador, con los valores fijados en los parámetros del pack.
Detalle del aviso de mantenimiento
PREFIXO_PM_NOTIF_DETALHE — Su sistema informa estos campos al llamar la URL de la recolección.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
notificacao | sí | NUMBER |
Equipo
PREFIXO_PM_EQUIPAMENTO — Su sistema informa estos campos al llamar la URL de la recolección.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
equipamento | sí | EQUIPMENT |
Ubicación técnica
PREFIXO_PM_LOCAL_INSTALACAO — Su sistema informa estos campos al llamar la URL de la recolección.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
localInstalacao | sí | FUNCTLOCATION |
Punto de medición
PREFIXO_PM_PONTO_MEDICAO — Su sistema informa estos campos al llamar la URL de la recolección.
Necesita revisión antes de activar. Módulo clásico, no BAPI: sin prefijo BAPI_ y lectura en modo consulta. No existe BAPI_MEASUREMENTPOINT_* en este release.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
pontoMedicao | sí | MEASUREMENT_POINT |
Crear aviso de mantenimiento
PREFIXO_PM_NOTIF_ABRIR — Su sistema envía estos campos en el cuerpo del mensaje.
Necesita revisión antes de activar. Crea Y graba el aviso en una sola llamada: BAPI_ALM_NOTIF_CREATE y, en la misma sesión, BAPI_ALM_NOTIF_SAVE (en “Llamar a continuación”), con commit. El número definitivo viene en BAPI_ALM_NOTIF_SAVE.NOTIFHEADER.NOTIF_NO — el de NOTIFHEADER_EXPORT es temporal (%00000000001).
| Campo | Obligatorio | Campo SAP |
|---|---|---|
descricao | sí | NOTIFHEADER.SHORT_TEXT |
equipamento | — | NOTIFHEADER.EQUIPMENT |
localInstalacao | — | NOTIFHEADER.FUNCT_LOC |
prioridade | — | NOTIFHEADER.PRIORITY |
dataInicioDesejada | — | NOTIFHEADER.DESSTDATE |
Grabar aviso de mantenimiento
PREFIXO_PM_NOTIF_GRAVAR — Su sistema envía estos campos en el cuerpo del mensaje.
Necesita revisión antes de activar. Solo graba un aviso que todavía está en la memoria de la MISMA sesión RFC — como cada mensaje del CMS abre su propia conexión, esta Entrega sola no graba el aviso creado por “Abrir aviso”. Use “Abrir aviso”, que ya crea y graba en la misma llamada.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
notificacao | sí | NUMBER |
Cerrar aviso de mantenimiento
PREFIXO_PM_NOTIF_ENCERRAR — Su sistema envía estos campos en el cuerpo del mensaje.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
notificacao | sí | NUMBER |
dataEncerramento | — | SYSTSTAT.REFDATE |
horaEncerramento | — | SYSTSTAT.REFTIME |
Registrar medición vía integración MES de EAM
PREFIXO_PM_MEDICAO_EAM — Su sistema envía estos campos en el cuerpo del mensaje.
Necesita revisión antes de activar. La interfaz nace con paquete de 50 mensajes y alerta en 2000: la medición suele ser el mayor volumen del pack.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
equipamento | sí | IV_EQUIPMENT |
valor | sí | IV_RECORDED_VALUE |
dataLeitura | — | IV_READING_DATE |
horaLeitura | — | IV_READING_TIME |
responsavel | — | IV_READER |
leituraDiferencial | — | IV_DIFFERENCE_READING |
Registrar medición por punto de medición
PREFIXO_PM_MEDICAO_PONTO — Su sistema envía estos campos en el cuerpo del mensaje.
Necesita revisión antes de activar. Módulo clásico, no BAPI: hace el commit por sí mismo con COMMIT_WORK=‘X’, por eso es la única entrega con “commit tras llamada” desactivado.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
pontoMedicao | sí | MEASUREMENT_POINT |
valor | sí | RECORDED_VALUE |
unidade | — | RECORDED_UNIT |
dataLeitura | — | READING_DATE |
horaLeitura | — | READING_TIME |
responsavel | — | READER |
observacao | — | SHORT_TEXT |
leituraDiferencial | — | DIFFERENCE_READING |
Notificación de tiempo de orden PM
PREFIXO_PM_CONF_TEMPO — Su sistema envía estos campos en el cuerpo del mensaje.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
ordem | sí | TIMETICKETS.ORDERID |
operacao | sí | TIMETICKETS.OPERATION |
trabalhoRealizado | sí | TIMETICKETS.ACT_WORK |
unidadeTrabalho | sí | TIMETICKETS.UN_WORK |
apontamentoFinal | — | TIMETICKETS.FIN_CONF |
dataLancamento | — | TIMETICKETS.POSTG_DATE |
observacao | — | TIMETICKETS.CONF_TEXT |
Avisos de un equipo
PREFIXO_PM_ALM_NOTIF_LIST_EQUI — Su sistema informa estos campos al llamar la URL de la recolección.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
equipamento | sí | EQUIPMENT |
Avisos de una ubicación técnica
PREFIXO_PM_ALM_NOTIF_LIST_FUNCLOC — Su sistema informa estos campos al llamar la URL de la recolección.
Sin campos de entrada: la receta corre por el planificador, con los valores fijados en los parámetros del pack.
Lista de equipos
PREFIXO_PM_EQUI_GETLIST — Su sistema informa estos campos al llamar la URL de la recolección.
Sin campos de entrada: la receta corre por el planificador, con los valores fijados en los parámetros del pack.
Lista de ubicaciones técnicas
PREFIXO_PM_FUNCLOC_GETLIST — Su sistema informa estos campos al llamar la URL de la recolección.
Sin campos de entrada: la receta corre por el planificador, con los valores fijados en los parámetros del pack.
Lista de entrada de mediciones
PREFIXO_PM_ENTRYLIST_READ_DB — Su sistema informa estos campos al llamar la URL de la recolección.
Sin campos de entrada: la receta corre por el planificador, con los valores fijados en los parámetros del pack.
Distribuir orden PM al MES
PREFIXO_PM_MES_DISTRIBUTE_PMORD — Su sistema informa estos campos al llamar la URL de la recolección.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
itOrders | sí | IT_ORDERS |
Notificaciones PM
PREFIXO_PM_ALM_CONF_GETLIST — Su sistema informa estos campos al llamar la URL de la recolección.
Sin campos de entrada: la receta corre por el planificador, con los valores fijados en los parámetros del pack.
Detalle de la notificación PM
PREFIXO_PM_ALM_CONF_GETDETAIL — Su sistema informa estos campos al llamar la URL de la recolección.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
numeroConfirmacao | sí | CONFIRMATION |
contadorConfirmacao | sí | CONFIRMATIONCOUNTER |
Complementar el aviso
PREFIXO_PM_ALM_NOTIF_DATA_ADD — Su sistema envía estos campos en el cuerpo del mensaje.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
numero | sí | NUMBER |
Modificar datos del aviso
PREFIXO_PM_ALM_NOTIF_DATA_MODIFY — Su sistema envía estos campos en el cuerpo del mensaje.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
numero | sí | NUMBER |
Poner el aviso en proceso
PREFIXO_PM_ALM_NOTIF_PUTINPROGRESS — Su sistema envía estos campos en el cuerpo del mensaje.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
numero | sí | NUMBER |
Aplazar el aviso
PREFIXO_PM_ALM_NOTIF_POSTPONE — Su sistema envía estos campos en el cuerpo del mensaje.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
numero | sí | NUMBER |
Concluir tarea del aviso
PREFIXO_PM_ALM_NOTIF_TASK_COMPLETE — Su sistema envía estos campos en el cuerpo del mensaje.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
numero | sí | NUMBER |
taskKey | sí | TASK_KEY |
Registrar documento de medición — variante
PREFIXO_PM_DOCUM_RFC_SINGLE_002 — Su sistema envía estos campos en el cuerpo del mensaje.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
measurementDocument | sí | MEASUREMENT_DOCUMENT |
Anular documento de medición
PREFIXO_PM_DOCUM_RFC_CANCEL — Su sistema envía estos campos en el cuerpo del mensaje.
Necesita revisión antes de activar. Creada INACTIVA: el pack no puede adivinar el contenido — preencher a tabela IT_CANCEL_REQUESTS. Abra la definición, use el popup “Parámetros Función SAP” para completarla y actívela.
Sin campos de entrada: la receta corre por el planificador, con los valores fijados en los parámetros del pack.
Anular notificación
PREFIXO_PM_ALM_CONF_CANCEL — Su sistema envía estos campos en el cuerpo del mensaje.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
numeroConfirmacao | sí | CONFIRMATION |
contadorConfirmacao | sí | CONFIRMATIONCOUNTER |
Instalar equipo
PREFIXO_PM_EQUI_INSTALL — Su sistema envía estos campos en el cuerpo del mensaje.
Necesita revisión antes de activar. Creada INACTIVA: el pack no puede adivinar el contenido — preencher a estrutura DATA_INSTALL. Abra la definición, use el popup “Parámetros Función SAP” para completarla y actívela.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
equipamento | sí | EQUIPMENT |
Desmontar equipo
PREFIXO_PM_EQUI_DISMANTLE — Su sistema envía estos campos en el cuerpo del mensaje.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
equipamento | sí | EQUIPMENT |
Modificar equipo
PREFIXO_PM_EQUI_CHANGE — Su sistema envía estos campos en el cuerpo del mensaje.
Necesita revisión antes de activar. Creada INACTIVA: el pack no puede adivinar el contenido — preencher a estrutura DATA_GENERAL; preencher a estrutura DATA_GENERALX; preencher a estrutura DATA_SPECIFIC; preencher a estrutura DATA_SPECIFICX. Abra la definición, use el popup “Parámetros Función SAP” para completarla y actívela.
| Campo | Obligatorio | Campo SAP |
|---|---|---|
equipamento | sí | EQUIPMENT |