Propiedades de los métodos proyecto

Después de crear un método de proyecto, puede renombrarlo y modificar sus propiedades. Las propiedades de los métodos de proyecto definen principalmente las condiciones de acceso y de seguridad (acceso de los usuarios, los servidores integrados o los servicios) así como su modo de ejecución.

Los otros tipos de métodos no tienen propiedades específicas. Sus propiedades están relacionadas a los objetos a los que están asociados.

Para modificar las propiedades de un método proyecto:

1. En el WA SET URL FILTERS, seleccione el comando Propiedades del método... en el menú Método.
   O
   En la Página Métodos del Explorador, haga clic derecho en el método proyecto y seleccione Propiedades del método... en el menú contextual o en el menú de opciones.
   Aparece la caja de diálogo Propiedades del método.
   

Nota: la función de modificación global permite modificar un atributo para un conjunto de métodos (ver Cambio global de atributos de métodos).

Puede cambiar el nombre de un método de proyecto en el área "Nombre" de la ventana de propiedades de los métodos o desde el Explorador.

El nuevo nombre debe respetar las reglas de nombres de 4D (ver Convenciones en el manual Lenguaje de 4D). Si ya existe un método con el mismo nombre, 4D muestra un mensaje que indica que nombre del método ya ha sido utilizado. Si es necesario, 4D ordena nuevamente la lista de métodos. 

Atención: cambiar el nombre de un método ya utilizado en la base puede invalidar los métodos y fórmulas que utilizan el antiguo nombre y se corre el riesgo de afectar el funcionamiento de la aplicación. Puede renombrar el método manualmente pero se recomienda utilizar la función para renombrar los métodos proyecto, descrita en la sección Renombrar. Con esta función, puede actualizar automáticamente el nombre donde se llame el método en el modo Diseño.

Con 4D Server, el nombre del método se cambia en el servidor cuando se termina de editar el nombre. Si más de un usuario está modificando el nombre del método al mismo tiempo, el nombre final del método será el nombre especificado por el último usuario al terminar de editar el nombre. Es recomendable definir un propietario para el método de manera que sólo ciertos usuarios puedan cambiar el nombre del método.

Nota: los métodos de base de datos no pueden renombrarse, lo mismo sucede con los triggers, métodos de formulario y métodos de objeto, los cuales están atados a objetos y toman sus nombres del objeto relacionado.

Los atributos permiten controlar la utilización y las llamadas del método proyecto en diferentes contextos. Note que los atributos pueden definirse globalmente para una selección de métodos proyecto utilizando el Explorador (ver la siguiente sección).

Si no quiere que los usuarios puedan ejecutar un método de proyecto utilizando el comando Método... del menú Ejecutar, puede volver el método Invisible en la caja de diálogo Propiedades del método. Un método invisible no aparece en la caja de diálogo de ejecución de métodos. (ver el párrafo Desde la caja de diálogo de ejecución de métodos). 

Un método de proyecto invisible sigue estando disponible para los programadores de la base de datos, permanece listado en la Current form table del Explorador y en la lista de rutinas del editor de métodos.

Este atributo se utiliza en caso de uso de componentes. Cuando se selecciona, indica que el método estará disponible para los componentes si la aplicación se utiliza como base principal. Por el contrario, cuando la aplicación se utiliza como componente, el método estará disponible para la base principal.

Para mayor información sobre componentes, consulte el capítulo Desarrollar e instalar componentes 4D.

Este atributo sólo se tiene en cuenta para una aplicación 4D en modo cliente/servidor. Cuando esta opción está seleccionada, el método de proyecto siempre se ejecuta en el servidor, sin importar cómo se llame.

Para mayor información sobre esta opción, consulte la sección Atributo Ejecutar en servidor en el manual de 4D Server.

Esta opción le permite declarar el método elegible para ejecución en modo apropiativo. Por defecto, 4D ejecuta todos los métodos de proyecto de sus aplicaciones en modo cooperativo. Si desea beneficiarse de la función de modo apropiativo, debe declarar explícitamente todos los métodos que se desea que se inicien en modo apropiativo. El compilador a continuación, verificará que estos métodos son realmente hilo seguro.

Nota: la ejecución en modo apropiativo sólo está disponible en versiones 4D de 64 bits en modo compilado. Para más información, consulte la sección Procesos 4D apropiativos.

Están disponibles las siguientes opciones:

