Enlaces de Mobile Apps para Azure Functions

Artikulua
06/01/2023

Nota

Los enlaces de Azure Mobile Apps solo están disponibles para Azure Functions 1.x. No se admiten en Azure Functions 2.x y versiones posteriores.

Importante

La compatibilidad con la versión 1.x del entorno de ejecución de Azure Functions finalizará el 14 de septiembre de 2026. Se recomienda encarecidamente migrar las aplicaciones a la versión 4.x para obtener soporte completo.

En este artículo se explica cómo trabajar con enlaces de Azure Mobile Apps en Azure Functions. Azure Functions admite enlaces de entrada y salida para Mobile Apps.

Los enlaces de Mobile Apps permiten leer y actualizar las tablas de datos en las aplicaciones móviles.

Paquetes: Functions 1.x

Los enlaces de Mobile Apps se proporcionan en el paquete NuGet Microsoft.Azure.WebJobs.Extensions.MobileApps, versión 1.x. El código fuente del paquete está en el repositorio azure-webjobs-sdk-extensions de GitHub.

En la tabla siguiente se muestra cómo agregar compatibilidad con el enlace de salida en cada entorno de desarrollo.

Entorno de desarrollo	Para agregar compatibilidad en Functions 1.x
Desarrollo local: biblioteca de clases de C#	Instalación del paquete
Desarrollo local: script de C#, JavaScript, F#	Automático
Desarrollo con Portal	Automático

Entrada

El enlace de entrada de Mobile Apps carga un registro desde un punto de conexión de tabla móvil y lo pasa a la función. En funciones de C# y F#, los cambios realizados en el registro se enviarán automáticamente a la tabla una vez que la función se complete correctamente.

Ejemplo de entrada

Vea el ejemplo específico del lenguaje:

Script de C#
JavaScript

En el ejemplo siguiente se muestra un enlace de entrada de Mobile Apps en un archivo de function.json y una función de script de C# que usa el enlace. Un mensaje de cola que tiene un identificador de registro desencadena la función. La función lee el registro especificado y modifica su propiedad Text.

Estos son los datos de enlace del archivo function.json:

{
"bindings": [
    {
        "name": "myQueueItem",
        "queueName": "myqueue-items",
        "connection": "",
        "type": "queueTrigger",
        "direction": "in"
    },
    {
        "name": "record",
        "type": "mobileTable",
        "tableName": "MyTable",
        "id": "{queueTrigger}",
        "connection": "My_MobileApp_Url",
        "apiKey": "My_MobileApp_Key",
        "direction": "in"
    }
]
}

En la sección de configuración se explican estas propiedades.

Este es el código de script de C#:

#r "Newtonsoft.Json"    
using Newtonsoft.Json.Linq;

public static void Run(string myQueueItem, JObject record)
{
    if (record != null)
    {
        record["Text"] = "This has changed.";
    }    
}

En el ejemplo siguiente se muestra un enlace de entrada de Mobile Apps en un archivo de function.json y una función de JavaScript que usa el enlace. Un mensaje de cola que tiene un identificador de registro desencadena la función. La función lee el registro especificado y modifica su propiedad Text.

Estos son los datos de enlace del archivo function.json:

{
"bindings": [
    {
        "name": "myQueueItem",
        "queueName": "myqueue-items",
        "connection": "",
        "type": "queueTrigger",
        "direction": "in"
    },
    {
        "name": "record",
        "type": "mobileTable",
        "tableName": "MyTable",
        "id": "{queueTrigger}",
        "connection": "My_MobileApp_Url",
        "apiKey": "My_MobileApp_Key",
        "direction": "in"
    }
]
}

En la sección de configuración se explican estas propiedades.

Este es el código de JavaScript:

module.exports = async function (context, myQueueItem) {    
    context.log(context.bindings.record);
};

Entrada: atributos

En las bibliotecas de clases de C#, use el atributo MobileTable.

Para información sobre las propiedades de atributo que puede configurar, consulte la sección de configuración siguiente.

Entrada: configuración

En la siguiente tabla se explican las propiedades de configuración de enlace que se definen en el archivo function.json y el atributo MobileTable.

