🛠️ はなみずき園 カメラシステム サーバー側セットアップ手順書

リソース名：child-camera（Azure Cosmos DB アカウント）／ コンテナ：Clients

フェーズ1：Clients コンテナに組織レコードを追加する

1. 1
   Azure Portal にサインインし、Cosmos DB「child-camera」を開く
2. 2
   左ペインから「Data Explorer」を選択
3. 3
   コンテナ「Clients」を選択
4. 4
   上部ツールバーの「New Item」をクリック

▲ Data Explorer → Clients.Items を開き「New Item」を押す

1. 5
   右ペインに以下のJSONテンプレートを貼り付け、園情報を書き換える

   id と ClientID は 既存最大値＋1 を採番（既存が 1 なら 2）。PersonGroupId / StaffGroupId は 連番ルール（下記）で採番。

{
    "id": "2",
    "ClientID": 2,
    "OrganizationName": "ORGANIZATION NAME",
    "ClientName": "CLIENT NAME",
    "ClientKanaName": "KANA NAME",
    "ClientAddress": "ADDRESS",
    "ClientPhoneNo": "MOBILE NUMBER",
    "ClientPrefecture": "Japan",
    "Status": true,
    "CreatedDate": "2025-09-12T10:00:00Z",
    "UpdateDate":  "2025-09-12T10:30:00Z",
    "PersonGroupId": "hana-mizuki-g004",
    "StaffGroupId":  "hana-mizuki-s004"
}

▲ 右ペインへJSONを貼付し、上部ツールバーの「Save」を押す

1. 6
   「Save item」をクリックしてレコードを保存

PersonGroupId / StaffGroupId の採番ルール

Power Apps の管理画面は Solution（ソリューション）単位で他環境へ移送します。開発元環境から ZIP エクスポートし、クライアント環境へインポートします。

フェーズ1：Power App を Solution に追加する

1. 1
   https://make.powerapps.com にアクセス
2. 2
   対象の環境を選択する
3. 3
   左メニュー「Solutions（ソリューション）」へ移動
4. 4
   「New Solution（新しいソリューション）」をクリック

   名前（例：ChildCameraSolution）／発行元／バージョン を入力

5. 5
   作成した Solution を開く
6. 6
   「既存を追加」→「App」→「Canvas App」をクリック
7. 7
   対象の Power App を選択して追加する

フェーズ2：Solution を ZIP エクスポートする

1. 1
   Solution 内で「Export」をクリック
2. 2
   「Next」をクリック
3. 3
   Managed / Unmanaged を選択し「Export」をクリック

   ・Managed：クライアント納品用（編集不可の封入形式）
   ・Unmanaged：開発用（編集可能）

4. 4
   ZIP ファイルがダウンロードされる

フェーズ3：クライアント環境へ Solution をインポート

1. 1
   クライアント環境（Power Platform テナント）にログイン

   https://make.powerapps.com

2. 2
   環境セレクタで正しい環境を選択
3. 3
   左メニュー「Solutions」へ移動
4. 4
   「Import Solution」をクリック
5. 5
   エクスポートした ZIP をアップロード
6. 6
   「次へ」→「インポート」をクリック

フェーズ4：アプリケーションを確認する

1. 1
   インポート後、Solution を開く
2. 2
   以下を確認する

   • アプリが利用可能であること
   • 接続設定が正常に動作していること
3. 3
   実機アクセスして基本動作をテストする

Cosmos DB の Clients コンテナで新規採番した ClientID（例：2）を、Power Apps 側の 8つのコネクタ呼び出しに反映します。 初期値はすべて 1（はなみずき）になっているので、新テナント用に書き換えてください。

コネクタ一覧（全8個）

Set(
    varChildResp,
    StudentList.Run("1").studentdata
);

Set(
    varChildResp,
    StudentList.Run("2").studentdata
);

2StudentRegistration

1. 1
   Children Registration ページへ移動
2. 2
   「保存」ボタンをクリック
3. 3
   右プロパティパネルで OnClick を確認

▲ 「保存」ボタンの OnClick に Student_Registration.Run が記述されている

Before

Student_Registration.Run(
    1,
    Trim(NameInput.Text),
    Trim(NameInput_1.Text),
    Dropdown.Selected.Year,
    JSON(attachments)
)

After

Student_Registration.Run(
    2,
    Trim(NameInput.Text),
    Trim(NameInput_1.Text),
    Dropdown.Selected.Year,
    JSON(attachments)
)

