Mobile Apps Node.js SDK の使用方法

[アーティクル]
10/01/2016

この記事では、Azure App Service の Mobile Apps 機能で Node.js バックエンドを使用する方法についての詳細な情報と例を提供します。

はじめに

Mobile Apps は、Web アプリケーションにモバイルに最適化されたデータアクセス Web API を追加する機能を提供します。 Mobile Apps SDK は、ASP.NET と Node.js の Web アプリケーション向けに用意されています。この SDK を使用すると、次の処理を実行できます。

データアクセスのためのテーブル操作 (読み取り、挿入、更新、削除)
カスタム API 操作

どちらの操作も、Azure App Service が許可するすべての ID プロバイダーに認証を提供します。このようなプロバイダーには、Facebook、Twitter、Google、Microsoft などのソーシャル ID プロバイダー、エンタープライズ ID のための Azure Active Directory などがあります。

各ユースケースのサンプルは、 GitHub の samples ディレクトリにあります。

サポートされているプラットフォーム

Mobile Apps Node.js SDK は、Node の現在の LTS リリース以降をサポートします。現在、最新の LTS バージョンは Node v4.5.0 です。 Node の他のバージョンが動作する場合もありますが、サポートされているわけではありません。

Mobile Apps Node.js SDK は、次の 2 つのデータベースドライバーをサポートしています。

node-mssql ドライバーは、Azure SQL Database とローカルの SQL Server インスタンスをサポートしています。
sqlite3 ドライバーは、単一のインスタンスでのみ、SQLite データベースをサポートします。

コマンドラインを使用して基本的な Node.js バックエンドを作成する

Mobile Apps Node.js バックエンドはすべて ExpressJS アプリケーションとして開始されます。 ExpressJS は、Node.js で使用可能な最も人気のある Web サービスフレームワークです。次のように、基本的な Express アプリケーションを作成できます。

コマンドウィンドウまたは PowerShell ウィンドウで、プロジェクトのディレクトリを作成します。
```
 mkdir basicapp
```
npm init を実行して、パッケージの構造を初期化します。
```
 cd basicapp
 npm init
```
npm init コマンドでは、プロジェクトを初期化するための一連の質問が示されます。次の出力例を参照してください。
npm リポジトリから express ライブラリと azure-mobile-apps ライブラリをインストールします。
```
 npm install --save express azure-mobile-apps
```

app.js ファイルを作成して、基本的なモバイルサーバーを実装します。

var express = require('express'),
    azureMobileApps = require('azure-mobile-apps');

var app = express(),
    mobile = azureMobileApps();

// Define a TodoItem table.
mobile.tables.add('TodoItem');

// Add the Mobile API so it is accessible as a Web API.
app.use(mobile);

// Start listening on HTTP.
app.listen(process.env.PORT || 3000);

このアプリケーションは、単一のエンドポイント (/tables/TodoItem) でモバイルに最適化された Web API を作成します。この Web API は、動的スキーマを使用して基になる SQL データストアへの認証されていないアクセスを可能にします。次のクライアントライブラリのクイックスタートに従う場合に適しています。

この基本的なアプリケーションのコードは、 GitHub の basicapp サンプルにあります。

Visual Studio 2015 を使用して Node.js バックエンドを作成する

Visual Studio 2015 には、IDE 内で Node.js アプリケーションを開発するための拡張機能が必要です。まず、 Node.js Tools 1.1 for Visual Studioをインストールします。インストールが完了したら、Express 4.x アプリケーションを作成します。