• Puede ejecutarse en un proceso apropiativo: al seleccionar esta opción, declara que el método es capaz de ejecutarse en un proceso apropiativo y por lo tanto se debe ejecutar en modo apropiativo cuando sea posible. La propiedad "apropiativa" del método se activa.
  Cuando se selecciona esta opción, el compilador 4D verificará que el método esté realmente activo y devolverá error si no es el caso, por ejemplo, si directa o indirectamente llama a comandos o métodos que no se pueden ejecutar en modo apropiativo (toda la cadena de llamadas se analiza, pero sólo los errores son reportados al primer subnivel). Luego, puede editar el método para que sea hilo seguro o seleccionar otra opción.
  Si la elegibilidad del método al modo apropiativo es aprobada, se etiqueta "hilo-seguro" internamente y se ejecutará en el modo apropiativo siempre que se cumplan las condiciones requeridas. Esta propiedad define su elegibilidad para el modo apropiativo, pero no garantiza que el método realmente se puede ejecutar en modo apropiativo, ya que este modo de ejecución requiere un contexto específico (ver ¿Cuando un proceso se inicia apropiativamente?).

• No se puede ejecutar en un proceso apropiativo: seleccionando esta opción, se declara que el método no debe ejecutarse en modo apropiativo, y por lo tanto siempre se debe ejecutar en modo cooperativo, al igual que en las versiones anteriores de 4D. La propiedad "apropiativa" del método se activa.
  Cuando se selecciona esta opción, el compilador 4D no verificará la capacidad del método para ejecutarse de forma apropiativa; se marca de forma automática "hilo-inseguro" internamente (incluso si es teóricamente compatible). Cuando se llama en ejecución, este método "contamina" cualquier otro método en el mismo hilo, lo que obliga a este hilo a ser ejecutado en modo cooperativo, incluso si los otros métodos son hilo seguro.

• Indiferente (por defecto): al seleccionar esta opción, usted declara que no desea manejar la propiedad apropiativa para el método. La propiedad "apropiativa" del método se establece como "indiferente".
  Cuando se selecciona esta opción, el compilador 4D evaluará la capacidad apropiativa del método y la etiquetará internamente como "hilo seguro " o "hilo inseguro". No se devuelve ningún error relacionado con la ejecución apropiativa. Si se evalúa el método como hilo seguro, la ejecución no impedirá la utilización del modo apropiatvo si se llama en un contexto apropiativo. Por el contrario, si el método se evalúa "hilo inseguro", durante la ejecución se evitará cualquier utilización del modo apropiativo cuando se le llame.
  Tenga en cuenta que con esta opción, cualquiera que sea la evaluación interna de seguridad de hilo, siempre se ejecutará el método en modo cooperativo cuando sea llamado directamente por 4D como el primer método array (por ejemplo a través del comando New process). Si se ha etiquetado como "hilo seguro" internamente, sólo se tendrá en cuenta cuando se llama desde otros métodos dentro de una cadena de llamadas.

La disponibilidad de los atributos especifica los servicios externos que están autorizados a llamar explícitamente al método.

Este atributo le permite publicar el método actual como un servicio web vía una solicitud SOAP. Para mayor información, consulte el capítulo Publicación y uso de servicios web. Cuando esta opción está seleccionada, la opción Publicado en WSDL está activa.

En el Explorador, los métodos de proyecto ofrecidos como servicio web tienen un icono específico: .

Nota: no es posible publicar un método como servicio web si su nombre incluye caracteres que no cumplen con la nomenclatura XML (por ejemplo los espacios). Si el nombre del método no cumple con la nomenclatura, 4D no asigna la propiedad.

Este atributo está activo únicamente si el atributo "Servicio Web" está seleccionado. Permite incluir el método actual en el archivo WSDL de la aplicación 4D. Para mayor información, consulte el párrafo Generación de WSDL. 

En el Explorador, los métodos de proyecto que se ofrecen como un servicio web y publicados en WSDL tienen un icono específico . 

Esta opción permite reforzar la seguridad del servidor web de 4D: cuando no está seleccionada, el método de proyecto no puede ejecutarse vía una petición HTTP que contenga el URL especial 4DACTION de llamada de métodos (así como el antiguo URL 4DMETHOD) ni las etiquetas especiales 4DSCRIPT, 4DTEXT y 4DHTML (como también las antiguas etiquetas 4DVAR y 4DHTMLVAR).

Para mayor información, consulte URLs y acciones de formularios y Etiquetas HTML 4D en el manual Lenguaje 4D.

