導入当日の手順書

はじめに録画を開始します（当日参加できない方の視聴用）。

1. 済
   1

   SharePoint の不良率フォルダを確かめる

   フォルダ

   入力/不良率/投入　/不良率/出力　/不良率/設定

   9/8 に作ったフォルダをそのまま使います。無ければ作ります

2. 済
   2

   設定管理ブックを置く

   置くファイル

   入力04【設定管理】不良率_しきい値と通知先_v3.xlsx

   置き場所

   入力/不良率/設定

   全社宛ての通知先（設定シート）には、いただいた配信先15件が入っています。拠点ごとの宛先（通知先シート）は空欄です（5. で決めて入れます）。

3. 済
   3

   対象顧客リストを置く

   置くファイル

   入力05【対象顧客リスト】食品UF不良率.xlsx

   置き場所

   入力/不良率/設定

   今お使いの週次ブックをこの名前で置いても読めます（「対象顧客」シートが無ければ、いちばん右のシートを読みます）。

1. 済
   1

   Excel on the web でブックを開く

   開くブック

   入力/不良率/設定/【設定管理】不良率_しきい値と通知先_v3.xlsx

   スクリプトは、フローを作った方（フローの所有者）のアカウントで登録します。「スクリプトの実行」アクションの一覧には、接続しているアカウントのスクリプトしか出ないためです。

2. 済
   2

   ［自動化］タブ →［新しいスクリプト］

   操作

   選ぶリボンの［自動化］→［新しいスクリプト］

   右にコードエディターが開きます。

3. 済
   3

   エディターの中身をすべて消す

   操作

   入力エディターをクリック → Ctrl+A（Mac は ⌘A）→ Delete

   最初から入っている function main(...) も消します。

4. 済
   4

   01 の Word から1本目のコードを貼る

   貼るもの

   貼り付け01【貼り付け用】Office Script_不良率_v3_20261009.docx の「1. 不良率_設定読み出し」の見出しの下を、最初の行から最後の行まで

   Word の見出しは貼りません。コードの行だけを選んでコピーします。

5. 済
   5

   スクリプト名を変えて保存

   名前

   入力不良率_設定読み出しコピー不良率_設定読み出し

   操作

   選ぶエディター上部のスクリプト名をクリックして書き換え →［スクリプトを保存］

   名前は1文字でも違うと、フローの一覧で見つけにくくなります。

6. 済
   6

   残りの3本も同じように登録する

   2本目

   入力不良率_対象顧客読み出しコピー不良率_対象顧客読み出し

   3本目

   入力不良率_週次集計_v3コピー不良率_週次集計_v3

   4本目

   入力不良率_履歴追記コピー不良率_履歴追記

   ［新しいスクリプト］→ 中身を消す → 貼る → 名前を変えて保存、を3回。v2 のスクリプト（不良率_週次集計）は消さずに残して構いません。

7. 済
   7

   登録できたか確かめる

   操作

   選ぶ［自動化］→［すべてのスクリプト］

   4本の名前が並んでいれば完了です。

1. 済
   1

   作りたい処理を日本語で箇条書きにする

   例

   貼り付け下のコピーで取れる指示文コピーExcel の Office Scripts（TypeScript）で、次の処理をするスクリプトを書いてください。 ・シート「設定」の A列に項目名、B列に値が入っている ・項目「最低枚数」「最低不良率」「通知先」の値を読み、JSON の文字列にして return する ・Power Automate の「スクリプトの実行」から呼ぶので、main 関数は string を返す ・シートが無いときは、分かる日本語のメッセージでエラーにする

   どのシートの、どの列を読み、何を返すか。Power Automate から呼ぶなら「string を返す」と書きます。

2. 済
   2

   Copilot に指示文を貼り、出てきたコードを［新しいスクリプト］に貼る

   操作

   選ぶMicrosoft 365 Copilot（または Copilot Chat）→ 指示文を貼る → コードをコピー → 新しいスクリプトに貼って保存
3. 済
   3

   ［実行］して、エラーが出たらそのまま Copilot に返す

   例

   貼り付け下のコピーで取れる指示文コピーこのスクリプトを Excel で実行したら、次のエラーが出ました。原因と、直したスクリプト全体を出してください。 （ここにエラーメッセージを貼る） （ここに今のスクリプトを貼る）

   エラーの文と、いまのスクリプト全体を一緒に渡すと、直したコードが返ってきます。1行ずつ自分で書く必要はありません。