[新しいプロジェクト] ダイアログボックスを開きます ([ファイル]>[新規作成]>[プロジェクト] の順にクリックします)。
テンプレート JavaScript>>Node.jsを展開します。
[Basic Azure Node.js Express 4 Application] を選択します。
プロジェクト名を入力します。 [OK] を選択します。
npm ノードを右クリックし、[新しいnpm パッケージのインストール] を選択します。
最初のNode.js アプリケーションを作成した後、npm カタログの更新が必要になる場合があります。必要に 応じて [最新の情報に更新] を選択します。
検索ボックスに「 azure-mobile-apps 」と入力します。 azure-mobile-apps 2.0.0 パッケージを選択し、[パッケージのインストール] を選択します。
[閉じる] を選びます。
app.js ファイルを開き、Mobile Apps SDK のサポートを追加します。ライブラリの require ステートメントの下の 6 行目に、次のコードを追加します。
```
var bodyParser = require('body-parser');
var azureMobileApps = require('azure-mobile-apps');
```
他の app.use ステートメントの後の約 27 行目に、次のコードを追加します。
```
app.use('/users', users);

// Mobile Apps initialization
var mobile = azureMobileApps();
mobile.tables.add('TodoItem');
app.use(mobile);
```
ファイルを保存します。
アプリケーションをローカルで実行するか (API は https://localhost:3000 で動作します)、Azure に発行します。

Azure Portal を使用して Node.js バックエンドを作成する

Mobile Apps バックエンドは、Azure Portal ですぐに作成できます。次の手順を実行するか、モバイルアプリの作成のチュートリアルに従ってクライアントとサーバーをまとめて作成することもできます。このチュートリアルにはこれらの手順の簡略化されたバージョンが含まれており、プロジェクトの概念の実証に最適です。

Azure Portal にサインインします。
[+新しい>Web + モバイル>モバイルアプリ] を選択し、Mobile Apps バックエンドの名前を指定します。
[リソースグループ] で、既存のリソースグループを選択するか、新しく作成します (アプリと同じ名前を使用)。
[App Service プラン] では、既定のプラン (Standard レベル) が選択されています。別のプランを選択することも、新しいプランを作成することもできます。

App Service プランの設定により、アプリに関連付けられる場所、機能、コスト、コンピューティングリソースが決まります。 App Services プランの詳細と、さまざまな価格レベルおよび目的の場所で新しいプランを作成する方法については、「Azure App Service プランの概要」を参照してください。
［作成］ を選択しますこの手順により、Mobile Apps バックエンドが作成されます。
新しい Mobile Apps バックエンドの [設定] ウィンドウで、データベースConnectクライアントアプリプラットフォーム>のクイックスタート>を選択します。
[データ接続の追加] ウィンドウで、[SQL Database]>[新しいデータベースの作成] の順に選択します。データベース名を入力し、価格レベルを選択して、[サーバー] を選択します。この新しいデータベースは再利用できます。同じ場所に既にデータベースを所有している場合は、代わりに [既存のデータベースの使用]を選択することもできます。別の場所にあるデータベースを使用することはお勧めしません。このようなデータベースを使用すると、帯域幅コストと待機時間が増加します。
[新しいサーバー] ウィンドウで、[サーバー名] ボックスに一意のサーバー名を入力し、ログインとパスワードを指定して、[Azure サービスにサーバーへのアクセスを許可する]、[OK] の順に選択します。この手順により、新しいデータベースが作成されます。
[データ接続の追加] ウィンドウに戻り、[接続文字列] を選択し、データベースのログインとパスワードの値を入力して、[OK] を選択します。

データベースが正常にデプロイされるまで数分待ってから、次の手順に進んでください。

[テーブル API の作成] の [はじめに] ウィンドウに戻り、バックエンド言語として [Node.js] を選択します。 [これにより、すべてのサイトコンテンツが上書きされることを確認しました。] のボックスをオンにし、[TodoItem テーブルを作成する] を選択します。

Git を使用して Node.js バックエンドクイックスタートコードプロジェクトをダウンロードする

ポータルの [クイックスタート] ウィンドウを使用して Node.js Mobile Apps バックエンドを作成すると、Node.js プロジェクトが自動的に作成され、サイトにデプロイされます。ポータルでは、テーブルと API を追加し、Node.js バックエンドのコードファイルを編集することができます。また、さまざまなデプロイツールを使用してバックエンドプロジェクトをダウンロードすると、テーブルと API を追加または変更した後でプロジェクトを再発行できます。詳細については、Azure App Service のデプロイガイドに関するページを参照してください。

次の手順では、Git リポジトリを使用して、クイックスタートプロジェクトのコードをダウンロードします。

Git をまだインストールしていない場合はインストールします。 Git をインストールするために必要な手順は、オペレーティングシステムによって異なります。オペレーティングシステム固有の配布とインストールのガイダンスについては、Git のインストールに関するページを参照してください。
バックエンドサイトの Git リポジトリを有効にする方法については、「リポジトリを準備する」を参照してください。デプロイ用のユーザー名とパスワードをメモしておきます。
Mobile Apps バックエンドのウィンドウで、[Git クローン URL] の設定をメモしておきます。
Git クローン URL を使用して git clone コマンドを実行します。次の例のように、必要に応じてパスワードを入力します。
```
 $ git clone https://username@todolist.scm.azurewebsites.net:443/todolist.git
```
ローカルディレクトリ (前の例では /todolist) を参照し、プロジェクトファイルがダウンロードされていることを確認します。 /tables ディレクトリ内にある todoitem.json ファイルを見つけます。このファイルでは、テーブルに対するアクセス許可を定義します。同じディレクトリ内にある todoitem.js ファイルも見つけます。このファイルには、テーブルの CRUD 操作スクリプトが定義されています。
プロジェクトファイルを変更した後、次のコマンドを実行して変更を追加してコミットし、サイトにアップロードします。
```
 $ git commit -m "updated the table script"
 $ git push origin master
```
新しいファイルをプロジェクトに追加する場合は、最初に git add . コマンドを実行する必要があります。

一連の新しいコミットがサイトにプッシュされるたびに、そのサイトは再発行されます。

Azure に Node.js バックエンドを発行する

Microsoft Azure では、Azure サービスに Mobile Apps Node.js バックエンドを発行するための多数のメカニズムが提供されます。これらのメカニズムには、Visual Studio に統合されたデプロイツール、コマンドラインツール、ソース管理に基づく継続的なデプロイオプションも含まれます。詳細については、Azure App Service のデプロイガイドに関するページを参照してください。

Azure App Service には、バックエンドを公開する前に確認する必要がある Node.js アプリケーションに関する具体的なアドバイスがあります。

アプリケーションのホームページを有効にする

多くのアプリケーションは、Web アプリとモバイルアプリの組み合わせです。 ExpressJS フレームワークを使用すると、2 つのファセットを結合することができます。ただし、モバイルインターフェイスのみを実装する場合もあります。アプリサービスを確実に稼動させるために、ホームページを用意すると便利です。ホームページを指定するか、一時的なホームページを有効にします。一時的なホームページを有効にするには、次のコードを使用して Mobile Apps をインスタンス化します。

var mobile = azureMobileApps({ homePage: true });

ローカルで開発するときにのみ、このオプションを利用する場合は、この設定を azureMobile.js ファイルに追加します。

テーブルの操作

azure-mobile-apps Node.js Server SDK では、Web API として Azure SQL Database に格納されたデータテーブルを公開するためのメカニズムが提供されます。以下の 5 つの操作が提供されます。

操作	説明
GET /tables/tablename	テーブルのすべてのレコードを取得します。
GET /tables/tablename/:id	テーブルの特定のレコードを取得します。
POST /tables/tablename	テーブルのレコードを作成します。
PATCH /tables/tablename/:id	テーブルのレコードを更新します。
DELETE /tables/tablename/:id	テーブルのレコードを削除します。

この Web API は OData をサポートし、テーブルスキーマを拡張してオフラインデータ同期をサポートします。

動的スキーマを使用してテーブルを定義する

テーブルを使用する前に、テーブルを定義する必要があります。静的スキーマで (スキーマ内の列を定義する場合)、または動的に (SDK が受信要求に基づいてスキーマを制御する場合) テーブルを定義できます。さらに、定義に JavaScript コードを追加することで、Web API の特定の側面を制御できます。

ベストプラクティスとして、tables ディレクトリ内の JavaScript ファイルに各テーブルを定義し、tables.import() メソッドを使用してテーブルをインポートする必要があります。 basic-app サンプルを拡張して、app.js ファイルを次のように調整します。

var express = require('express'),
    azureMobileApps = require('azure-mobile-apps');

var app = express(),
    mobile = azureMobileApps();

// Define the database schema that is exposed.
mobile.tables.import('./tables');

// Provide initialization of any tables that are statically defined.
mobile.tables.initialize().then(function () {
    // Add the Mobile API so it is accessible as a Web API.
    app.use(mobile);

    // Start listening on HTTP.
    app.listen(process.env.PORT || 3000);
});

次のように ./tables/TodoItem.js にテーブルを定義します。

var azureMobileApps = require('azure-mobile-apps');

var table = azureMobileApps.table();

// Additional configuration for the table goes here.

module.exports = table;

テーブルでは、既定で動的スキーマが使用されます。動的スキーマをグローバルに無効にするには、Azure Portal で MS_DynamicSchema アプリ設定を false に設定します。

完全な例は GitHub の todo サンプルにあります。

静的スキーマを使用してテーブルを定義する

Web API を使用して公開する列を明示的に定義することができます。 azure-mobile-apps Node.js SDK では、オフラインデータ同期に必要なその他の列が指定したリストに自動的に追加されます。たとえば、クイックスタートクライアントアプリケーションには、text (文字列) と complete (ブール値) という 2 つの列を持つテーブルが必要になります。
このテーブルは、次のように、(tables ディレクトリにある) テーブル定義 JavaScript ファイルで定義できます。

var azureMobileApps = require('azure-mobile-apps');

var table = azureMobileApps.table();

// Define the columns within the table.
table.columns = {
    "text": "string",
    "complete": "boolean"
};

// Turn off the dynamic schema.
table.dynamicSchema = false;

module.exports = table;

静的にテーブルを定義する場合は、tables.initialize() メソッドを呼び出して起動時にデータベーススキーマを作成する必要もあります。 Web サービスがデータベースの初期化前に要求を処理しないように、tables.initialize() メソッドは promise を返します。

ローカルコンピューター上で開発データストアとして SQL Server Express を使用する

Mobile Apps Node.js SDK には、すぐに利用できるデータを提供する 3 つのオプションが用意されています。

メモリ ドライバーを使用して、非永続ストアの例を提供します。
mssql ドライバーを使用して、開発用の SQL Server Express データストアを提供します。
mssql ドライバーを使用して、運用環境の Azure SQL Database データストアを提供します。

Mobile Apps Node.js SDK では mssql Node.js パッケージを使用して、SQL Server Express と SQL Database 両方への接続を確立および使用します。このパッケージでは、SQL Server Express インスタンスで TCP 接続を有効にする必要があります。

ヒント

メモリドライバーでは、テスト用の完全な機能セットは提供されません。ローカルでバックエンドをテストする場合は、SQL Server Express データストアと mssql ドライバーを使用することをお勧めします。

Microsoft SQL Server 2014 Expressをダウンロードしてインストールします。必ず、SQL Server 2014 Express with Tools エディションをインストールしてください。 64 ビットサポートを明示的に要求した場合を除き、32 ビット版を使用することで実行時のメモリ使用量が少なくなります。
SQL Server 2014 構成マネージャーを実行します。

a。ツリーメニューの [SQL Server ネットワークの構成] ノードを展開します。

b. [SQLEXPRESS のプロトコル] を選択します。

c. [TCP/IP] を右クリックし、 [有効化] を選択します。ポップアップダイアログボックスで [OK] を選択します。

d. [TCP/IP] を右クリックし、[プロパティ] を選択します。

e. [IP アドレス] タブを選択します。

f. [IPAll] ノードを見つけます。 [TCP ポート] フィールドに、「1433」と入力します。

g. [OK] を選択します。ポップアップダイアログボックスで [OK] を選択します。

h. ツリーメニューの [SQL Server のサービス] を選択します。

i. [SQL Server (SQLEXPRESS)] を右クリックし、[再起動] を選択します。

j. SQL Server 2014 構成マネージャーを閉じます。
SQL Server 2014 Management Studio を実行して、ローカルの SQL Server Express インスタンスに接続します。
1. オブジェクトエクスプローラーでインスタンスを右クリックし、[プロパティ] を選択します。
2. [セキュリティ] ページを選択します。
3. [SQL Server 認証モードと Windows 認証モード] が選択されていることを確認します。
4. [OK] を選択します。
5. オブジェクトエクスプローラーの [セキュリティ>ログイン] を展開します。
6. [ログイン] を右クリックし、[新しいログイン] を選択します。
7. ログイン名を入力します。 [SQL Server 認証] をクリックします。パスワードを入力し、[パスワードの確認入力] に同じパスワードを入力します。パスワードは、Windows の複雑さの要件を満たしている必要があります。
8. [OK] を選択します。
9. 新しいログインを右クリックし、[ プロパティ] を選択します。
10. [サーバーロール] ページを選択します。
11. dbcreator サーバーロールのチェックボックスをオンにします。
12. [OK] を選択します。
13. SQL Server 2015 Management Studio を閉じます。

選択したユーザー名とパスワードは必ずメモしておきます。データベースの要件に応じて、追加のサーバーロールまたはアクセス許可を割り当てる必要がある場合があります。

Node.js アプリケーションは、SQLCONNSTR_MS_TableConnectionString 環境変数を読み取って、このデータベースの接続文字列を確認します。ご使用の環境にこの変数を設定できます。たとえば、PowerShell を使用して、以下のようにこの環境変数を設定することができます。

$env:SQLCONNSTR_MS_TableConnectionString = "Server=127.0.0.1; Database=mytestdatabase; User Id=azuremobile; Password=T3stPa55word;"

TCP/IP 接続を介してデータベースにアクセスします。接続に使用するユーザー名とパスワードを入力します。

ローカル開発用のプロジェクトを構成する

Mobile Apps は、ローカルファイルシステムから azureMobile.js という JavaScript ファイルを読み取ります。運用環境の Mobile Apps SDK の構成にはこのファイルを使用しないでください。代わりに、Azure portalでアプリ設定を使用します。

azureMobile.js ファイルでは構成オブジェクトをエクスポートする必要があります。最も一般的な設定は次のとおりです。

データベース設定
診断ログ設定
代替 CORS 設定

前のデータベース設定を実装する azureMobile.js ファイルの例を次に示します。

module.exports = {
    cors: {
        origins: [ 'localhost' ]
    },
    data: {
        provider: 'mssql',
        server: '127.0.0.1',
        database: 'mytestdatabase',
        user: 'azuremobile',
        password: 'T3stPa55word'
    },
    logging: {
        level: 'verbose'
    }
};

パスワードが クラウドに格納 されないように、 .gitignore ファイル (または他のソースコード管理の無視ファイル) にazureMobile.jsを追加することをお勧めします。運用環境の設定は、必ず Azure Portal の [アプリ設定] で構成してください。

モバイルアプリのアプリ設定を構成する

azureMobile.js ファイル内のほとんどの設定には、Azure Portal 内に対応するアプリ設定があります。次の一覧を参照して、 [アプリ設定] でアプリを構成してください。

アプリ設定	azureMobile.js setting	説明	有効な値
MS_MobileAppName	name	アプリの名前	string
MS_MobileLoggingLevel	logging.level	ログ記録するメッセージの最小ログレベル	error、warning、info、verbose、debug、silly
MS_DebugMode	debug	デバッグモードを有効または無効にします	true、false
MS_TableSchema	data.schema	SQL テーブルの既定のスキーマ名	string (既定: dbo)
MS_DynamicSchema	data.dynamicSchema	デバッグモードを有効または無効にします	true、false
MS_DisableVersionHeader	version (undefined に設定)	X-ZUMO-Server-Version ヘッダーの無効化	true、false
MS_SkipVersionCheck	skipversioncheck	クライアント API バージョンチェックの無効化	true、false

アプリ設定を設定するには:

Azure portal にサインインします。
[すべてのリソース] または [App Services] を選択し、モバイルアプリの名前をクリックします。
[設定] ウィンドウが既定で開きます。開かない場合は、[すべての設定] を選択します。
[全般] メニューの [アプリケーション設定] を選択します。
[ アプリの設定] セクションまでスクロールします。
アプリ設定が既に存在する場合は、アプリ設定の値を選択して値を編集します。アプリ設定が存在しない場合は、[キー] ボックスにアプリ設定を入力し、[値] ボックスに値を入力します。
[保存] を選択します。

ほとんどのアプリ設定を変更した場合、サービスの再起動が必要になります。

SQL Database を運用データストアとして使用する

Azure SQL Database をデータストアとして使用する方法は、Azure App Service アプリケーションのすべての種類で同じです。 Mobile Apps バックエンドをまだ作成していない場合は、次の手順に従って作成します。

Azure portal にサインインします。
ウィンドウの左上にある [+NEW] ボタン [Web + モバイル>モバイルアプリ] を>選択し、Mobile Apps バックエンドの名前を指定します。
[リソースグループ] ボックスで、アプリと同じ名前を入力します。
既定の App Service プランが選択されています。 App Service プランを変更する場合:

a。 [プラン>App Service+ 新規作成] を選択します。

b. 新しい App Service プランの名前を指定し、適切な場所を選択します。

c. サービスの適切な価格レベルを選択します。 [すべて表示] を選択して、Free や Shared などの価格オプションをさらに表示します。

d. [選択] ボタンをクリックします。

e. [App Service プラン] ウィンドウに戻り、[OK] を選択します。
［作成］ を選択します

Mobile Apps バックエンドのプロビジョニングには数分かかる場合があります。 Mobile Apps バックエンドのプロビジョニングが完了すると、ポータルで Mobile Apps バックエンドの [設定] ウィンドウが開きます。

既存の SQL データベースを Mobile Apps バックエンドに接続するか、新しい SQL データベースを作成するかを選択できます。このセクションでは、SQL データベースを作成します。

注意

Mobile Apps バックエンドと同じ場所に、既にデータベースがある場合は、[既存のデータベースを使用する] を選択すると、そのデータベースを選択できます。別の場所にあるデータベースを使用すると、待機時間が増加するため、これはお勧めできません。

新しい Mobile Apps バックエンドで、設定>Mobile App>Data>+ Add を選択します。
[データ接続の追加] ウィンドウで、[SQL Database - 必要な設定の構成]>[新しいデータベースの作成] の順に選択します。 [名前] ボックスに新しいデータベースの名前を入力します。
[ サーバー] を選択します。 [新しいサーバー] ウィンドウで、[サーバー名] ボックスに一意のサーバー名を入力し、サーバー管理ログインとパスワードに適切な内容を指定します。 [Azure サービスにサーバーへのアクセスを許可する] が選択されていることを確認します。 [OK] を選択します。
[新しいデータベース] ウィンドウで、[OK] を選択します。
[データ接続の追加] ウィンドウに戻り、[接続文字列] を選択して、データベースの作成時に指定したログイン名とパスワードを入力します。既存のデータベースを使用する場合は、そのデータベースのログイン資格情報を入力します。 [OK] を選択します。
もう一度 [データ接続の追加] ウィンドウに戻り、[OK] を選択してデータベースを作成します。

データベースの作成には数分かかる場合があります。 [通知] 領域を使用して、デプロイの進行状況を監視します。データベースのデプロイが正常に完了するまで、先に進まないでください。データベースがデプロイされると、Mobile Apps バックエンドの [アプリ設定] で、SQL データベースインスタンスの接続文字列が作成されます。このアプリ設定は、設定>Application 設定>の接続文字列で確認できます。

テーブルへのアクセスに認証を要求する

エンドポイントでtablesApp Service認証を使用する場合は、最初にAzure portalでApp Service認証を構成する必要があります。詳細については、使用する ID プロバイダーの構成ガイドを参照してください。

各テーブルには、テーブルへのアクセスを制御するために使用できる access プロパティがあります。次のサンプルでは、認証を必要とする静的に定義されたテーブルを示します。

var azureMobileApps = require('azure-mobile-apps');

var table = azureMobileApps.table();

// Define the columns within the table.
table.columns = {
    "text": "string",
    "complete": "boolean"
};

// Turn off the dynamic schema.
table.dynamicSchema = false;

// Require authentication to access the table.
table.access = 'authenticated';

module.exports = table;

access プロパティには、次の 3 つの値を使用できます。

anonymous は、認証なしでデータを読み取る許可をクライアントアプリケーションに与えることを示します。
authenticated は、クライアントアプリケーションが要求で有効な認証トークンを送信する必要があることを示します。
disabled は、このテーブルが現在無効になっていることを示します。

access プロパティが定義されていない場合は、非認証アクセスが許可されます。

テーブルで認証要求を使用する

認証が設定されている場合、要求されている各種要求を設定できます。これらの要求は context.user オブジェクトでは通常使用できません。ただし、context.user.getIdentity() メソッドを使用して取得できます。 getIdentity() メソッドは、オブジェクトに解決される promise を返します。オブジェクトのキーは、認証方法 (facebook、google、twitter、microsoftaccount、aad) に設定されます。

たとえば、Microsoft アカウント認証を設定し、電子メールアドレス要求を要求する場合は、次のテーブルコントローラーを使用してレコードに電子メールアドレスを追加できます。

var azureMobileApps = require('azure-mobile-apps');

// Create a new table definition.
var table = azureMobileApps.table();

table.columns = {
    "emailAddress": "string",
    "text": "string",
    "complete": "boolean"
};
table.dynamicSchema = false;
table.access = 'authenticated';

/**
* Limit the context query to those records with the authenticated user email address
* @param {Context} context the operation context
* @returns {Promise} context execution Promise
*/
function queryContextForEmail(context) {
    return context.user.getIdentity().then((data) => {
        context.query.where({ emailAddress: data.microsoftaccount.claims.emailaddress });
        return context.execute();
    });
}

/**
* Adds the email address from the claims to the context item - used for
* insert operations
* @param {Context} context the operation context
* @returns {Promise} context execution Promise
*/
function addEmailToContext(context) {
    return context.user.getIdentity().then((data) => {
        context.item.emailAddress = data.microsoftaccount.claims.emailaddress;
        return context.execute();
    });
}

// Configure specific code when the client does a request.
// READ: only return records that belong to the authenticated user.
table.read(queryContextForEmail);

// CREATE: add or overwrite the userId based on the authenticated user.
table.insert(addEmailToContext);

// UPDATE: only allow updating of records that belong to the authenticated user.
table.update(queryContextForEmail);

// DELETE: only allow deletion of records that belong to the authenticated user.
table.delete(queryContextForEmail);

module.exports = table;

どのような要求が使用できるかを確認するには、Web ブラウザーを使用し、サイトの /.auth/me エンドポイントを表示します。

特定のテーブル操作へのアクセスを無効にする

テーブルでの表示だけでなく、個々の操作を制御するために access プロパティを使用できます。操作には以下の 4 つがあります。

read は、テーブルに対する RESTful GET 操作です。
insert は、テーブルに対する RESTful POST 操作です。
update は、テーブルに対する RESTful PATCH 操作です。
delete は、テーブルに対する RESTful DELETE 操作です。

たとえば、読み取り専用の認証されていないテーブルを指定できます。

var azureMobileApps = require('azure-mobile-apps');

var table = azureMobileApps.table();

// Read-only table. Only allow READ operations.
table.read.access = 'anonymous';
table.insert.access = 'disabled';
table.update.access = 'disabled';
table.delete.access = 'disabled';

module.exports = table;

テーブル操作で使用されるクエリを調整する

テーブル操作の一般的な要件は、データの制限付きビューを提供することです。たとえば、ユーザーが独自のレコードの読み取りまたは更新のみを実行できるように、認証済みユーザー ID でタグ付けされているテーブルを提供できます。次のテーブル定義では、この機能を提供しています。

var azureMobileApps = require('azure-mobile-apps');

var table = azureMobileApps.table();

// Define a static schema for the table.
table.columns = {
    "userId": "string",
    "text": "string",
    "complete": "boolean"
};
table.dynamicSchema = false;

// Require authentication for this table.
table.access = 'authenticated';

// Ensure that only records for the authenticated user are retrieved.
table.read(function (context) {
    context.query.where({ userId: context.user.id });
    return context.execute();
});

// When adding records, add or overwrite the userId with the authenticated user.
table.insert(function (context) {
    context.item.userId = context.user.id;
    return context.execute();
});

module.exports = table;

通常はクエリを実行する操作には、where 句で調整できる query プロパティがあります。 query プロパティは QueryJS オブジェクトであり、これを使用して、データバックエンドで処理できるものに OData クエリを変換します。 (上記のような) 単純な等式の場合は、マップを使用できます。また、特定の SQL 句を追加することもできます。

context.query.where('myfield eq ?', 'value');

テーブルの論理削除を構成する

論理削除では実際にレコードは削除されません。代わりに、削除列を true に設定して、データベース内のレコードを削除済みとしてマークします。 Mobile Client SDK で IncludeDeleted() が使用されない限り、Mobile Apps SDK によって結果から論理削除レコードが自動的に削除されます。論理削除のテーブルを構成するには、テーブル定義ファイルで softDelete プロパティを設定します。

var azureMobileApps = require('azure-mobile-apps');

var table = azureMobileApps.table();

// Define the columns within the table.
table.columns = {
    "text": "string",
    "complete": "boolean"
};

// Turn off the dynamic schema.
table.dynamicSchema = false;

// Turn on soft delete.
table.softDelete = true;

// Require authentication to access the table.
table.access = 'authenticated';

module.exports = table;

クライアントアプリケーション、WebJob、Azure 関数、カスタム API など、レコードを削除するためのメカニズムを確立する必要があります。

データベースに対するデータのシード処理を実行する

新しいアプリケーションを作成する場合、データでのテーブルのシード処理が必要になることがあります。これは、以下のようにテーブル定義 JavaScript ファイル内で行うことができます。

var azureMobileApps = require('azure-mobile-apps');

var table = azureMobileApps.table();

// Define the columns within the table.
table.columns = {
    "text": "string",
    "complete": "boolean"
};
table.seed = [
    { text: 'Example 1', complete: false },
    { text: 'Example 2', complete: true }
];

// Turn off the dynamic schema.
table.dynamicSchema = false;

// Require authentication to access the table.
table.access = 'authenticated';

module.exports = table;

データのシード処理は、Mobile Apps SDK を使用してテーブルを作成した場合にのみ発生します。データベースにテーブルが既に存在する場合、テーブルにデータは挿入されません。動的スキーマが有効になっている場合、スキーマはシード処理されたデータから推論されます。

tables.initialize() メソッドを明示的に呼び出して、サービスの実行開始時にテーブルを作成することをお勧めします。

Swagger のサポートを有効にする

Mobile Apps には、組み込みの Swagger のサポートが付属しています。 Swagger のサポートを有効にするには、最初に依存関係として swagger ui をインストールします。

npm install --save swagger-ui

インストール後は Mobile Apps コンストラクターで Swagger のサポートを有効にすることができます。

var mobile = azureMobileApps({ swagger: true });

開発エディションでのみ Swagger サポートを有効にするには、 NODE_ENV アプリ設定を使用します。

var mobile = azureMobileApps({ swagger: process.env.NODE_ENV !== 'production' });

swagger エンドポイントは、http://自分のサイト.azurewebsites.net/swagger にあります。 Swagger UI には、 /swagger/ui エンドポイントからアクセスできます。アプリケーション全体で認証を必要とする場合、エラーが生成されます。最良の結果を得るには、Azure App Service の [認証/承認] 設定で認証されていない要求を許可し、table.access プロパティを使用して認証を制御します。

また、ローカルで開発する場合にのみ、Swagger のサポートが必要な場合は、azureMobile.js ファイルに Swagger オプションを追加できます。

プッシュ通知

Mobile Apps と Azure Notification Hubs を統合することで、あらゆる主要なプラットフォーム間で、数百万台のデバイスに対して、対象設定済みのプッシュ通知を送信できます。 Notification Hubs を使用して、iOS デバイス、Android デバイス、および Windows デバイスにプッシュ通知を送信できます。 Notification Hubs で実行可能なすべての操作については、「Azure 通知ハブ」を参照してください。

プッシュ通知を送信する

次のコードに、push オブジェクトを使用して、登録済みの iOS デバイスにブロードキャストプッシュ通知を送信する方法を示します。

// Create an APNS payload.
var payload = '{"aps": {"alert": "This is an APNS payload."}}';

// Only do the push if configured.
if (context.push) {
    // Send a push notification by using APNS.
    context.push.apns.send(null, payload, function (error) {
        if (error) {
            // Do something or log the error.
        }
    });
}

クライアントからテンプレートプッシュ登録を作成することで、代わりに、サポートされるすべてのプラットフォーム上のデバイスにテンプレートプッシュメッセージを送信できます。次のコードに、テンプレート通知を送信する方法を示します。

// Define the template payload.
var payload = '{"messageParam": "This is a template payload."}';

// Only do the push if configured.
if (context.push) {
    // Send a template notification.
    context.push.send(null, payload, function (error) {
        if (error) {
            // Do something or log the error.
        }
    });
}

タグを使用して認証済みのユーザーにプッシュ通知を送信する

認証済みのユーザーがプッシュ通知に登録すると、ユーザー ID タグが登録に自動的に追加されます。このタグを使用すると、特定のユーザーが登録したすべてのデバイスにプッシュ通知を送信できます。次のコードでは、要求を行ったユーザーの SID を取得し、そのユーザーのすべてのデバイス登録にテンプレートプッシュ通知を送信します。

// Only do the push if configured.
if (context.push) {
    // Send a notification to the current user.
    context.push.send(context.user.id, payload, function (error) {
        if (error) {
            // Do something or log the error.
        }
    });
}

認証されたクライアントからプッシュ通知を登録する場合は、登録を試みる前に、認証が完了していることを確認します。

カスタム API

カスタム API を定義する

/tables エンドポイント経由のデータアクセス API に加え、Mobile Apps ではカスタム API も提供できます。カスタム API はテーブル定義と同じような方法で定義され、認証を含む、すべての同じ機能にアクセスできます。

カスタム API で App Service 認証を使用する場合は、まず、Azure Portal で App Service 認証を構成する必要があります。詳細については、使用する ID プロバイダーの構成ガイドを参照してください。

カスタム API は、テーブル API とほぼ同じ方法で定義されます。

api ディレクトリを作成します。
api ディレクトリに API 定義 JavaScript ファイルを作成します。
import メソッドを使用して、api ディレクトリをインポートします。

前に使用した basic-app サンプルに基づくプロトタイプの API 定義を以下に示します。

var express = require('express'),
    azureMobileApps = require('azure-mobile-apps');

var app = express(),
    mobile = azureMobileApps();

// Import the custom API.
mobile.api.import('./api');

// Add the Mobile API so it is accessible as a Web API.
app.use(mobile);

// Start listening on HTTP
app.listen(process.env.PORT || 3000);

ここでは、Date.now() メソッドを使用してサーバーの日付を返す API の例を見てみましょう。 api/date.js ファイルを以下に示します。

var api = {
    get: function (req, res, next) {
        var date = { currentTime: Date.now() };
        res.status(200).type('application/json').send(date);
    });
};

