PDF de programación - Manual del Generador C# - GeneXus 7.5

Manual del Generador C#

GeneXus 75

Febrero 2002



1



Características___________________________Error! Bookmark not defined.
Alcance del Generador ________________________________________________ 3
Objetos_____________________________________________________________ 3
Ambientes __________________________________________________________ 3
Requerimientos de Software _____________________________________ 3
Ambiente de Desarrollo________________________________________________ 3
Configuración de un modelo _____________________________________ 4
Preferences específicas __________________________________________ 7
Namespace__________________________________________________________ 7
Use .Net control______________________________________________________ 7
Generate developer menu makefile _______________________________________ 7
Compiler options _____________________________________________________ 7
Compiler path _______________________________________________________ 7
Make Path __________________________________________________________ 8
Virtual directory _____________________________________________________ 8
Consideraciones generales _______________________________________ 8
Tipos de datos _______________________________________________________ 8
Generación de objetos _________________________________________________ 8
Generación de programas de reorganizacion________________________________ 9
Smart Static Panels ___________________________________________________ 9
Tips _______________________________________________________________ 9
Puesta en produccion __________________________________________ 10
Instalación en el servidor ______________________________________________ 10
Requerimientos _____________________________________________________ 10
Instalación en el Cliente_______________________________________________ 11
Permisos .NET________________________________________________ 11
Permisos para ejecución de objetos remotos _______________________________ 11
Permisos para ejecución de reorganización remota __________________________ 11
Autorizacion por Web Panel ___________________________________________ 13
FAQ: Errores comunes_________________________________________ 13
Problemas en ejecución _______________________________________________ 13
Problema en compilación _____________________________________________ 15



2

Características


Alcance del Generador


El generador C#, permite el diseño de “Aplicaciones Web”, a travez de la plataforma
.NET. Para esto se generan los objetos GENEXUS Web Panels, transacciones con form Html
y procedimientos (que pueden definirse como webservices).

El generador también brinda la posibilidad de realizar el “Mantenimiento de la base de
datos”, es decir crearla y reorganizarla. No existen mayores diferencias de crearla con los
generadores Client/Server o C/SQL.

El generador aprovecha todas las cualidades de .NET, brindando las ventajas que este
tiene (reutilización de classes, seguridad, deployment, etc)

Objetos

Los programas generados son fuentes de código C#, estos son compilados a dlls en código
comun (IL Intermediate Language) las cuales en tiempo de ejecución son interpretados
por la máquina virtual de .NET

Los objetos web generados son : transacciones con form HTML, web panels y procedures.
No se soportan la generación de reportes. Por mas información Consideraciones generales


Para el acceso a la base de datos, se generan sentencias SQL, las cuales son ejecutadas
mediante una dll que maneja el acceso a los datos.

Ambientes


Los manejadores de base de datos soportados son los mismos que los de los generadores
Client Server, es decir DB2, Informix, Oracle y SQL Server.



Requerimientos de Software

Ambiente de Desarrollo

SISTEMA OPERATIVO



o Windows 2000 Professional
o Windows XP
o Windows NT 4.0 SP6


PLATAFORMA .NET


Para utilizar esta versión es necesario tener instalada la versión release del Framework
SDK, aunque se recomienda la instalación de Visual Studio .NET.



3

GENEXUS

- Development environment GeneXus 7.5
- Generador C# 7.5

OTROS

- Nmake.exe, es un utilitario que permite construir proyectos a partir de archivo



.mak. Lo provee el Visual Studio .Net (también es provisto por otros lenguajes que
utilizan Makefiles, como Java)

- Cliente y servidor de Base de datos de prototipo.

-

Internet Information Server para prototipación.
IMPORTANTE: El mismo debe ser instalado antes del .NET Framework SDK.



Importante: Para usuarios Oracle se requiere en el cliente el driver 8.1.75 o superior


-

Por información de requerimientos en el servidor de producción ver Puesta en
producción

Configuración de un modelo

1. Definir un Datasource de Sistema

2. Crear un modelo de prototipo o producción con el generador C#

3. Configurar preference del modelo (opcional, mas información)

4. Setear en las Dbms Options del modelo

a. Datasource Name
b. Usuario
c. Password



5. Configurar las propiedades de ejecución :

a. Compilador
b. Nmake
c. Nombre del directorio virtual (service por defecto)



4


Para los siguientes pasos, es necesario tener consideraciones en la configuración de :



- Permisos .NET
- Permisos del servidor de Web para ejecutar una aplicación.



