Azure İşlevleri için Mobile Apps bağlamaları

Makale
04/07/2024

Not

Azure Mobile Apps bağlamaları yalnızca Azure İşlevleri 1.x için kullanılabilir. Bunlar Azure İşlevleri 2.x ve üzeri sürümlerde desteklenmez.

Önemli

Azure İşlevleri çalışma zamanının 1.x sürümü için destek 14 Eylül 2026'da sona erecektir. Tam destek için uygulamalarınızı 4.x sürümüne geçirmenizi kesinlikle öneririz.

Bu makalede, Azure İşlevleri'de Azure Mobile Apps bağlamalarıyla çalışma açıklanmaktadır. Azure İşlevleri, Mobile Apps için giriş ve çıkış bağlamalarını destekler.

Mobile Apps bağlamaları, mobil uygulamalarda veri tablolarını okumanızı ve güncelleştirmenizi sağlar.

Paketler - İşlevler 1.x

Mobile Apps bağlamaları Microsoft.Azure.WebJobs.Extensions.MobileApps NuGet paketi, sürüm 1.x'te sağlanır. Paketin kaynak kodu azure-webjobs-sdk-extensions GitHub deposundadır.

Aşağıdaki tabloda, her geliştirme ortamında çıkış bağlama desteğinin nasıl ekleneceği listeilmektedir.

Geliştirme ortamı	İşlevler 1.x'te destek eklemek için
Yerel geliştirme: C# sınıf kitaplığı	Paketi yükleme
Yerel geliştirme: C# betiği, JavaScript, F#	Otomatik
Portal geliştirme	Otomatik

Giriş

Mobile Apps giriş bağlaması, mobil tablo uç noktasından bir kaydı yükler ve işlevinize geçirir. C# ve F# işlevlerinde, işlev başarıyla çıktığında kayıtta yapılan tüm değişiklikler otomatik olarak tabloya geri gönderilir.

Giriş - örnek

Dile özgü örne bakın:

C# betiği
JavaScript

Aşağıdaki örnekte, bir function.json dosyasındaki Mobile Apps giriş bağlaması ve bağlamayı kullanan bir C# betik işlevi gösterilmektedir. İşlev, kayıt tanımlayıcısı olan bir kuyruk iletisi tarafından tetikleniyor. İşlev, belirtilen kaydı okur ve özelliğini değiştirir Text .

function.json dosyasındaki bağlama verileri aşağıdadır:

{
"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"
    }
]
}

Yapılandırma bölümünde bu özellikler açıklanır.

C# betik kodu aşağıdadır:

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

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

Aşağıdaki örnekte, bir function.json dosyasındaki Mobile Apps giriş bağlaması ve bağlamayı kullanan bir JavaScript işlevi gösterilmektedir. İşlev, kayıt tanımlayıcısı olan bir kuyruk iletisi tarafından tetikleniyor. İşlev, belirtilen kaydı okur ve özelliğini değiştirir Text .

function.json dosyasındaki bağlama verileri aşağıdadır:

{
"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"
    }
]
}

Yapılandırma bölümünde bu özellikler açıklanır.

JavaScript kodu şu şekildedir:

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

Giriş - öznitelikler

C# sınıf kitaplıklarında MobileTable özniteliğini kullanın.

Yapılandırabileceğiniz öznitelik özellikleri hakkında bilgi için aşağıdaki yapılandırma bölümüne bakın.

Giriş - yapılandırma

Aşağıdaki tabloda, function.json dosyasında ve MobileTable özniteliğinde ayarladığınız bağlama yapılandırma özellikleri açıklanmaktadır.

function.json özelliği	Öznitelik özelliği	Açıklama
type	yok	"mobileTable" olarak ayarlanmalıdır
direction	yok	"in" olarak ayarlanmalıdır
ad	yok	İşlev imzasında giriş parametresinin adı.
tableName	TableName	Mobil uygulamanın veri tablosunun adı
id	Kimlik	Alınacak kaydın tanımlayıcısı. Statik olabilir veya işlevi çağıran tetikleyiciye bağlı olabilir. Örneğin, işleviniz için bir kuyruk tetikleyicisi kullanıyorsanız, `"id": "{queueTrigger}"` kuyruk iletisinin dize değerini alınacak kayıt kimliği olarak kullanır.
bağlantı	Bağlantı	Mobil uygulamanın URL'sini içeren bir uygulama ayarının adı. İşlev, mobil uygulamanızda gerekli REST işlemlerini oluşturmak için bu URL'yi kullanır. İşlev uygulamanızda mobil uygulamanın URL'sini içeren bir uygulama ayarı oluşturun, ardından giriş bağlamanızdaki özelliğinde uygulama ayarının `connection` adını belirtin. URL şuna benzer `https://<appname>.azurewebsites.net`: .
apiKey	ApiKey	Mobil uygulamanızın API anahtarını içeren bir uygulama ayarının adı. Node.js mobil uygulamanızda bir API anahtarı uygularsanız veya .NET mobil uygulamanızda bir API anahtarı uygularsanız API anahtarını sağlayın. Anahtarı sağlamak için işlev uygulamanızda API anahtarını içeren bir uygulama ayarı oluşturun, ardından giriş bağlamanıza uygulama ayarının adıyla özelliğini ekleyin `apiKey` .

Yerel olarak geliştirme yaparken uygulama ayarlarınızı koleksiyondaki local.settings.json dosyasına Values ekleyin.

Önemli