En el Explorador, los métodos proyecto con este atributo tienen un ícono específico .

Por razones de seguridad, esta opción no está seleccionada por defecto. Debe indicar individualmente los métodos que pueden ejecutarse vía los URLs y las etiquetas especiales.

Cuando esta opción está seleccionada,  autoriza al motor SQL de 4D ejecutar el método de proyecto. Por defecto, esta opción no está seleccionada, lo cual significa que, a menos de que se autorice explícitamente, los métodos de proyecto 4D están protegidos y no pueden ser llamados por el motor SQL de 4D.

Esta propiedad aplica a todas las búsquedas SQL internas y externas, ejecutadas vía el driver ODBC, el código SQL insertado entre las etiquetas Begin SQL/End SQL o el comando QUERY BY SQL .

Notas:

• Incluso si un método tiene el atributo “SQL”, los accesos definidos a nivel de las Preferencias y propiedades del método se tienen en cuenta para la ejecución del método.
• La función ODBC SQLProcedure devuelve únicamente los métodos de proyecto que tienen el atributo “SQL”.

Para mayor información, consulte Implementaciones del motor SQL de 4D en el manual SQL de 4D.

Esta opción configura la disponibilidad y el alcance de la acción para el método como parte de un enlace 4D Mobile con un servidor Wakanda.

Para más información sobre esta opción, consulte Configuración de la base de datos 4D en el manual 4D Mobile.

Puede controlar el acceso a los métodos definiendo los privilegios de acceso y propietario para grupos de usuarios. Un solo grupo puede ser asignado para cada privilegio utilizando la lista desplegable de Acceso y Propietario de la caja de diálogo Propiedades del método. Para mayor información acerca de la creación de un sistema de contraseñas de acceso con usuarios y grupos, consulte la sección Usuarios y grupos.

• La lista desplegable "Grupo de acceso" define el grupo que puede ejecutar el método. Si un usuario que no está en este grupo intenta ejecutar el método, 4D muestra un mensaje indicándole que sus privilegios de acceso no le permiten ejecutar el método.
• La lista desplegable "Grupo propietario" define el grupo puede modificar el método en el entorno Diseño. Si un usuario que no está en el grupo intenta editar el método en el entorno Diseño, 4D muestra un mensaje indicando que el usuario no tiene el privilegio de acceso para editar el método.

Los usuarios que aparecen en ambos grupos pueden utilizar o modificar el formulario sin restricción.

La caja de diálogo "Atributos de los métodos", permite modificar un atributo de método proyecto (Invisible, Ofrecido como servicio web, etc.) para la totalidad o parte de los métodos de la base en una sola operación. Esta función es muy útil para modificar los atributos de un gran número de métodos proyecto. También puede utilizarse durante el desarrollo para aplicar rápidamente atributos comunes a grupos similares de métodos.

Para modificar globalmente los atributos de métodos:

1. En la Página Métodos del Explorador 4D, despliegue el menú de opciones y seleccione el comando Cambio global de atributos...
   
   Aparece la caja de diálogo “Atributos de métodos”:
   
2. En el área “Nombre de método(s) a cambiar:”, introduzca una cadena de caracteres que le permita designar los métodos que quiere modificar globalmente.
   La cadena de caracteres se utiliza como criterio de búsqueda de los nombres de métodos.
   Utilice el carácter arroba @ para ayudar a definir los grupos de métodos:
   
   • para designar los métodos cuyos nombres comiencen por..., digite @ al final de la cadena. Por ejemplo: web@.
   • para designar los métodos cuyos nombres contienen..., digite @ en medio de la cadena. Por ejemplo: web@write.
   • para designar los métodos cuyos nombres terminan en..., digite @ al inicio de la cadena. Por ejemplo: @write.
   • para designar todos los métodos, digite @ en el área.
     Notas:
     
     • La búsqueda no tiene en cuenta mayúsculas/minúsculas.
     • Puede introducir varios caracteres @ en la cadena, por ejemplo dtro_@web@pro.@
3. En el área “Atributo a cambiar”, elija un atributo de la lista desplegable, luego haga clic en el botón de radio Verdadero o Falso correspondiente al valor aplicado.
   Nota: si el atributo “Publicado en WSDL” es definido como Verdadero, sólo se aplicará a los métodos de proyecto que contengan el atributo “Ofrecido como Servicio web”.
4. Haga clic en Aplicar.
   La modificación se aplica instantáneamente a todos los métodos de proyecto asignados por la cadena de caracteres introducida.