Método: Actualización de grafo 

Con la interfase BAPI Maintain (actualizar) del business object Network, puede tratar grafos, operaciones de grafo y relaciones de ordenación. La BAPI contiene una operación completa por sí misma. Por lo tanto, se pueden tratar varios objetos de grafo mediante una sola llamada. El Sistema de proyectos del Sistema R/3 especifica el orden en el que deben ejecutarse los comandos en los objetos. El usuario que efectúa la llamada puede seleccionar las operaciones en cualquier orden.

En consecuencia, el tratamiento es muy rápido y efectivo. No obstante, este concepto de operación no incluye la utilización y combinación de otras interfases BAPI de Sap en la misma LUW.

Procedimiento

El business object Network supone una fachada para los grafos, sus actividades y relaciones de ordenación.

Si desea tratar un objeto de grafo, introduzca una operación para un tipo de objeto. Además, introduzca la clave de objeto y una referencia para sus atributos.

En la tabla del parámetro IMethodProject , introduzca el tipo de objeto, el comando y la clave de objeto. Como referencia, introduzca el índice de la tabla de datos de objeto correspondiente al tipo de objeto. En la tabla de datos de objeto, introduzca la información sobre el objeto.

Si es necesario, utilice una estructura de actualización para el objeto. Si se introduce Objecttype y Method en la tabla IMethodProject , recuerde que las entradas tienen en cuenta las mayúsculas y minúsculas.

Para finalizar la operación y guardar los datos en la base de datos del Sistema R/3, introduzca el comando Save . Si sólo desea probar si las modificaciones se pueden llevar a cabo, no utilice el comando Save .

Por lo general, no se pueden modificar las claves de los objetos.

El parámetro de retorno Return indica si se han producido errores durante el tratamiento. Después de la llamada, aparecen los mensajes de error creados durante el tratamiento en la tabla EmessageTable .

Para obtener más información, véase la documentación para el módulo de funciones ABAP BAPI_NETWORK_MAINTAIN .

Comandos de los tipos de objeto

Grafo de tipo de objeto

El número de grafo es la clave que identifica cada tipo de objeto de grafo.

Comando: Create

Se crea un grafo utilizando el número de grafo especificado. El sistema externo determina el número de grafo. Para el grafo, introduzca un perfil de grafo que exista en el Sistema de proyectos R/3. El perfil de grafo tiene que ser asignado a un tipo de grafo con asignación de números externa.

Introduzca siempre el número de grafo en letra mayúscula.

Según la clase de programación, introduzca una fecha inicio o una fecha final.

Creación de un grafo con el número de grafo TRAINING0001 . Introduzca la clave del objeto de grafo en la tabla de operación con OBJECTKEY y en la tabla de datos con NETWORK . El número de referencia "000001" de la tabla de operación IMethodProject hace referencia al índice de la tabla de datos.

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

Network

Create

TRAINING0001

000001

 

Save

 		   

 

INetwork

Index

NETWORK

SHORT_TEXT

FINISH_DATE

PROFILE

...

1

TRAINING0001

New network

04.12.1999

EPS40_1

...

 

Comando: Update

Se modifica un grafo que existe en el Sistema de proyectos R/3.

Utilización del esquema de actualización

Si desea modificar únicamente determinados valores en un grafo existente y mantener los otros valores. Mediante la estructura de actualización, se pueden especificar los atributos que desea modificar exactamente. Por lo tanto, no es necesario rellenar todos los atributos de la estructura de grafo.

Si está trabajando con las estructuras de actualización, preste atención al hecho de que se debe completar también la tabla de la estructura de actualización para los otros comandos del grafo. El número de referencia de la tabla de comandos tiene que corresponder al mismo índice de la tabla de grafo y a la tabla que contiene las estructuras de actualización.

Modificación de la descripción del grafo TRAINING0001 existente.

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

Network

Update

TRAINING0001

000001

 

Save

    

INetwork

Index

NETWORK

SHORT_TEXT

FINISH_DATE

PROFILE

...

1

TRAINING0001

description changed

    

...

INetworkUpdate

Index

NETWORK

SHORT_TEXT

FINISH_DATE

PROFILE

...

1

 

X

 

 

...

 

Comando: Delete (a partir del release 4.5A)

Se elimina un grafo que ya existe en el Sistema de proyectos del Sistema R/3. El grafo tiene el status del sistema Petición borrado que se puede revocar en el Sistema de proyectos R/3. De este modo, el grafo permanece físicamente en la base de datos.