module.exports = api;

各パラメーターは、標準的な RESTful 動詞 (GET、POST、PATCH または DELETE) のいずれかです。メソッドは、必要な出力を送信する標準的な ExpressJS ミドルウェア関数です。

カスタム API へのアクセスに認証を要求する

Mobile Apps SDK では、tables エンドポイントとカスタム API の両方に対して同じ方法で認証を実装します。前のセクションで開発した API に認証を追加するには、access プロパティを追加します。

var api = {
    get: function (req, res, next) {
        var date = { currentTime: Date.now() };
        res.status(200).type('application/json').send(date);
    });
};
// All methods must be authenticated.
api.access = 'authenticated';

module.exports = api;

以下のように、特定の操作で認証を指定することもできます。

var api = {
    get: function (req, res, next) {
        var date = { currentTime: Date.now() };
        res.status(200).type('application/json').send(date);
    }
};
// The GET methods must be authenticated.
api.get.access = 'authenticated';

module.exports = api;

認証を必要とするカスタム API には、tables エンドポイントで使用されるものと同じトークンを使用する必要があります。

大きなファイルのアップロードを処理する

Mobile Apps SDK では、body-parser ミドルウェアを使用して、送信された本文のコンテンツを受け入れ、デコードします。大きなファイルのアップロードを受け入れるように body-parser を事前構成できます。

