> For the complete documentation index, see [llms.txt](https://elguerre.gitbook.io/de0an/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://elguerre.gitbook.io/de0an/capitulo-7-la-construccion.-accediendo-a-los-datos/backend.md).
# Backend
En primer lugar, nos centraremos en el acceso a datos remotos, para lo que crearemos una API de Servicios REST que publicaremos como servicio de Microsoft Azure, beneficiándonos así de todas las ventajas de la Nube (o Cloud).
Aunque no vamos a profundizar en el uso de Microsoft Azure, sí que conoceremos cómo realizar las operaciones necesarias para llevar a cabo la creación de nuestro servicio.
En primer lugar, es imprescindible crear una suscripción a Azure, para poder trabajar con dichos servicios, para lo que accederemos a la página: , en la que nos registraremos, de manera gratuita.
1. Crear una nueva aplicación/servicio “Mobile App” tal y como muestra la siguiente figura.
**Figura 01.- Creación de una nueva Mobile App en el portal de Azure**
Donde:
* App name. Es el nombre que identifica a nuestra aplicación/servicio de manera unívoca en internet, por lo que no deberá existir previamente.
* Resource Group. Es una colección en la que todos los elementos o recursos comparten el mismo ciclo de vida, permisos y políticas. Permite una mejor administración y organización de recursos. De forma similar podríamos decir que es equivalente a una carpeta de nuestro disco duro cuyos recursos son ficheros.
* App Service Plan/Location. Determina la localización, costes y computación de recursos asociados a la aplicación/servicio.
**Figura 02.- Configuración del nombre, grupo de recursos y plan de servicio en Azure**
2. Una vez creada la aplicación, accederemos a la opción “Quick Start”, opción a través de la cual configuraremos la aplicación/servicio para crear una conexión a una base de datos SQL Database, que será nuestro repositorio remoto. A través de esta vista, obtendremos también un ejemplo de código que podemos descargar y usar como referencia para la creación de nuestra API RESTful.
**Figura 03.- Opción Quick Start para configurar la conexión a SQL Database**
3. Descargar el código de ejemplo y realizar los siguientes cambios:
1. Añadir el proyecto a la solución y modificar el nombre y *namespace* para asegurar que es: “ElGuerre.Taskin.WebApi”.
2. Añadir a la carpeta “DataObjects”, de forma similar a la clase de ejemplo “TodoItem”, las clases: ProjectItem, TaskItem, PomodoroItem y CheckItem. Éstas definen las tablas en las que consistirá nuestra aplicación.
**Figura 04.- Clases de entidades añadidas en la carpeta DataObjects del proyecto WebApi**
3. Añadir a la carpeta "Controllers" los controladores correspondientes para cada una de las tablas anteriores: ProjectItemsController.cs, TaskItemsController.cs, PomodoroItemsController.cs y CheckItemsController.cs.
4. De forma similar al controlador de ejemplo “TodoItemController”, añadir el siguiente código al controlador ProjectItemsController.
```csharp
protected override void Initialize(HttpControllerContext controllerContext)
{
base.Initialize(controllerContext);
DataContext context = new DataContext();
DomainManager = new EntityDomainManager(context, Request);
}
// GET tables/ProjectItems
public IQueryable GetAllProjects()
{
return Query();
}
// GET tables/Project/48D68C86-6EA6-4C25-AA33-223FC9A27959
public SingleResult GetProject(string id)
{
return Lookup(id);
}
// PATCH tables/ProjectItems/48D68C86-6EA6-4C25-AA33-223FC9A27959
public Task PatchProject(string id, Delta patch)
{
return UpdateAsync(id, patch);
}
// POST tables/ProjectItems
public async Task PostProject(ProjectItem item)
{
ProjectItem current = await InsertAsync(item);
return CreatedAtRoute("Tables", new { id = current.Id }, current);
}
// DELETE tables/ProjectItems/48D68C86-6EA6-4C25-AA33-223FC9A27959
public Task DeleteProject(string id)
{
return DeleteAsync(id);
}
}
```
5. Repetir el paso anterior para todos los controladores, sustituyendo la clase ProjectItem, por TaskItem, PomodoroItem y CheckItem respectivamente para cada controlador.
6. Renombrar la clase “Models\TaskinAppContext” para que pase a ser “DataContext” y realizar las modificaciones tal y como se recoge en el siguiente código.
```csharp
public class DataContext : DbContext
{
private const string connectionStringName = "Name=MS_TableConnectionString";
public DataContext() : base(connectionStringName)
{
}
public DbSet Projects { get; set; }
public DbSet Tasks { get; set; }
public DbSet Pomodoros { get; set; }
public DbSet CheckLists { get; set; }
protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
modelBuilder.Conventions.Add(
new AttributeToColumnAnnotationConvention(
"ServiceTableColumn", (property, attributes) => attributes.Single().ColumnType.ToString()));
}
}
```
## Publicación en Azure
Una vez que tenemos la API lista y funcionando en local, procederemos a publicarla en Azure directamente desde Visual Studio. Para ello, haremos clic con el botón derecho sobre el proyecto "ElGuerre.Taskin.WebApi" y seleccionaremos la opción "Publish…".
**Figura 05.- Publicación de la API desde Visual Studio en Azure (paso 1)**
A continuación, seleccionaremos "Microsoft Azure App Service" como destino de la publicación. En este punto, Visual Studio nos mostrará las suscripciones disponibles junto con los grupos de recursos y los planes de servicio que hayamos creado previamente en el portal de Azure.
**Figura 06.- Publicación de la API desde Visual Studio en Azure (paso 2)**
Seguidamente, configuraremos los parámetros de conexión y validaremos que todo es correcto antes de iniciar la publicación. Una vez completado el proceso, Visual Studio abrirá automáticamente el navegador con la URL del servicio desplegado, confirmando así que nuestra API REST está operativa en la nube.
**Figura 07.- Publicación de la API desde Visual Studio en Azure (paso 3)**
Por último, será necesario añadir el siguiente paquete NuGet al proyecto para habilitar las peticiones CORS (Cross-Origin Resource Sharing):
* Microsoft.AspNet.WebApi.Cors