Cómo borrar el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

Network

Delete

TRAINING0001

000001

 

Save

 

 

INetwork

Index

NETWORK

...

1

TRAINING0001

...

 

Comando: Schedule

Programación de un grafo.

El grafo TRAINING0001 se vuelve a programar.

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

Network

Schedule

TRAINING0001

000001

 

Save

 

 

INetwork

Index

NETWORK

SHORT_TEXT

FINISH_DATE

PROFILE

...

1

TRAINING0001

 

 

 

...

 

Comando: Calculate

Cálculo de costes para un grafo.

Cálculo de costes para el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

Network

Calculate

TRAINING0001

000001

 

Save

 

 

INetwork

Index

NETWORK

SHORT_TEXT

FINISH_DATE

PROFILE

...

1

TRAINING0001

 

 

 

...

 

Comando: Release (a partir del release 4.5A)

Liberación de un grafo con todas sus actividades.

Liberación del grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

Network

Release

TRAINING0001

000001

 

Save

 

 

INetwork

Index

NETWORK

SHORT_TEXT

FINISH_DATE

PROFILE

...

1

TRAINING0001

 

 

 

...

 

Comando: Lock (a partir del release 4.6A)

Cómo bloquear un grafo

Se fija el status del sistema "bloqueado" para el grafo.

 

Bloqueo del grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

Network

Lock

TRAINING0001

000001

 

Save

    

INetwork

Index

NETWORK

SHORT_TEXT

FINISH_DATE

PROFILE

...

1

TRAINING0001

      

...

 

Comando: Unlock (a partir del release 4.6A)

Desbloqueo de un grafo

Se elimina el status del sistema "bloqueado" para el grafo.

 

Desbloqueo del grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

Network

Unlock

TRAINING0001

000001

 

Save

    

INetwork

Index

NETWORK

SHORT_TEXT

FINISH_DATE

PROFILE

...

1

TRAINING0001

      

...

 

Tipo de objeto NetworkActivity

La clave del objeto operación de grafo está compuesta por el número de grafo y el número de operación.

Si desea aplicar un comando a la operación de grafo, debe incluir siempre el grafo superior en la misma llamada en la tabla del parámetro INetwork .

Comando: Crear

Creación de una nueva actividad en un grafo.

Creación de una nueva operación de grafo con el número 0010 en el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

NetworkActivity

Create

TRAINING00010010

000001

 

Save

 

 

IActivity

Index

NETWORK

ACTIVITY

DESCRIPTION

...

1

TRAINING0001

0010

Activity 10

...

INetwork

Index

NETWORK

...

1

TRAINING0001

...

 

Comando: Update

Modificación de una operación que existe ya en el Sistema de proyectos R/3.

Utilice la estructura de actualización correspondiente al grafo.

Modificación de la descripción de la operación 0010 en el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

NetworkActivity

Update

TRAINING00010010

000001

 

Save

 

 

IActivity

Index

NETWORK

ACTIVITY

DESCRIPTION

...

1

TRAINING0001

0010

Activity 10 changed

...

IActivityUpdate

Index

NETWORK

ACTIVITY

DESCRIPTION

...

1

 

 

X

...

INetwork

Index

NETWORK

...

1

TRAINING0001

...

 

Comando: Delete

Borrado de una operación que existe ya en el Sistema de proyectos R/3. La operación obtiene el status del sistema petición borrado y no se borra físicamente. Los objetos conectados como las relaciones de ordenación, las operaciones subordinadas, las necesidades de capacidad, las solicitudes de pedido y los componentes de material también se deseleccionan o se seleccionan para el borrado.

No se puede crear una nueva operación con la misma clave.

Modificación de la descripción de la operación 0010 en el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

NetworkActivity

Delete

TRAINING00010010

000001

 

Save

 

 

IActivity

Index

NETWORK

ACTIVITY

DESCRIPTION

...

1

TRAINING0001

0010

 

...

INetwork

Index

NETWORK

...

1

TRAINING0001

...

 

Comando: Release (a partir del release 4.5A)

Liberación de una operación de grafo.

Liberación de la operación 0010 en el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

NetworkActivity

Release

TRAINING00010010

000001

 

Save

 

 

IActivity

Index

NETWORK

ACTIVITY

DESCRIPTION

...

1

TRAINING0001

0010

 

...

INetwork

Index

NETWORK

...

1

TRAINING0001

...

 

Tipo de objeto: NetworkActivityElement (a partir del release 4.6A)

