Manual de Desarrollado de Mdulos en Espaol Version 1.0-4 Beta Escrito por: Bruno Macias V.

(bomv.27@gmail.com)

Introduccin

MduloDeveloper

Estegranmdulodistribuidoentressubmduloshastalapresentefecha,hasidodesarrollado pararealizaraccionesdecreacin(BuildModule),eliminacin(DeleteModule)y mantenimientodeloslenguages(LanguageAdmin)parausodedesarrolladoresqueconocenel frameworkElastix,lenguajedeprogramacinPHP,basesdedatosMySQLySQLite. Estaherramientaconstituyeunahorroencodificacinytransparenciaenprocesosrutinariosal empezaradesarrollarunmoduloparalaGUIdeElastix. SerecomiendatenerconocimientosdearquitecturaMVC2(ModelodeCapas),conocimientoen programacinorientadaaobjetosPOO,conocerlastecnologaswebtantoparaelladodel clienteyparaelladodeservidorcomohtml,style,javascript,ajax,etc.

Detalles
BuildModule:
Esteeselprincipalsubmdulosparadeveloper,generaunmdulobaseoesqueletoparaluego continuarconeldesarrollodelalgicaoelfinqueelmodulopresenta.Estoayudaentomarel tiempodebidoalalgicaofuncionalidad,porendedetallesdediseoytareasrepetitivas (codificacionessimilaresoidnticas)notomaranmayortiempoencrearlas. AlcrearunmoduloconelBuildModulevaagenerardoscosasenlaplataformaGUIElastix basandoensuframework:

Generacindelmenomenssegnseaelniveldondeestarelmodulo.Sontresniveles queElastixmanejaparasusmens. Generacindelaprogramacinesqueletoubicadoenlacarpetamodulesdelframework Elastix,estanuevomdulosucarpetatieneelnombredelidquesehallaelegidoenla interfazdeBuildModuleyestenodeberepetirse.

Hayquenotarquelageneracindelesqueletocontieneprogramacindinmica,que inteligentementesecreasegnladescripcindelmdulo,yaseaesteunreporte(grip),un formularioounframed(paraintegrarotrossoftwaredentrodelaGUIElastixmedianteeluso deunframe). ElBuildModuleestaseccionadoentrespartes:

InformacinGeneral Localizacin Descripcindelmdulo

PresentacingeneraldelavistadeBuildModule:

InformacinGeneral Estaseccinnosayudaendefinicindenombreeidentificadornicodelmdulo,datosdela personaquecreaelmoduloparacomentarlasenlascabecerasdecadaarchivodeprogramacinen PHPyelniveldevisinparalosusuariosdeestemdulo.

Parmetro ModuleName ModuleId GroupPermission YourName Youremail

Descripcin NombredelMdulo,iniciandolaprimeraletradecadapalabraconmayscula IdentificadordelMdulo,debeserenletraminsculayseparadaporunsub guintalcomosemuestraenlafiguradearriba. Estaopcinpermiteelegirelgradodeaccesibilidaddelosusuariosaeste mdulo. Definimoselnombredequienhizoelmdulo. Direccindecorreoelectrnicodequienhizoelmdulo.

Location Enestaseccinindicadondevamosaubicarelmendelnuevomdulo.Elastixmanejatresniveles demensporendedebemostenerunpocodecuidadoenelingresodelosdatos,laimagenmuestra aeleccindemendenivel3ysequierequeseunmentotalmentenuevo.Acontinuacinse explicacomollenarestoscampos.

AlmomentodeubicarunmduloenelmenElastixsepuedenpresentarcuatroalternativas: Nivel1 Existe Nivel2 Acrear Nivel3 Nosedaelcaso Descripcindelmenacrear Unmendesegundonivelconunmenpadrede nivel1queyaexiste,enelcasoparticularde Elastixlosmenspadresson:System,PBX,Fax, Email,IM,Reports,Extras,AgendayDeveloper. Unmendesegundonivelconunnuevomen padredenivel1,enestecasoelmenpadreno existeyseracreadoparaellohayqueingresarsu nombreysuidenlosrespectivoscamposdeLevel 1ParentNameyLevel1ParentId. Alcrearelmendetercernivelexistentantoel padredelsegundoyprimernivel,enestecasosolo seseleccionalosrespectivosmenspadresdelos combosqueaparecen. Enestecasohabrqueingresarlosdatospara creartantoelnuevomencomoeldelpadredel mismo,paraelloestnloscampos,Level2Parent NameyLevel2ParentId. Esteeselcasoenquesedeseaunmenudetercer nivelperototalmenetenuevoencategoriasdelos mensparaelloestanloscampos: Level2ParentNameyLevel2ParentId. Level1ParentNameyLevel1ParentId.

NoExiste Acrear

Nosedaelcaso

Existe

Existe

Acrear

Existe

NoExiste

Acrear

NoExiste NoExiste

Acrear

Creacindeunmduloenunmendesegundonivelconpadredenivel1existente.

Creacindeunmduloenunmendesegundonivelconpadrenoexistente.