6. Ejecutar la creación de la base de datos.

7. Generar programas


Si defino un Objeto Webpanel (Main) “Webxxx” con solo un mensaje luego de la
especificación y generación del objeto



Los programas generados para el Web Panel son:



Código fuente C#
Response
File
compilación)

(parámetros

de

HwebXXX.cs
HwebXXX.rsp



5



Make File

HwebXXX.mak



8. Compilar y Ejecutar


Al compilar Webxxx



se genera el assembly Hwebxxx.dll (código IL) bajo el directorio bin y se agrega una
entrada en el web.config

La salida de la compilación se envia al archivo Runout.log y en este caso es :



Compiling hWebxxx...

c:\...\nmake.exe csc=C:\WINNT\Microsoft.NET\Framework\v1.0.3705\csc.exe
mdlpath="C:\modelo\DATA002\web\" webroot=http://localhost/virtualDir/ -f
"C:\modelo\DATA002\web\hWebxxx.mak"

Microsoft (R) Program Maintenance Utility Version 6.00.8168.0
Copyright (C) Microsoft Corp 1988-1998. All rights reserved.

Building hwebxxx
Microsoft (R) Visual C# .NET Compiler version 7.00.9466

…
Virtual Directory succesfull created
Compilation Successful

C:\modelo\DATA002\web\UpdateConfigWeb.exe
Updating web config ...

1 Success - 0 Errors



En ejecución se invoca al Hwebxxx.aspx



6



Preferences específicas


Namespace



Determina el namespace de la aplicación. Los programas generados por GX y compilados
con C# se encuentran disponibles bajo el namespace indicado por esta preference. El
default es GeneXus.Programs. Sirve para los usuarios avanzados que quieren hacer algun
tipo de deployment en el GAC.
Valor por defecto: GeneXus.Program.

Use .Net control


Determina la forma de hacer el rendering de los controles HTML (para EditBox, CheckBox,
RadioButtons, ListBox y Buttons), en web panels y web transactions. Por default esta en
"Yes" lo que indica que el rendering se hace utilizando controles .Net para generar el HTML
necesario, este aprovecha ciertas caracteristicas del Internet Explorer para representar
mejor los controles. Estando en "No" indica que use el rendering standard generado por
GeneXus en todas sus plataformas, este último garantiza compatibilidad en el look and
feel entre las distintas plataformas Web generadas por GeneXus.

Valor por defecto: Yes

Generate developer menu makefile

Indica si se generaran los archivos necesarios para compilar el developer menú
El valor en NO es útil para evitar el armado del makefile del developer menú, este es muy
costoso ya que debe generar todos los response file (*.rsp) cada vez que se compila un
objeto.

Valor por defecto: Yes

Compiler options

La información de esta preference se incluirá en el .rsp que se usa para compilar el main.
Es útil por ejemplo para generar información de debug (incluyendo el string “/debug”) o
para incluir una dll dentro del namespace (/r:xxx.dll ).


Execution properties

Compiler path

Determina el path del compilador (csc.exe), este lo provee el framework SDK y se



7

el

bajo

encuentra
directorio
frameworkpath>\v1.0.3705\csc.exe,
WINNT\microsoft.net\


de
siendo

instalación
el <

del mismo
NET

en <NET
frameworkpath> =

Make Path

Determina el path del NMake.exe, el cual es necesario para poder compilar los objetos a
partir de la información almacenada en los *.mak. Este es provisto por el Framework SDK

Virtual directory

Determina la URL base de ejecución, esta contiene el directorio virtual a ser creado (si no
existe) por GeneXus en el Internet Information Service (IIS) local. El momento de la
creación es luego de la compilación y reorganización.



Consideraciones generales

Tipos de datos

La plataforma .Net es muy estricta en el chequeo de tipos, tanto en tiempo de compilación
como en tiempo de ejecución, el generador se ocupa de hacer los “casts” y conversiones
que puede, pero de todas formas pueden surgir errores causados por mala programación
(el mas común es el overflow en tipos numericos).

Se soportan todos los tipos de datos a excepción de DBConnection que aun no ha sido
implementado

Es necesario tener algunas consideraciones en el tipo de datos Mail :


Se han implementado los tipos de datos para el manejo de correo con modo “Internet”
(SMTPSession, POP3Session) y “Outlook”

En el caso de modo Outlook es necesario configurar el usuario, para esto se debe:


- agregar dentro de la sección <system.web> de