✅アプリを保存し、公開してください。

3Download_Children

1. 1
   Download Children ページへ移動
2. 2
   「ダウンロード」ボタンをクリック
3. 3
   確認メッセージで Yes ボタンをクリック
4. 4
   右プロパティパネルで OnClick を確認

▲ ボタン_9 の OnClick（Download_Children.Run の 3番目引数が ClientID）

▲ IfError / Notify を含む Full コード

Before

Set(
    Response,
    Download_Children.Run(
        DownloadKanjiName,
        DownloadChildId,
        1
    )
)

After

Set(
    Response,
    Download_Children.Run(
        DownloadKanjiName,
        DownloadChildId,
        2
    )
)

✅アプリを保存し、公開してください。

Set(
    varStaffResp,
    StaffList.Run("1").staffdata
);

Set(
    varStaffResp,
    StaffList.Run("2").staffdata
);

5Teacher_Registration

1. 1
   Teacher Registration ページへ移動
2. 2
   「保存」ボタンをクリック
3. 3
   右プロパティパネルで OnClick を確認

▲ Teacher_Registration.Run の 1番目引数が ClientID

Before

Teacher_Registration.Run(
    1,
    Trim(NameInput_4.Text),
    Trim(NameInput_5.Text),
    JSON(attachments)
)

After

Teacher_Registration.Run(
    2,
    Trim(NameInput_4.Text),
    Trim(NameInput_5.Text),
    JSON(attachments)
)

✅アプリを保存し、公開してください。

6DownloadSmileScore

1. 1
   Teacher List ページへ移動
2. 2
   「笑顔ダウンロード」ボタン → Yes ボタンをクリック
3. 3
   右プロパティパネルで OnClick を確認

▲ DownloadSmileScore.Run の 1番目引数が ClientID

Before

DownloadSmileScore.Run(
    "1",
    {
        date:   Text(DatePicker1.SelectedDate, "yyyy-mm-dd"),
        date_1: Text(DatePicker2.SelectedDate, "yyyy-mm-dd")
    }
)

After

DownloadSmileScore.Run(
    "2",
    {
        date:   Text(DatePicker1.SelectedDate, "yyyy-mm-dd"),
        date_1: Text(DatePicker2.SelectedDate, "yyyy-mm-dd")
    }
)

✅アプリを保存し、公開してください。

7getEmailList

1. 1
   「設定」ページへ移動
2. 2
   左ツリービューで 「メールがめん」 をクリック
3. 3
   右プロパティパネルで OnVisible を選択

▲ メールがめんの OnVisible で getEmailList.Run("1") が呼ばれる

Before

Set(
    varRespEmail,
    ParseJSON(getEmailList.Run("1").emaildata)
);

After

Set(
    varRespEmail,
    ParseJSON(getEmailList.Run("2").emaildata)
);

✅アプリを保存し、公開してください。

Email_Registration.Run(
    1,
    Trim(NameInput_9.Text)
)

Email_Registration.Run(
    2,
    Trim(NameInput_9.Text)
)

• Cosmos DB「Clients」コンテナに新組織レコードが保存されている（id・ClientID が連番採番）
• PersonGroupId / StaffGroupId を連番で払い出し、開発担当に連絡済み（Face API ディレクトリ作成依頼）
• Power Apps Solution（Managed）をクライアント環境へインポートし、エラーなし
• API 接続・環境変数・権限設定の再設定が完了している
• 8つのコネクタすべてで ClientID が新規採番値に置換されている（1→2 など）
• アプリを保存し、公開済み（Publish 済み）
• 顔写真登録／一覧表示／写真ダウンロード／笑顔スコアダウンロード／メール設定 が実機で動作する
• 先生向け操作ガイド（manual.kensetsu-total.support/hanamizuki）のアカウント情報を差し替え済み
• 納品アカウント情報（OneDrive・Power Apps・Safie）を納品フォルダに集約

よくあるトラブル

• Solution インポート時にエラー → API 接続・環境変数が未設定の可能性。Solutions → 当該 Solution → Connection References で再設定
• アプリは開くが一覧が空 → ClientID の書換え漏れ。8つのコネクタをすべて確認
• 顔登録で「登録に失敗」 → Face API ディレクトリが未作成。PersonGroupId / StaffGroupId を開発担当に連絡
• 笑顔スコアダウンロードでメールが届かない → getEmailList / Email_Registration の ClientID を確認
• 上記で解決しない場合は開発担当（クラウドパワー）に連絡