Mostrando entradas con la etiqueta Scaffold. Mostrar todas las entradas
Mostrando entradas con la etiqueta Scaffold. Mostrar todas las entradas

viernes, 23 de septiembre de 2016

Relación 1 a muchos (Categorias/Clasificación de Artículos)

Se pretende clasificar los artículos creados con un scaffold en sus diferentes categorías. Un Artículo puede pertenecer a una sola Categoría, y una Categoría puede tener muchos Artículos, es por eso que nuestra relación es de 1 a muchos.

Hay 2 métodos para lograrlo, uno es la manera sencilla, creada a partir de las relaciones, la segunda, es un poco más compleja, utilizando los maps para ir almacenando las opciones al momento de desplegar las categorías.



1er MÉTODO


1.- Generar el scaffold de Category y correr la migración. Tendrá como único campo name para poder asignarle un nombre a la categoría

     rails g scaffold Category name 

     rake db:migrate



2.- Crear la relación. En caso de que no existiera la tabla Articles, se podría generar un scaffold y usar un category:references para que este, creara la relación y el campo que guardaría el ID de las categorías. En este caso, la tabla ya está creada, por lo tanto, generaremos el campo de forma manual, creando una migración para añadir este nuevo campo:

     rails generate migration add_category_id_to_articles category:references


Este comando generará automáticamente la migración que necesitamos, añadiendo una referencia en la tabla Artícles de la tabla Categories, con un campo llamado category_id, haciéndolo llave foránea y creando un índice:

(clic para agrandar)
 Después, solo será cuestión de correr la migración con rake db:migrate



3.- En la carpeta de modelos, modificaremos el recién creado (category.rb) y el de los artículos (article.rb). En el de las categorías, indicaremos como has_many los artículos debido a que una categoría puede estar presente en muchos artículos, y validaremos que el campo name sea único y no pueda quedar en blanco:


  has_many :articles
validates :name, uniqueness: {message: "Ya existe una categoría con este nombre"},
        presence: { message: "El nombre de la categoría no puede quedar vacío"}


(clic para agrandar)

Y en el de los modelo de artículos, pondremos como belongs_to a categorias, ya que se pretende, que un artículo solo pueda tener 1 categoria, al igual que validaremos que dicho campo sea llenado:

  belongs_to :category

(clic para agrandar)

**Cuando se usa has_many la referencia es en plural y cuando se usa belongs_to debe ir en singular




4.- Iremos al controlador articles_controller y dentro de la función new declararemos la variable que contendrá todas las categorías para que sean accesibles por este método:

@categories = Category.all

(clic para agrandar)



5.- Ahora, iremos a la vista del formulario de nuestros artículos, app/view/articles/ y reemplazaremos el campo que hace mención al category_id (en caso de haberse agregado) y se incluirá un collection_select el cual nos creará una lista desplegable con todas las categorías que hayamos creado. Primero se hace mención al modelo, después el campo y en seguida la variable que se declaró anteriormente, sustituyendo el ID por el nombre de la categoría y agregando un prompt que servirá como opción por defecto cuando aún no se ha seleccionado nada.


= collection_select(:article, :category_id, @categories, :id, :name, :prompt => "Seleccione Uno")

(clic para agrandar)



6.- De la misma manera en que se hizo en el punto 4, será necesario declarar la variable en el método edit para poder visualizar las categorías cuando se esté en el formulario de edición:

(clic para agrandar)


*** No olvidar agregar el campo de category_id a la lista de parámetros fuertes

Aplicando ejemplos:

Menú superior basado en categorías:


1.- En el controlador application_controller.rb crearemos un before_action debido a que necesitamos pasar información a todas las vistas (que por ende, el menú deberá integrarse en views/layouts/application.html.erb ya que esta vista es la que cargara en todas las demás). Así que nuestro before_action llama al método set_categories que definiremos, y este método recoge todas las categorías:


  before_action :set_categories

  private

  def set_categories
   @categoriesmenu = Category.all
  end


(clic para agrandar)



2.- Ahora se puede añadir la navegación en cualquier parte del proyecto accediendo a los datos de @categoriesmenu. En este caso, se crea un menú lateral con una lista, a quien además, se le añade una clase dinámica que se irá autoincrementando para que coincida con algunas clases que definí en CSS. El método para poder imprimir las categorías será con un método each recorriendo @categoriesmenu, y para la clase dinámica simplemente un contador, donde =link_to categoria.name, categoria estaría imprimiendo el nombre(name) de la categoría y funcionaría como enlace hacia la propia categoría, y {:class => "ret#{i+=1}"} sería una atributo que estaríamos pasando por haml (sí, el HTML se encuentra escrito en HAML) para añadir la clase ret concatenando la variable i (antes definida) sumándole 1:



%ul.list-group#menu-prin
     %li.list-group-item.animated.fadeInLeft.ret3=link_to "Inicio", root_path
     -i = 4
     -@categories.each do |categoria|
          %li.list-group-item.animated.fadeInLeft{:class => "ret#{i+=1}"}
               =link_to categoria.name, categoria