API anahtarını mobil uygulama istemcilerinizle paylaşmayın. Yalnızca Azure İşlevleri gibi hizmet tarafı istemcilere güvenli bir şekilde dağıtılmalıdır. Azure İşlevleri bağlantı bilgilerinizi ve API anahtarlarınızı uygulama ayarları olarak depolar, böylece bunlar kaynak denetim deponuzda denetlenemez. Bu, hassas bilgilerinizi korur.

Giriş - kullanım

C# işlevlerinde, belirtilen kimliği içeren kayıt bulunduğunda adlandırılmış JObject parametresine geçirilir. Kayıt bulunamadığında parametre değeri şeklindedir null.

JavaScript işlevlerinde kayıt nesnesine context.bindings.<name> geçirilir. Kayıt bulunamadığında parametre değeri şeklindedir null.

C# ve F# işlevlerinde, giriş kaydında (giriş parametresi) yaptığınız tüm değişiklikler, işlev başarıyla çıktığında otomatik olarak tabloya geri gönderilir. JavaScript işlevlerinde kaydı değiştiremezsiniz.

Çıktı

Mobile Apps tablosuna yeni bir kayıt yazmak için Mobile Apps çıkış bağlamasını kullanın.

Çıkış - örnek

Aşağıdaki örnekte, bir kuyruk iletisi tarafından tetiklenen ve mobil uygulama tablosunda kayıt oluşturan bir C# işlevi gösterilmektedir.

[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}" };
}

Aşağıdaki örnekte, function.json dosyasında bir Mobile Apps çıkış bağlaması ve bağlamayı kullanan bir C# betik işlevi gösterilmektedir. İşlev bir kuyruk iletisi tarafından tetiklenerek özelliği için Text sabit kodlanmış değere sahip yeni bir kayıt oluşturur.

function.json dosyasındaki bağlama verileri aşağıdadır:

{
"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"
    }
]
}

Yapılandırma bölümünde bu özellikler açıklanır.

C# betik kodu aşağıdadır:

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

Aşağıdaki örnekte, bir function.json dosyasındaki Mobile Apps çıkış bağlaması ve bağlamayı kullanan bir JavaScript işlevi gösterilmektedir. İşlev bir kuyruk iletisi tarafından tetiklenerek özelliği için Text sabit kodlanmış değere sahip yeni bir kayıt oluşturur.

function.json dosyasındaki bağlama verileri aşağıdadır:

{
"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
}

Yapılandırma bölümünde bu özellikler açıklanır.

JavaScript kodu şu şekildedir:

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

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

Çıkış - öznitelikler

C# sınıf kitaplıklarında MobileTable özniteliğini kullanın.

Yapılandırabileceğiniz öznitelik özellikleri hakkında bilgi için bkz . Çıkış - yapılandırma. Yöntem imzasında bir MobileTable öznitelik örneği aşağıda verilmişti:

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

Çıkış - yapılandırma

Aşağıdaki tabloda, function.json dosyasında ve MobileTable özniteliğinde ayarladığınız bağlama yapılandırma özellikleri açıklanmaktadır.

function.json özelliği	Öznitelik özelliği	Açıklama
type	yok	"mobileTable" olarak ayarlanmalıdır
direction	yok	"Out" olarak ayarlanmalıdır
ad	yok	İşlev imzasında çıkış parametresinin adı.
tableName	TableName	Mobil uygulamanın veri tablosunun adı
bağlantı	MobileAppUriSetting	Mobil uygulamanın URL'sini içeren bir uygulama ayarının adı. İşlev, mobil uygulamanızda gerekli REST işlemlerini oluşturmak için bu URL'yi kullanır. İşlev uygulamanızda mobil uygulamanın URL'sini içeren bir uygulama ayarı oluşturun, ardından giriş bağlamanızdaki özelliğinde uygulama ayarının `connection` adını belirtin. URL şuna benzer `https://<appname>.azurewebsites.net`: .
apiKey	ApiKeySetting	Mobil uygulamanızın API anahtarını içeren bir uygulama ayarının adı. Node.js mobil uygulama arka ucunuzda bir API anahtarı uygularsanız veya .NET mobil uygulama arka ucunuzda bir API anahtarı uygularsanız API anahtarını sağlayın. Anahtarı sağlamak için işlev uygulamanızda API anahtarını içeren bir uygulama ayarı oluşturun, ardından giriş bağlamanıza uygulama ayarının adıyla özelliğini ekleyin `apiKey` .

Yerel olarak geliştirme yaparken uygulama ayarlarınızı koleksiyondaki local.settings.json dosyasına Values ekleyin.

Önemli

Çıkış - kullanım

C# betik işlevlerinde, çıkış kaydına erişmek için türünde out object adlandırılmış bir çıkış parametresi kullanın. C# sınıf kitaplıklarında özniteliği MobileTable aşağıdaki türlerden herhangi biriyle kullanılabilir:

ICollector<T>veya IAsyncCollector<T>, burada T veya özelliği olan herhangi bir public string Id türdürJObject.
out JObject
out T veya out T[], burada T özelliği olan herhangi bir public string Id Türdür.

Node.js işlevlerinde çıkış kaydına erişmek için kullanın context.bindings.<name> .

Sonraki adımlar

Azure işlevleri tetikleyicileri ve bağlamaları hakkında daha fazla bilgi edinin

Aracılığıyla paylaş

Azure İşlevleri için Mobile Apps bağlamaları

Paketler - İşlevler 1.x

Giriş

Giriş - örnek

Giriş - öznitelikler

Giriş - yapılandırma

Giriş - kullanım

Çıktı

Çıkış - örnek

Çıkış - öznitelikler

Çıkış - yapılandırma

Çıkış - kullanım

Sonraki adımlar

Geri Bildirim

Ek kaynaklar