4. 済
   4

   動いたら、Power Automate の「スクリプトの実行」で呼ぶ

   操作

   選ぶフローにアクションを足す → スクリプトを選ぶ → 戻り値（result）を「JSON の解析」で読む

   今日の4本も、この流れで作ったものと同じ形です（返す JSON を、フローの「JSON の解析」で読む）。

1. 済
   1

   ファイルが作成されたとき（プロパティのみ）

   SharePoint変更なし

   サイトのアドレス

   選ぶ業務部サイト

   ライブラリ名

   選ぶドキュメント

   フォルダー

   選ぶ/不良率/投入
2. 済
   2

   スクリプトの実行

   Excel Online (Business)ブックを差し替え

   名前を 設定読み出し に変える（式の中でこの名前を使います）

   場所

   選ぶ業務部サイト（SharePoint）

   ドキュメント ライブラリ

   選ぶドキュメント

   ファイル

   選ぶ/不良率/設定/【設定管理】不良率_しきい値と通知先_v3.xlsx

   欄の右のフォルダーのアイコンから選びます

   スクリプト

   選ぶ不良率_設定読み出し

   一覧から選びます。引数の欄は、スクリプトを選ぶと下に出てきます

   v2 の設定管理ブックから v3 のブックに替えます（通知先シートが増えたため）。引数はありません。

3. 済
   3

   スクリプトの実行

   Excel Online (Business)★新しく足す

   名前を 対象顧客読み出し に変える（式の中でこの名前を使います）

   場所

   選ぶ業務部サイト（SharePoint）

   ドキュメント ライブラリ

   選ぶドキュメント

   ファイル

   選ぶ/不良率/設定/【対象顧客リスト】食品UF不良率.xlsx

   欄の右のフォルダーのアイコンから選びます

   スクリプト

   選ぶ不良率_対象顧客読み出し

   一覧から選びます。引数の欄は、スクリプトを選ぶと下に出てきます

   #2 の下の［＋］から足します。対象顧客リストは読むだけで、書き換えません。

4. 済
   4

   ファイルのコピー

   SharePoint変更なし

   名前を 出力用コピー に変える（式の中でこの名前を使います）

   コピー元

   ⚡ 動的なコンテンツトリガーの「ファイルパス」

   コピー先フォルダー

   選ぶ/不良率/出力

   既存の場合

   選ぶ置き換える
5. 済
   5

   スクリプトの実行

   Excel Online (Business)★スクリプトと引数を替える

   名前を 集計 に変える（式の中でこの名前を使います）

   ファイル

   ⚡ 動的なコンテンツ「出力用コピー」の ItemId

   スクリプト

   選ぶ不良率_週次集計_v3

   v2 の 不良率_週次集計 から替えます。選び直すと引数の欄が空に戻るので、下の2つを入れ直します

   settingsJson

   fx 式outputs('設定読み出し')?['body/result']コピーoutputs('設定読み出し')?['body/result']

   targetJson

   fx 式outputs('対象顧客読み出し')?['body/result']

   ★v3 で増えた引数。文字列のまま渡します（JSON の解析はしない）

   コピーoutputs('対象顧客読み出し')?['body/result']