(clic para agrandar)

De esta manera, se ha generado nuestro menú lateral, usando las categorías que se encuentran en nuestra tabla Categories.








Relación 1 a muchos (Categorias/Clasificación de Artículos) (MAPS)

2do MÉTODO. MAPS 

Los primeros 3 pasos del primer ejemplo serán los mismos, así que se seguirá con el punto 4 el cuál cambiará para este método:


4.- Mandando las categorías hacia los formularios. Ahora que se ha generado nuestra relación, será necesario mandar nuestras categorías creadas hacia los formularios de editar y crear un nuevo artículo. Para poder recoger todas las categorías y que estas puedan ser mostradas en un select_tag usaremos el hash .map en nuestro controlador de artículos:

@categories = Category.all.map { |result| [result.name, result.id] }

El método .map itera en función a lo que se indique, y creando un arreglo con todos los resultados obtenidos. En este caso, podemos usarlo para iterar sobre Category.all y capturar todas las categorías para tener un arreglo de todas ellas, pero por cada categoría, se creará una arreglo [result.name, result.id] que contiene su nombre y id poder ser usadas en el form, teniendo como resultado en @categories un vector.

Debido a que esta línea debería encontrarse tanto en edit como en new, se opta por crear un before_action para que funcione en solo en estos dos casos only: [:new, edit] y evitar reescribir el mismo código:

(clic para agrandar)
(clic para agrandar)


Ya están accesibles nuestras categorías, ahora será necesario en el formulario incluir un select_tag el cual se encargará de mostrar la lista desplegable de categorías disponibles, y es donde interviene options_for_select(@categories) recogiendo los dos valores que se declararon anteriormente con el método .map el primero es el name, que será la etiqueta que se mostrará en la lista, y el segundo será el id, que representa su valor y el cuál será el que sea guardado en la BD en el campo category_id generando la relación.

= select_tag :category_id, options_for_select(@categories), :prompt => "Tipo de artículo"

(clic para agrandar)


5.- Ahora, se creará otro before_action para poder guardar los parámetros que se cambien a la hora de editar la categoría de un artículo, por lo cual, este será llamado en edit y en create (debido a que cuando se llame a este método, debe pasar el parámetro ID que se le asigno a la hora de llenar el formulario)

@article.category_id = params[:category_id]


en este caso, se definirá article_update

def article_update
      @article.category_id = params[:category_id]
end


(clic para agrandar)

(clic para agrandar)


Con esto, estará completa nuestra implementación de categorías en los artículos. Ya es posible clasificar nuestro contenido al momento de crearlo o editarlo y guardar dicha relación en la BD.

A partir de aquí de puede ir por diferentes vías dependiendo cómo mostrar el catálogo que se desarrolló. Como ejemplo cualquiera, se implementa aquí un menú superior, que servirá para acceder a los artículos, ordenados según su categoría.

jueves, 7 de julio de 2016

Migraciones en Ruby on Rails (Modificar y Borrar tablas)

Las migraciones nos permiten modificar las tablas en nuestras bases de datos, agregando nuevos campos, quitando o modificando los existentes.

Haciendo un rake db:rollback deshacemos los últimos cambios generados en la base de datos, pero no es lo más correcto solo modificar el schema o migración existente para después hacer un rake db:migrate (aunque el proceso puede ser válido siempre y cuando se esté trabajando unicamente en entorno de desarollo). El proceso correcto sería creando una nueva migración y que esta sea la encargada de hacer las modificaciones necesarias.


**Algunos comandos de ayuda en la consola de rails (rails console)

1.- Consultar las tablas que hay en nuestra aplicación:

     ActiveRecord::Base.connection.tables


2.- Consultar las columnas de nuestra tabla de una manera ordenada (usando el .map{})

    ActiveRecord::Base.connection.columns("nombre_tabla").map{|c| [c.name, c.type]}


3.- Borrar una tabla en especifico:

    ActiveRecord::Migration.drop_table(:articles)


O a través de una 2da migración como se ve aquí:
MODIFICAR EL LINK DE BORRAR TABLA ARTICLES

Modificar una tabla con una migración

Las migraciones que se vayan creando en el proyecto, se irán nombrando de la siguiente manera: YYYYMMDDHHMMSS_nombre_de_la_migracion.rb que con esto se puede entender que se guardar en un "instante del tiempo" para definir el orden correcto de las migraciones, es decir, que cada una vaya siguiendo su patrón correcto de ejecución para evitar conflictos entre las diferentes versiones de cambios y que estos pudieran tener repercusiones en la tabla destino.


Se ejemplifica que se ha creado un scaffold (igual se puede usar en caso de haber creado solo el modelo)que contendría los siguientes campos:

     rails generate scaffold Article name description:text pricing:decimal user:references


Caso 1: Añadir nuevos campos a la tabla Articles

1.- Se crea la migración, ejecutando este comando en cosola, donde AddColumnWidthHeightToArticles es el nombre que llevará la migración, este es arbitrario y puede nombrarse al gusto, en este caso, se pretende especificar qué será lo que hará la migración

     rails generate migration AddColumnWidthHeightToArticles