Creacindeunmduloenunmendetercernivel,tantolospadresdenivel1ynivel2existen.

Creacindeunmduloenunmendetercernivel,enestecasohayqueingresarlosdatosparael mendesegundonivelquenoexisteperoeldeprimernivelsiexiste.

Crearunmduloenunmendetercerniveldondesuspadresnoexisten.

Parmetro ModuleLevel

Descripcin Aquidefinimoselniveldelmoduloestepuedeser23 Estaopcinesmuyimportantepuesaquidefinimossielmoduloacreartiene un"mdulopadredenivel1existente". Si:Escogemosel"mdulopadre". No:Procederemosaingresarinformacinen2camposadicionalesque aparecen. Level1ParentNameyLevel1ParentId Definimoselnombredel"ModuloPadre"siguiendoelmismoformatoes decirsololaprimerapalabraconletramayscula Definimoselidentificadordel"ModuloPadre"siguiendoelmismoformatoes decirconletraminsculayseparadadesubguionessiesnecesario. Estaopcinesmuyimportantepuesaquidefinimossielmoduloacreartiene un"mdulopadredenivel2existente". Si:Escogemosel"mdulopadre". No:Procederemosaingresarinformacinen2camposadicionalesque aparecen. Level2ParentNameyLevel2ParentId Definimoselnombredel"ModuloPadre"siguiendoelmismoformatoes decirsololaprimerapalabraconletramayscula Definimoselidentificadordel"ModuloPadre"siguiendoelmismoformatoes decirconletraminsculayseparadadesubguionessiesnecesario.

Level1ParentExists

Level1ParentName Level1ParentId

Level2ParentExists

Level2ParentName Level2ParentId

ModuleDescription Estaseccinsuimportanciaestaenquesedefinequetipodemdulovaacrear,entreellotenemos detrestipos: Formulario Reporte Frame

Tiposdecamposquesepuedencrearenladefinicindeunmdulotipoformulario:

NOTA:Conlosbotones">>","<<"podemosaadiroquitarloscamposainsertarennuestro formulario.Ademas,cuandoesdetipogridelcampo"FieldType"esoculto,solobastaconescribir en"FieldName"quesonlosnombresdelascolumnasapresentar.

Parmetro

Descripcin Estaopcinnospermiteelegireltipodemoduloquedeseamos crear,tenemostrestipos. Form:Creaciondeunmduloformulario. Grid:Creacindeunmduloreporte Framed:Creacindeunmduloparacontenerdeframe. Definimoselnombredelcampoacrear Definimoseltipodelcampoacrear

ModuleType

FieldName FieldType

Alguardarlosdatosestablecidosparaelnuevomduloyenespeciallosdetipoformularioy reporteestocrearaelsiguienterboldedirectoriosenlarutadocumentRoot/modulesdonde documentRootes/var/www/htmlparaElastix:

Comopodrnotarunmodulotienelamismaarquitecturageneraldel framework,arquitecturawebMVC2porendesedefineaestocomoun MVC2dentrodeotroMVC2unadefinicinderecursividaddegrado2. Enquenosayudaesto,esquepodemosdeformainmediatahacersimilitud quelascarpetastienenlassiguientesrelaciones: themeseslacapavista index.phpeslacapacontrol libseslacapamodelo Carpetascomolangssonimportantesrecalcaryaqueaqusedefinirnlas traduccionesparaelmdulo.

DeleteModule: Elsubmen"DeleteModule"delmdulo"Developer"enElastixnospermiteeliminar mdulosentodossusniveles.Primerotendrqueeliminarlossubmdulosqueexistan enelmdulopadreparapodereliminarloporcompleto.

Nota: TenerprecaucinalescogerlaopcinDeleteFilesqueestoeliminarelcontenidode losmdulosporcompleto,usteddebeestarseguroalaplicarestaopcin.

LanguageAdmin:
Elsubmdulo"LanguageAdmin"delmdulo"Developer"nospermiteadministrarlosdiferentes idiomasdelosmdulosenElastix. Podemosconsultarsiexisteunlenguajedefinidoparaunmdulo,tambienparaelFRAMEWORK y observarunalistadepalabrasconsurespectivatraduccincomolopodemosobservarenlafigura deabajo.Estosvalorespuedensermodificadosdeacuerdoalidiomaquedeseetraduciryguardar loscambiospresionandoelbotn"Saveall".

Agregarnuevastraduccionesy/olenguajesaunmdulo ParaagregartraduccionesodefinicionesdelenguajesenElastixexistelasiguienteventana:

Estaventananosindicasivamosacrearunanuevatraduccionesaunlenguajeexistenteosivamos acreartotalmenteunnuevolenguaje,algodenotaresquesielejimosunnuevolenguajeparaun mdulodadoesteestableceralaspalabrasotraduccionesbasandosedellenguajeeningles,porende cuandoustedcreesunuevolenguajenotarqueestallenoeninglesydeahipodrhacerla traduccionesasuidioma.

Tambinnospermitelatraduccinaotroidiomapalabraporpalabradeunmdulocomolo podemosobservarenlafigura.