6. 済
   6

   JSON の解析

   データ操作★スキーマを貼り替え

   名前を 集計結果 に変える（式の中でこの名前を使います）

   コンテンツ

   fx 式json(outputs('集計')?['body/result'])コピーjson(outputs('集計')?['body/result'])

   スキーマ

   貼り付けスキーマ（全文）

   今入っている v2 のスキーマを全部消してから貼ります（拠点ごとのメール siteMails などが増えています）

   コピー{"type":"object","properties":{"periodStart":{"type":"string"},"periodEnd":{"type":"string"},"fileName":{"type":"string"},"alertCount":{"type":"integer"},"customerCount":{"type":"integer"},"siteCount":{"type":"integer"},"totalA":{"type":"number"},"totalB":{"type":"number"},"totalRate":{"type":"number"},"threshold":{"type":"string"},"prevWeekEnd":{"type":"string"},"hasPrev":{"type":"boolean"},"notifyTo":{"type":"string"},"mailSubject":{"type":"string"},"mailBody":{"type":"string"},"alertTop":{"type":"array","items":{"type":"object","properties":{"拠点":{"type":"string"},"得意先コード":{"type":"string"},"得意先名":{"type":"string"},"仕上数":{"type":"number"},"不良数":{"type":"number"},"不良率":{"type":"string"},"主因":{"type":"string"}}}},"alertsBySite":{"type":"array","items":{"type":"object","properties":{"拠点":{"type":"string"},"件数":{"type":"integer"}}}},"siteMails":{"type":"array","items":{"type":"object","properties":{"拠点":{"type":"string"},"宛先":{"type":"string"},"CC":{"type":"string"},"件数":{"type":"integer"},"件名":{"type":"string"},"本文":{"type":"string"}}}},"history":{"type":"object"},"check":{"type":"object"}}}
7. 済
   7

   ファイル コンテンツの取得

   SharePoint変更なし

   名前を 出力ブックの内容 に変える（式の中でこの名前を使います）

   ファイル識別子

   ⚡ 動的なコンテンツ「出力用コピー」の ItemId
8. 済
   8

   ファイルの作成

   SharePoint変更なし

   名前を 週末日の名前で保存 に変える（式の中でこの名前を使います）

   フォルダーのパス

   選ぶ/不良率/出力

   ファイル名

   入力不良率_〔periodEnd〕.xlsx

   例：不良率_20260816.xlsx

   コピー不良率_@{body('集計結果')?['periodEnd']}.xlsx

   ファイル コンテンツ

   ⚡ 動的なコンテンツ「出力ブックの内容」のファイル コンテンツ
9. 済
   9

   ファイルの削除

   SharePoint変更なし

   名前を 一時コピーの削除 に変える（式の中でこの名前を使います）

   ファイル識別子

   ⚡ 動的なコンテンツ「出力用コピー」の ItemId
10. 済
    10

    スクリプトの実行

    Excel Online (Business)ブックを差し替え

    名前を 履歴追記 に変える（式の中でこの名前を使います）

    場所

    選ぶ業務部サイト（SharePoint）

    ドキュメント ライブラリ

    選ぶドキュメント

    ファイル

    選ぶ/不良率/設定/【設定管理】不良率_しきい値と通知先_v3.xlsx

    欄の右のフォルダーのアイコンから選びます

    スクリプト

    選ぶ不良率_履歴追記

    一覧から選びます。引数の欄は、スクリプトを選ぶと下に出てきます

    resultJson

    fx 式outputs('集計')?['body/result']

    解析したあとの body('集計結果') ではなく、文字列そのものを渡します

    コピーoutputs('集計')?['body/result']
11. 済
    11

    条件

    コントロール変更なし

    名前を アラートあり に変える（式の中でこの名前を使います）

    左の値

    fx 式int(string(body('集計結果')?['alertCount']))コピーint(string(body('集計結果')?['alertCount']))

    比べ方

    選ぶ次の値より大きい

    右の値

    入力0
12. 済
    12

    メールの送信 (V2)

    Office 365 OutlookTrue（はい）の中本文の式を替える

    名前を 全社宛て に変える（式の中でこの名前を使います）

    宛先

    fx 式body('集計結果')?['notifyTo']コピーbody('集計結果')?['notifyTo']

    件名

    fx 式body('集計結果')?['mailSubject']コピーbody('集計結果')?['mailSubject']

    本文

    fx 式replace(body('集計結果')?['mailBody'], decodeUriComponent('%0A'), '<br>')

    本文の改行がメールで詰まらないよう、<br> に置き換える式にします

    コピーreplace(body('集計結果')?['mailBody'], decodeUriComponent('%0A'), '<br>')
13. 済
    13

    それぞれに適用する

    コントロールTrue（はい）の中、#12 の下★新しく足す

    名前を 拠点ごとに送る に変える（式の中でこの名前を使います）

    前のステップから出力を選択

    fx 式body('集計結果')?['siteMails']

    ⚡ の一覧から選ばず、fx で入れます（⚡ で選ぶとループがもう1つ自動で作られることがあります）

    コピーbody('集計結果')?['siteMails']