2.- Esto nos genera un archivo de migración en db/migrate y aquí es dónde indicaremos que acción se generará:

(Clic para agrandar)
  def change
    add_column :articles, :width, :decimal, scale: 2, precision: 5
    add_column :articles, :height, :decimal, scale: 2, precision: 5
  end

add_column será el método que queremos realizar.
:articles es el primer parametro, el cual indica la tabla a la que realizará la acción.
:witdh será el nombre del campo que añadirá la migración.
:decimal será el tipo de campo.
scale: 2 Como el campo es un decimal, aquí indicaremos que se conformará por 2 digitos después del punto decimal.
precision; 5 indicará el número total que conformará nuestro decimal, en este caso, serán 5, que con el valor anterior se entiende que el número se conformará por 3 números antes del punto y 2 después de él.

De la misma manera que se hizo con scale y precision, se podrán ir indicando qué otras caracteristicas tendrá nuestro campo, como por ejemplo: index: true, foreign_key: true, default: "valor_por_defecto", etc


Ahora que sabemos como funciona la estructura, podemos modifcar un poco el comando ejecutado en el primer punto, cambiando el nombre que se indicó de la migración

     rails generate migration AddCommentsToArticles comments:string

Al ejecutarlo de esta manera, le estamos indicando al generador, que el archivo que creará tendrá como contenido un add_column con un campo llamado commets del tipo string:

(Clic para agrandar)

Se pueden añadir la cantidad de campos que se desee, solo es necesario separar con un espacio los campos que se incluirán:

     rails generate migration AddDetailsToArticles comments:string witdh:decimal height:decimal

3.- En esta, y en todas las migraciones, finalizamos con rake:db migrate para correr las migraciones y procesa al borrado de la tabla




Caso 2: Quitar campos de la tabla Articles

1.- Podemos usar el último comando visto para así poder eliminar una columna sin necesidad de modificar el archivo de migración

     rails generate migration RemoveCommentsFromArticles commens:string

(Clic para agrandar)



Caso 3: Cambiar tipo de campo en la tabla Articles

1.- Para generar cambios al tipo de campo, usaremos change_column usando como ejemplo el campo que se creó anteriormente de comments declarado como un string, ahora lo cambiaremos a un text

  def change
    change_column :articles, :comments, :text
  end

(clic para agrandar)



Caso 4: Renombrar campos en la tabla Articles

1.- Con rename_column se puede cambiar el nombre del campo, en este caso se está cambiando de nombre a comments para que sea ahora opinions:


  def change
    rename_column :articles, :comments, :opinions
  end

(clic para agrandar)


Caso 5: Modificando la estructura de la tabla

Al momento de crear un modelo o un scaffold, este genera una migración que contiene el objeto create_table y sobre este se genera la estructura. Por lo tanto, podemos hacer uso de un objeto similar para reestructurar nuestra tabla con parte de lo visto, en este caso, usaremos change_table:

  def change
change_table :articles do |t|
t.string :color #Añade un campo llamado color de tipo string
  t.remove :opinions, :widht, :height #Remueve los campos opinions, width y height
  t.rename :name, :title #Renombra el campo name por title
end
  end


(clic para agrandar)



Definiciones complementarias para el método Change:

  • add_column
  • add_index
  • add_reference
  • add_timestamps
  • add_foreign_key
  • create_table
  • create_join_table
  • drop_table
  • drop_join_table
  • remove_timestamps
  • rename_column
  • rename_index
  • remove_reference
  • rename_table


Caso 6: Borrando la tabla con migraciones


Para este caso usaremos los métodos UP y DOWN quienes se encargarán de llevar a cabo el borrado de la tabla. Al usar estos métodos estamos indicando a rails que hacer en la migración y qué hacer al revertir con rollback. Dentro de UP escribiremos las acciones que queremos que lleve a cabo la migración, mientras que en DOWN que será lo que tendría que hacer en caso de hacer un rollback.

En caso de usarse en un caso más complejo de manipulación, se seguirá el mismo principio de ordenamiento de rails, es decir, en DOWN escribiremos el inverso "de abajo a arriba" en el orden que se fueron definiendo dentro de UP.

En el caso de que una migración se vuelva compleja y no se pueda revertir lo ejecutado, por ejemplo, los datos perdidos al borrar un campo/tabla que no pueden volverse a recuperar, entonces dentro de DOWN se puede escribir raise ActiveRecord::IrreversibleMigration y con esto estamos indicando a rails que el rollback no podría ejecutarse, y en caso de hacerlo, arrogaría un error y no ejecutaría el comando. 

1.- Se crea la migración:
    rails generate migration DropPruebasTable


2.- Esto nos genera un archivo de migración en db/migrate y aquí es dónde indicaremos que acción se generará, en este caso, el borrado de la tabla:

  def up
    drop_table :pruebas
  end

  def down
    raise ActiveRecord::IrreversibleMigration
  end

(clic para agrandar)



**Para tener toda la información completa acerca de las Migraciones:
Fuente