La clave del objeto operación subordinada comprende el número de grafo, el número de operación y el número de operación subordinada.

Comando: Create

Creación de una nueva operación subordinada en un grafo.

 

Creación de una nueva operación subordinada con el número 0020 para la operación 0010 en el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

NetworkActivityElement

Create

TRAINING000100100020

000001

 

Save

    

IActivityElement

Index

NETWORK

ACTIVITY

ELEMENT

...

1

TRAINING0001

0010

0020

...

 

Comando: Update

Modificación de una operación subordinada que ya existe en el Sistema de proyectos R/3.

Utilice la estructura de actualización correspondiente al grafo.

 

Modificación de una operación subordinada existente con el número 0020 para la operación 0010 en el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

NetworkActivityElement

Update

TRAINING000100100020

000001

 

Save

    

IActivityElement

Index

NETWORK

ACTIVITY

ELEMENT

DESCRIPTION

...

1

TRAINING0001

0010

0020

Activity element 20 changed

...

IActivityElementUpdate

Index

NETWORK

ACTIVITY

ELEMENT

DESCRIPTION

...

1

    

0020

X

...

 

Comando: Delete

Borrado de una operación subordinada que ya existe en el Sistema de proyectos R/3. La operación subordinada obtiene el status del sistema petición borrado y no se borra físicamente. Asimismo, se elimina la asignación de los objetos vinculados, como las necesidades de capacidad y las solicitudes de pedido, o bien se marcan para borrado.

No se puede crear una nueva operación subordinada con la misma clave.

 

Eliminación de una operación subordinada existente con el número 0020 para la operación 0010 en el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

NetworkActivityElement

Delete

TRAINING000100100020

000001

 

Save

    

IActivityElement

Index

NETWORK

ACTIVITY

ELEMENT

...

1

TRAINING0001

0010

0020

...

 

Tipo de objeto: ActivityMilestone (a partir del release 4.6A)

La clave para el objeto hito de operación es el número de hito.

Comando: Create

Creación de un nuevo hito de operación en un grafo. No es necesario introducir un número para el hito. Si se ha creado el hito, el sistema devuelve el número de hito como mensaje informativo en la tabla de mensajes.

Si embargo, si al crearlo, se ha introducido un número externo en la tabla de método, el número externo y el nuevo número de hito se devuelven como mensaje informativo en la tabla de mensajes.

 

Creación de un nuevo hito para la operación 0010 en el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

ActivityMilestone

Create

  

000001

 

Save

    

IActivityMilestone

Index

MILESTONE_NUMBER

NETWORK

ACTIVITY

...

1

  

TRAINING0001

0010

...

 

Comando: Update

Modificación de un hito de operación que ya existe en el Sistema de proyectos R/3. Siempre es necesario introducir un grafo, aún cuando no se modifique el grafo en cuestión.

Utilice la estructura de actualización correspondiente al grafo.

 

Modificación de un hito de operación existente con el número 000000002097 en el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

ActivityMilestone

Update

000000002097

000001

 

Save

    

IActivityMilestone

Índice

MILESTONE_NUMBER

DESCRIPTION

NETWORK

...

1

000000002097

modified milestone description

TRAINING0001

...

IActivityMilestoneUpdate

Index

MILESTONE_NUMBER

DESCRIPTION

NETWORK

...

1

  

X

  

...

 

Comando: Delete

Borrado de un hito de operación que ya existe en el Sistema de proyectos R/3. El hito de operación se borra físicamente. Siempre es necesario introducir un grafo, aún cuando no se modifique el grafo en cuestión.

 

Borrado del hito de operación con el número 000000002097 en el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

ActivityMilestone

Delete

000000002097

000001

 

Save

    

IActivityMilestone

Index

MILESTONE_NUMBER

NETWORK

...

1

000000002097

TRAINING0001

...

 

Tipo de objeto NetworkRelation

La clave del objeto relación de ordenación consta de la clase de relación de ordenación y de las claves de las operaciones anteriores y posteriores. Puede modificar la denominación de la clase de relación de ordenación en el Customizing (operación OPS2). En general, la denominación depende del idioma. Utilice únicamente clases válidas de relaciones de ordenación que estén disponibles en el idioma correspondiente.

Para aplicar un comando a la relación de ordenación, incluya siempre los grafos vinculados en la misma llamada de la tabla del parámetro INetwork.

Comando: Create

Creación de una relación de operación entre dos operaciones.