var express = require('express'),
    bodyParser = require('body-parser'),
    azureMobileApps = require('azure-mobile-apps');

var app = express(),
    mobile = azureMobileApps();

// Set up large body content handling.
app.use(bodyParser.json({ limit: '50mb' }));
app.use(bodyParser.urlencoded({ limit: '50mb', extended: true }));

// Import the custom API.
mobile.api.import('./api');

// Add the Mobile API so it is accessible as a Web API.
app.use(mobile);

// Start listening on HTTP.
app.listen(process.env.PORT || 3000);

ファイルは送信前に base 64 でエンコードされます。このエンコードによって実際のアップロードのサイズは増加します (そのため、このサイズを考慮する必要があります)。

カスタム SQL ステートメントを実行する

Mobile Apps SDK を使用すると、要求オブジェクトを介してコンテキスト全体にアクセスできます。定義されたデータプロバイダーに対して、パラメーター化された SQL ステートメントを簡単に実行できます。

var api = {
    get: function (request, response, next) {
        // Check for parameters. If not there, pass on to a later API call.
        if (typeof request.params.completed === 'undefined')
            return next();

        // Define the query. Anything that the mssql
        // driver can handle is allowed.
        var query = {
            sql: 'UPDATE TodoItem SET complete=@completed',
            parameters: [{
                completed: request.params.completed
            }]
        };

        // Execute the query. The context for Mobile Apps is available through
        // request.azureMobile. The data object contains the configured data provider.
        request.azureMobile.data.execute(query)
        .then(function (results) {
            response.json(results);
        });
    }
};