Propiedad de function.json	Propiedad de atributo	Descripción
type	N/D	Se debe establecer en "mobileTable"
direction	N/D	Se debe establecer en "in"
name	N/D	Nombre del parámetro de entrada en la firma de la función.
tableName	TableName	Nombre de la tabla de datos de la aplicación móvil
id	Id	El identificador único del registro que se va a recuperar. Puede ser estático o se puede basar en el desencadenador que invoca la función. Por ejemplo, si usa un desencadenador de cola para la función, `"id": "{queueTrigger}"` usa el valor de cadena del mensaje de cola como el identificador de registro que se va a recuperar.
connection	Connection	El nombre de una configuración de aplicación que tiene la dirección URL de la aplicación móvil. La función utiliza esta dirección URL para construir las operaciones de REST necesarias en su aplicación móvil. Cree una configuración de aplicación en la aplicación de función que contiene la dirección URL de la aplicación móvil y, luego, especifique el nombre de la configuración de la aplicación en la propiedad `connection` del enlace de entrada. La dirección URL tiene el aspecto siguiente: `https://<appname>.azurewebsites.net`.
apiKey	ApiKey	El nombre de la configuración de una aplicación que tiene la clave de API de la aplicación móvil. Proporcione la clave de API si implementa una clave de API en la aplicación móvil Node.js o implementa una clave de API en la aplicación móvil .NET. Para proporcionar la clave, cree una configuración de la aplicación en la aplicación de la función que contiene la clave de API y, luego, agregue la propiedad `apiKey` en el enlace de entrada con el nombre de la configuración de la aplicación.

Cuando esté desarrollando localmente, agregue la configuración de la aplicación en el archivo local.settings.json de la colección Values.

Importante

No comparta la clave de API con los clientes de aplicación móvil. Solo se debe distribuir de forma segura a los clientes del servicio, como Azure Functions. Azure Functions almacena la información de conexión y las claves de API como configuración de la aplicación de forma que no se protegen en el repositorio de control de código fuente. Esto protege la información confidencial.

Uso de entradas

En las funciones de C#, cuando se encuentra el registro con el identificador especificado, se pasa al parámetro JObject con nombre. Si el registro no se encuentra, el valor del parámetro es null.

En las funciones de JavaScript, el registro se pasa en el objeto context.bindings.<name>. Si el registro no se encuentra, el valor del parámetro es null.

En funciones de C# y F#, los cambios realizados en el registro de entrada (parámetro de entrada) se devuelven automáticamente a la tabla cuando la función termina correctamente. No se puede modificar un registro en las funciones de JavaScript.

Output

Use el enlace de salida de Mobile Apps para escribir un registro nuevo en una tabla de Mobile Apps.

Salida: ejemplo

En el ejemplo siguiente se muestra una función de C# que se desencadena mediante un mensaje de cola y crea un registro en una tabla de aplicación móvil.

[FunctionName("MobileAppsOutput")]        
[return: MobileTable(ApiKeySetting = "MyMobileAppKey", TableName = "MyTable", MobileAppUriSetting = "MyMobileAppUri")]
public static object Run(
    [QueueTrigger("myqueue-items", Connection = "AzureWebJobsStorage")] string myQueueItem,
    TraceWriter log)
{
    return new { Text = $"I'm running in a C# function! {myQueueItem}" };
}

En el ejemplo siguiente se muestra un enlace de salida de Mobile Apps en un archivo de function.json y una función de script de C# que usa el enlace. La función se desencadena mediante un mensaje de cola y crea un registro nuevo con un valor codificado de forma rígida para la propiedad Text.

Estos son los datos de enlace del archivo function.json:

{
"bindings": [
    {
        "name": "myQueueItem",
        "queueName": "myqueue-items",
        "connection": "",
        "type": "queueTrigger",
        "direction": "in"
    },
    {
        "name": "record",
        "type": "mobileTable",
        "tableName": "MyTable",
        "connection": "My_MobileApp_Url",
        "apiKey": "My_MobileApp_Key",
        "direction": "out"
    }
]
}

En la sección de configuración se explican estas propiedades.

Este es el código de script de C#:

public static void Run(string myQueueItem, out object record)
{
    record = new {
        Text = $"I'm running in a C# function! {myQueueItem}"
    };
}