14. 済
    13-1

    メールの送信 (V2)

    Office 365 Outlook#13 の中★新しく足す

    名前を 拠点宛て に変える（式の中でこの名前を使います）

    宛先

    fx 式items('拠点ごとに送る')?['宛先']コピーitems('拠点ごとに送る')?['宛先']

    件名

    fx 式items('拠点ごとに送る')?['件名']コピーitems('拠点ごとに送る')?['件名']

    本文

    fx 式replace(items('拠点ごとに送る')?['本文'], decodeUriComponent('%0A'), '<br>')コピーreplace(items('拠点ごとに送る')?['本文'], decodeUriComponent('%0A'), '<br>')

    CC

    fx 式items('拠点ごとに送る')?['CC']

    ［詳細パラメーター］→［すべて表示］で出ます

    コピーitems('拠点ごとに送る')?['CC']

    siteMails に入るのは「通知先シートに宛先があり、今週アラートがある拠点」だけです。宛先が空欄の拠点には送りません。

15. 済
    14

    （何も置かない）

    False（いいえ）変更なし

    アラートが0件の週もメールが欲しい場合は、ここに全社宛てのメールを置きます。

16. 済
    保存

    右上の［保存］

    操作

    選ぶ［保存］→「フローを開始する準備ができました」と出れば完了

    保存で止まるときは、エラーの出たアクションの欄が空になっていないか（特に #5 の引数）を見ます。

1. 済
   1

   8/10〜8/16 のブックを投入フォルダに置く

   置くファイル

   入力「仕上データ」「不良交換」の2シートを持つ 8/10〜8/16 のブック

   置き場所

   入力/不良率/投入

   置いてから1〜数分でフローが動きます。フローの詳細画面の［28日間の実行履歴］で確かめます。

2. 済
   2

   実行がすべて緑になるか

   見るところ

   選ぶ実行を開き、#1〜#13-1 に緑の印が付いているか

   赤い印のアクションがあれば、そこを開いてエラー文を読みます（下の「つまずいたら」）。

3. 済
   3

   出力ブックができているか

   見るところ

   入力/不良率/出力/不良率_20260816.xlsx

   シート

   入力拠点別サマリー／得意先別明細／現物確認リスト の3つ

   03【完成イメージ】不良率_20260816_v3.xlsx と見比べます。

4. 済
   4

   数字が完成イメージと同じか

   対象顧客

   入力508社（8拠点）。うち今週データが無い得意先 59社（0枚の行で載る）

   全社

   入力仕上 269,737枚／不良 1,881枚／不良率 0.70%

   アラート

   入力23件（現物確認リストの行数）。拠点ごとの内訳は 03 の拠点別サマリーと同じになること
5. 済
   5

   空欄のセルが無いか

   見るところ

   選ぶ得意先別明細で、空白のセルが無いこと

   値が無いところは「消耗廃棄なし」「仕上なし」「前週なし」「－」などの文字が入ります。初回は前週の履歴が無いので、前週の8列はすべて「前週なし」です。

6. 済
   6

   全社宛てのメールが届くか

   届く先

   入力設定シートの「通知先」の15件

   件名の形

   入力【不良率】2026/08/16週 …

   本文が改行されて読めるか（行が詰まっていないか）も見ます。

7. 済
   7

   拠点宛てのメールが届くか

   届く先

   入力通知先シートに宛先を入れた拠点だけ

   今は通知先シートが空欄なので、拠点宛ては送られません。5. で宛先を入れたあと、もう一度置いて確かめます。

8. 済
   8

   履歴が追記されたか

   見るところ

   入力設定管理ブックの「履歴」シート

   増える行

   入力516行（拠点8＋得意先508）。週末日は 20260816
9. 済
   9

   同じブックをもう一度置く

   確かめること

   入力履歴が 516行のまま（同じ週の行を消してから入れ直すので二重にならない）。出力ブックは置き換わる

   同じファイル名で置き直すと、トリガーが動かないことがあります。名前を変えて（例：末尾に _2）置きます。

しきい値を変えたら、同じブックを名前を変えてもう一度置くと、新しい基準での件数とメールを確かめられます。

ほかの症状は 02【手順書】の「④エラー対応」にまとめています。