api.get.access = 'authenticated';
module.exports = api;

デバッグ

Mobile Apps をデバッグ、診断、およびトラブルシューティングする

Azure App Service では、Node.js アプリケーションに関するいくつかのデバッグとトラブルシューティングの手法が提供されます。 Node.js Mobile Apps バックエンドのトラブルシューティングを開始する場合は、次の記事を参照してください。

Node.js アプリケーションは、広範囲の診断ログツールにアクセスできます。 Mobile Apps Node.js SDK は、内部で診断ログに Winston を使用します。デバッグモードを有効にするか、Azure portalでアプリ設定を MS_DebugMode true に設定すると、ログ記録が自動的に有効になります。生成されたログは、Azure portalの診断ログに表示されます。

次の方法で共有

Mobile Apps Node.js SDK の使用方法

はじめに

サポートされているプラットフォーム

コマンドラインを使用して基本的な Node.js バックエンドを作成する

Visual Studio 2015 を使用して Node.js バックエンドを作成する

Azure Portal を使用して Node.js バックエンドを作成する

Git を使用して Node.js バックエンドクイックスタートコードプロジェクトをダウンロードする

Azure に Node.js バックエンドを発行する

アプリケーションのホームページを有効にする

テーブルの操作

動的スキーマを使用してテーブルを定義する

