Modelos
- Es la fuente única y definitiva de información sobre sus datos
- Contiene los campos y comportamientos esenciales de los datos que está almacenando
- Generalmente, cada modelo se asigna a una sola tabla de base de datos
En
models.pyse construirán clases y atributos. Esas clases y atributos representarán tablas y campos de una base de datos
Ejemplo:
#./models.py
from django.db import models
class Person(models.Model):
first_name = models.CharField(max_length=30)
last_name = models.CharField(max_length30)
first_nameylast_nameson atributos de la clasePerson- Django los convierte en campos del modelo Person, por lo que cada una representará una columna de la base de datos
1. Creación de Modelo
Crear un nuevo proyecto llamado proyectomodelo. Agregar un modelo llamado Person.
-
Crear nuevo proyecto: Llamarlo
proyectomodelodjango-admin startproject proyectomodelo cd proyectomodelo -
Crear app: Llamarla
corepython manage.py startapp core -
Configuración Inicial: Agregar
coreaproyectomodeloensettings.py#./proyectomodelo/settings.py from pathlib import Path ... ... INSTALLED_APPS = [ ... ... "core" ... ... -
Configurar Modelos: Crear una clase
Person#./core/models.py from django.db import models class Person(models.Model): nombre = models.CharField(max_length=50, help_text="Indica tus 2 nombres") apellido = models.CharField(max_length=50, help_text="Indica tus 2 apellidos") edad = models.IntegerField(help_text="Indica tu edad") -
Configuración Base de datos (1): Generar un script intermedio entre las clases de modelos y bases de datos
Este comando debe ser ejecutado cada vez que se cree un nuevo modelo, o se realice una modificación a un modelo existente
Migrations for 'core': core/migrations/0001_initial.py + Create model Personpython manage.py makemigrations -
Configuración Base de datos (2): Subir el script generado anteriormente a la base de datos
Operations to perform: Apply all migrations: admin, auth, contenttypes, core, sessions Running migrations: Applying core.0001_initial... OKpython manage.py migrate
2. Modificar Modelo
Cambiar el nombre del modelo Person a Persona
-
Configurar Modelos: Se utiliza la clase
Meta, para realizar cambios sin destruir el historial modificaciones- se crea la clase
Metadentro de la clase a modificar - se utiliza el atributo
db_tablepara cambiar el nombre
#./core/models.py from django.db import models class Person(models.Model): nombre = models.CharField(max_length=50, help_text="Indica tus 2 nombres") apellido = models.CharField(max_length=50, help_text="Indica tus 2 apellidos") edad = models.IntegerField(help_text="Indica tu edad") class Meta: db_table = 'Persona' - se crea la clase
-
Configurar Base de datos (1): Generar un script con los cambios realizados
Migrations for 'core': core/migrations/0002_alter_person_table.py ~ Rename table for person to Personapython manage.py makemigrations -
Configurar Base de datos (2): Subir el script con los cambios, a la base de datos
Operations to perform: Apply all migrations: admin, auth, contenttypes, core, sessions Running migrations: Applying core.0002_alter_person_table... OKpython manage.py migrate
3. Módulo Admin de Django
- Una forma de acceder a la información de una base de datos es a través de aplicativos externos, como algún gestor de Base de datos (DB Browser SQLite)
- Otra alternativa es acceder a través del módulo de administración Django (Admin)
- Se puede ahorrar mucho tiempo de desarrollo, facilitando las pruebas de los modelos y sus datos
Importar Modelos a módulo Admin
Agregar los modelos creados a admin.py
#./core/admin.py
from django.contrib import admin
from .models import Person
# Register your models here.
admin.site.register(Person)
Acceso al módulo Admin
-
Crear Superusuario: Utilizar el comando
createsuperusery llenar los campos solicitadosUsername (leave blank to use 'sauk'): antonio Email address: antonio@example.cl Password: antoniomorales123 Password (again): antoniomorales123 Superuser created successfully.python manage.py createsuperuser -
Realizar Pruebas: Levantar el servidor y verificar la ruta de admin
http://localhost:8000/admin/
Agregar Datos en el Admin
- Una vez accedido al módulo Admin, se pude agregar manualmente los datos a través del GUI

Modificar Presentación Lista de Datos en el Admin
Al agregar datos de personas, éstas aparecen en la lista como objetos:

Para mejorar la presentación, se necesita modificar la clase Person utilizando el método __str__
#./core/models.py
from django.db import models
class Person(models.Model):
nombre = models.CharField(max_length=50, help_text="Indica tus 2 nombres")
apellido = models.CharField(max_length=50, help_text="Indica tus 2 apellidos")
edad = models.IntegerField(help_text="Indica tu edad")
class Meta:
db_table = 'Persona'
def __str__(self):
return f"{self.nombre} {self.apellido}"

Modificar Presentación del Nombre del Modelo en el Admin