En el ejemplo siguiente se muestra un enlace de salida de Mobile Apps en un archivo de function.json y una función de JavaScript que usa el enlace. La función se desencadena mediante un mensaje de cola y crea un registro nuevo con un valor codificado de forma rígida para la propiedad Text.

Estos son los datos de enlace del archivo function.json:

{
"bindings": [
    {
        "name": "myQueueItem",
        "queueName": "myqueue-items",
        "connection": "",
        "type": "queueTrigger",
        "direction": "in"
    },
    {
        "name": "record",
        "type": "mobileTable",
        "tableName": "MyTable",
        "connection": "My_MobileApp_Url",
        "apiKey": "My_MobileApp_Key",
        "direction": "out"
    }
],
"disabled": false
}

En la sección de configuración se explican estas propiedades.

Este es el código de JavaScript:

module.exports = async function (context, myQueueItem) {

    context.bindings.record = {
        text : "I'm running in a Node function! Data: '" + myQueueItem + "'"
    }   
};

Salida: atributos

En las bibliotecas de clases de C#, use el atributo MobileTable.

Para información sobre las propiedades de atributo que puede configurar, consulte Salida: configuración. A continuación, se muestra un ejemplo del atributo MobileTable en una signatura de método:

[FunctionName("MobileAppsOutput")]        
[return: MobileTable(ApiKeySetting = "MyMobileAppKey", TableName = "MyTable", MobileAppUriSetting = "MyMobileAppUri")]
public static object Run(
    [QueueTrigger("myqueue-items", Connection = "AzureWebJobsStorage")] string myQueueItem,
    TraceWriter log)
{
    ...
}

Salida: configuración

En la siguiente tabla se explican las propiedades de configuración de enlace que se definen en el archivo function.json y el atributo MobileTable.

Propiedad de function.json	Propiedad de atributo	Descripción
type	N/D	Se debe establecer en "mobileTable"
direction	N/D	Debe establecerse en "out"
name	N/D	Nombre del parámetro de salida en la firma de la función.
tableName	TableName	Nombre de la tabla de datos de la aplicación móvil
connection	MobileAppUriSetting	El nombre de una configuración de aplicación que tiene la dirección URL de la aplicación móvil. La función utiliza esta dirección URL para construir las operaciones de REST necesarias en su aplicación móvil. Cree una configuración de aplicación en la aplicación de función que contiene la dirección URL de la aplicación móvil y, luego, especifique el nombre de la configuración de la aplicación en la propiedad `connection` del enlace de entrada. La dirección URL tiene el aspecto siguiente: `https://<appname>.azurewebsites.net`.
apiKey	ApiKeySetting	El nombre de la configuración de una aplicación que tiene la clave de API de la aplicación móvil. Proporcione la clave de API si implementa una clave de API en el back-end de aplicación móvil de Node.js o implementa una clave de API en el back-end de aplicación móvil de .NET. Para proporcionar la clave, cree una configuración de la aplicación en la aplicación de la función que contiene la clave de API y, luego, agregue la propiedad `apiKey` en el enlace de entrada con el nombre de la configuración de la aplicación.

Cuando esté desarrollando localmente, agregue la configuración de la aplicación en el archivo local.settings.json de la colección Values.

Importante

Uso de salidas

En funciones de script de C#, use un parámetro de salida con nombre de tipo out object para acceder al registro de salida. En las bibliotecas de clases de C#, el atributo MobileTable se puede usar con cualquiera de los tipos siguientes:

ICollector<T> o IAsyncCollector<T>, donde T es JObject o cualquier tipo con una propiedad public string Id.
out JObject
out T o out T[], donde T es cualquier tipo con una propiedad public string Id.

En las funciones de Node.js, use context.bindings.<name> para acceder al registro de salida.

Pasos siguientes

Más información sobre desencadenadores y enlaces de Azure Functions

Partekatu honen bidez:

Enlaces de Mobile Apps para Azure Functions

Paquetes: Functions 1.x

Entrada

Ejemplo de entrada

Entrada: atributos

Entrada: configuración

Uso de entradas

Output

Salida: ejemplo

Salida: atributos

Salida: configuración

Uso de salidas

Pasos siguientes

Oharrak

Baliabide gehigarriak