静的スキーマを使用してテーブルを定義する

ローカルコンピューター上で開発データストアとして SQL Server Express を使用する

ローカル開発用のプロジェクトを構成する

モバイルアプリのアプリ設定を構成する

SQL Database を運用データストアとして使用する

テーブルへのアクセスに認証を要求する

テーブルで認証要求を使用する

特定のテーブル操作へのアクセスを無効にする

テーブル操作で使用されるクエリを調整する

テーブルの論理削除を構成する

データベースに対するデータのシード処理を実行する

Swagger のサポートを有効にする

プッシュ通知

プッシュ通知を送信する

タグを使用して認証済みのユーザーにプッシュ通知を送信する

カスタム API

カスタム API を定義する

カスタム API へのアクセスに認証を要求する

大きなファイルのアップロードを処理する

カスタム SQL ステートメントを実行する

デバッグ

Mobile Apps をデバッグ、診断、およびトラブルシューティングする

その他のリソース

次の方法で共有

Mobile Apps Node.js SDK の使用方法

はじめに

サポートされているプラットフォーム

コマンド ラインを使用して基本的な Node.js バックエンドを作成する

Visual Studio 2015 を使用して Node.js バックエンドを作成する

Azure Portal を使用して Node.js バックエンドを作成する

Git を使用して Node.js バックエンド クイックスタート コード プロジェクトをダウンロードする