- Por defecto, Django muestra el nombre del modelo en inglés: Person (singular) y Persons (plural)
- En el menú lateral del admin aparece “Persons” (plural en inglés)
- Para tener nombres en español como “Persona” y “Personas”, usamos
verbose_nameyverbose_name_pluralen la claseMeta
#./core/models.py
from django.db import models
class Person(models.Model):
nombre = models.CharField(max_length=50, help_text="Indica tus 2 nombres")
apellido = models.CharField(max_length=50, help_text="Indica tus 2 apellidos")
edad = models.IntegerField(help_text="Indica tu edad")
class Meta:
db_table = 'Persona'
# Modificar el nombre del modelo en el admin
verbose_name = 'Persona'
verbose_name_plural = 'Personas'
def __str__(self):
return f"{self.nombre} {self.apellido}"

Modificar la Presentación de Campos en Admin
- Es posible mejorar la Presentación de los campos en Admin, para que se muestren como si fuera una tabla de base de datos
- Para esto se crea una clase
PersonAdminenadmin.py
#./core/admin.py
from django.contrib import admin
from .models import Person
# Clase para la definición de los modelos
class PersonAdmin(admin.ModelAdmin):
list_display = (
'id',
'nombre',
'apellido',
'edad'
)
# Register your models here.
admin.site.register(Person, PersonAdmin)

Agregar Filtro en Admin
Se agrega list_filter en la clase PersonAdmin, para así filtrar por un campo en específico
#./core/admin.py
from django.contrib import admin
from .models import Person
# Clase para la definición de los modelos
class PersonAdmin(admin.ModelAdmin):
list_display = (
'id',
'nombre',
'apellido',
'edad'
)
list_filter = (
'apellido',
)
# Register your models here.
admin.site.register(Person, PersonAdmin)

Organizar y Agrupar Campos en Admin
fieldsets: Divide el formulario en seccciones con títulos, haciendo más legible y organizado el formulario cuando se agrega o edita un objeto
#./core/admin.py
from django.contrib import admin
from .models import Person
# Clase para la definición de los modelos
class PersonAdmin(admin.ModelAdmin):
list_display = (
'id',
'nombre',
'apellido',
'edad'
)
list_filter = (
'apellido',
)
fieldsets= (
('Datos Personales', {'fields': ('nombre', 'apellido')}),
('Datos Adicionales', {'fields': ('edad',)}),
)
# Register your models here.
admin.site.register(Person, PersonAdmin)
Ahora es posible acceder a los datos agrupados haciendo click en la ID

Por ejemplo, si se hace click en ID=2

Modificar Idioma y Hora en Admin
Para esto es necesario modificar algunos parámetros en el archivo settings.py
#./proyectomodelo/settings.py
from pathlib import Path
...
...
LANGUAGE_CODE = "es-CL"
TIME_ZONE = "America/Santiago"
...
...
Modificar Nombre de App en Admin
Es posible modificar el nombre de la app core

Para esto es necesario ingresar a apps.py y agregar la variable verbose_name
#./core/apps.py
from django.apps import AppConfig
class CoreConfig(AppConfig):
default_auto_field = "django.db.models.BigAutoField"
name = "core"
verbose_name = "Aplicación de Personas"

4. Ejercicios
Ejercicio 01
Agregar el campo email al modelo Persona
-
Configurar Modelos: agregar atributo
emaila clasePerson#./core/models.py from django.db import models class Person(models.Model): nombre = models.CharField(max_length=50, help_text="Indica tus 2 nombres") apellido = models.CharField(max_length=50, help_text="Indica tus 2 apellidos") edad = models.IntegerField(help_text="Indica tu edad") email = models.EmailField(null=True, blank=True, help_text="Ingresa tu correo") class Meta: db_table = 'Persona' # Modificar el nombre del modelo en el admin verbose_name = 'Persona' verbose_name_plural = 'Personas' def __str__(self): return f"{self.nombre} {self.apellido}" -
Configurar Admin: Agregar el campo
emaila la clasePersonAdmin#./core/admin.py from django.contrib import admin from .models import Person # Clase para la definición de los modelos class PersonAdmin(admin.ModelAdmin): list_display = ( 'id', 'nombre', 'apellido', 'edad', 'email' ) list_filter = ( 'apellido', ) fieldsets= ( ('Datos Personales', {'fields': ('nombre', 'apellido')}), ('Datos Adicionales', {'fields': ('edad','email')}), ) # Register your models here. admin.site.register(Person, PersonAdmin) -
Configurar Base de datos: Crear archivos de migración con los cambios realizados y aplicarlos a la base de datos
Migrations for 'core': core/migrations/0003_alter_person_options_person_email.py ~ Change Meta options on person + Add field email to personpython manage.py makemigrationsOperations to perform: Apply all migrations: admin, auth, contenttypes, core, sessions Running migrations: Applying core.0003_alter_person_options_person_email... OKpython manage.py migrate