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 del usuario como también acceso para el servidor web y para los servicios web.

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 Editor de métodos, 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 de 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.

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 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 Propietario controla que grupo puede editar 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.

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.

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.

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 "Ofrecido como 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 . 

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.

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 “Disponible vía 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 “Disponible vía SQL”.

Para mayor información, consulte Implementaciones del motor SQL de 4D en el manual SQL de 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 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 obtener más información sobre esta opción, consulte Configuración de la base de datos 4D en el manual 4D Mobile.

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.