Azure に Node.js バックエンドを発行する

アプリケーションのホーム ページを有効にする

テーブルの操作

動的スキーマを使用してテーブルを定義する

静的スキーマを使用してテーブルを定義する

ローカル コンピューター上で開発データ ストアとして SQL Server Express を使用する

ローカル開発用のプロジェクトを構成する

モバイル アプリのアプリ設定を構成する

SQL Database を運用データ ストアとして使用する

テーブルへのアクセスに認証を要求する

テーブルで認証要求を使用する

特定のテーブル操作へのアクセスを無効にする

テーブル操作で使用されるクエリを調整する

テーブルの論理削除を構成する

データベースに対するデータのシード処理を実行する

Swagger のサポートを有効にする

プッシュ通知

プッシュ通知を送信する

タグを使用して認証済みのユーザーにプッシュ通知を送信する

カスタム API

カスタム API を定義する

カスタム API へのアクセスに認証を要求する

大きなファイルのアップロードを処理する

カスタム SQL ステートメントを実行する

デバッグ

Mobile Apps をデバッグ、診断、およびトラブルシューティングする

その他のリソース

コマンドラインを使用して基本的な Node.js バックエンドを作成する

Git を使用して Node.js バックエンドクイックスタートコードプロジェクトをダウンロードする

アプリケーションのホームページを有効にする

ローカルコンピューター上で開発データストアとして SQL Server Express を使用する

モバイルアプリのアプリ設定を構成する

SQL Database を運用データストアとして使用する