Creación de una nueva relación entre operaciones 0010 y 0020 en el grafo TRAINING0001 . La relación de ordenación es de carácter inicio-fin (FS).

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

NetworkRelation

Create

NFTRAINING00010010TRAINING00010020

000001

 

Save

 

 

IRelation

Index

NETWORK_ PREDECESSOR

ACTIVITY_ PREDECESSOR

NETWORK_ SUCCESSOR

ACTIVITY_ SUCCESSOR

RELATION_ TYPE

...

1

TRAINING0001

0010

TRAINING0001

0020

FS

...

INetwork

Index

NETWORK

...

1

TRAINING0001

...

 

Comando: Update

Se modifica una relación de ordenación que ya existe en el Sistema de proyectos R/3. No se puede modificar la clase de relación de ordenación, ya que forma parte de la clave de la relación de ordenación. Si desea modificar la clase de relación de ordenación, bórrela y cree una nueva.

Utilice la estructura de actualización correspondiente al grafo.

Comando: Delete

Borrado de una relación de ordenación que enlaza dos operaciones. La relación de ordenación se borra físicamente.

Borrado de la relación de ordenación entre las actividades 0010 y el 0020 en el grafo TRAINING0001 .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

NetworkRelation

Delete

FSTRAINING00010010TRAINING00010020

000001

 

Save

 

 

IRelation

Index

NETWORK_ PREDECESSOR

ACTIVITY_ PREDECESSOR

NETWORK_ SUCCESSOR

ACTIVITY_ SUCCESSOR

RELATION_ TYPE

...

1

TRAINING0001

0010

TRAINING0001

0020

FS

...

Grafo

Index

NETWORK

...

1

TRAINING0001

...

 

Ejemplo de la aplicación de varios comandos a objetos diferentes

Creación de dos grafos con operaciones y relaciones de ordenación. Una de las relaciones de ordenación enlaza los dos grafos y se programa uno de los grafos.

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

Network

Create

TRAINING0001

000001

Network

Create

TEST_NETWORK

000002

Network

Schedule

TRAINING0001

000001

NetworkActivity

Create

TRAINING00010010

000001

NetworkActivity

Create

TRAINING00010020

000002

NetworkActivity

Create

TEST_NETWORK1000

000003

NetworkRelation

Create

NFTRAINING00010010TRAINING00010020

000001

NetworkRelation

Create

NFTRAINING00010020 TEST_NETWORK1000

000002

 

Save

 

 

INetwork

Index

NETWORK

SHORT_TEXT

FINISH_DATE

PROFILE

...

1

TRAINING0001

Training Network

12/04/1999

EPS40_1

...

2

TEST_NETWORK

Test Network

12/09/1999

EPS40_1

...

IActivity

Index

NETWORK

ACTIVITY

DESCRIPTION

...

1

TRAINING0001

0010

Activity 10

...

2

TRAINING0001

0020

Activity 20

...

3

TEST_NETWORK

1000

Test Activity 1000

...

IRelation

Index

NETWORK_ PREDECESSOR

ACTIVITY_ PREDECESSOR

NETWORK_ SUCCESSOR

ACTIVITY_ SUCCESSOR

RELATION_ TYPE

...

1

TRAINING0001

0010

TRAINING0001

0020

FS

...

2

TRAINING0001

0020

TEST_NETWORK

1000

FS

 

 

Prueba de la interfase y visualización de la información de diagnóstico (a partir del release 4.5A)

A efectos de diagnóstico y de prueba, se pueden grabar en un fichero los datos que se han transferido al Sistema de proyectos R/3 mediante la interfase. Todas las entradas de los parámetros de tabla y de estructura se graban en este fichero trace. El usuario que efectúa la llamada puede utilizar el fichero trace para probar la interfase de los BAPI Actualizar.

La interfase SAPGUI guarda el fichero trace localmente. La creación de un fichero trace consume mucho tiempo. Por lo tanto, sólo se deberá crear un fichero trace con fines de prueba y nunca durante una ejecución de actualización.

El fichero trace se crea si introduce los comandos Method Create y Objectype Trace en la tabla IMethodProject. Introduzca el directorio y el nombre de fichero en la Clave de objeto. Deje en blanco la opción Refnumber.

Creación del fichero trace EPS_Test_Trace.txt en el directorio C:\TMP\ .

IMethodProject

OBJECTTYPE

METHOD

OBJECTKEY

REFNUMBER

Trace

Create

C:\TMP\EPS_Test_Trace.txt