こんな人むけの記事です
SharePointのドキュメントライブラリに特定のファイルがアップロードされたときだけ処理を実行したい。そんなとき、どうしますか?
特定のフォルダ内の特定ファイル(この例では Shared Documents/csv/test.csv)が更新されたら、そのCSVファイルをUTF-8(BOMなし)からUTF-8(BOMあり)に変換し、ファイル名の先頭に処理日付を追加するという処理です。
この処理の作り方は、以下の記事で紹介しています:
🔗 前回の記事はこちら
この処理には無駄がある
実はこの方法、無駄な処理が発生していました。
というのも、SharePointサイトのドキュメントライブラリで目的のファイル以外が更新された場合でもクラウドフローが起動し、その中で「条件」アクションを使って対象ファイルかどうかを判定していたからです。
「そもそも、目的のファイル以外ではトリガーが動作しない方がいいよね?」
…という、もっともな指摘をTwitterでいただき、ようやく気づきました。
少し遠回りしましたが、今回はそのスマートな方法を紹介します。
トリガー条件はどこにある?
トリガーの右上にある「三点リーダー(…)」をクリックし、「設定」を選びます。
設定画面の一番下にある「トリガーの条件」セクションで「+追加」をクリックすると、条件入力欄が表示されます。少し分かりづらい場所にあります。
この欄に記述した条件が true になると、後続の処理が実行される仕組みです。
ただし、入力補助がないため、式を手動で書く必要があります。
そのため、まずはテキストエディタで式を作成するのがおすすめです。
条件式を書く
前回の記事で作成したフローでは、トリガーの戻り値は以下のような形式でした。
この中の FullPath(39行目)が Shared Documents/csv/test.csv と一致するかどうかが、トリガー条件になります。
まず、「条件」アクションの左辺にある「完全パス」を選択して Ctrl + C でコピーします。
テキストエディタに貼り付けると、以下のようになります:
@triggerOutputs()?['body/{FullPath}']
2つの値が一致していればtrueを返すことができるのは、equals関数です。第1引数と第2引数がまったく同じならtrueを返します。
そこで関数のテストをします。テストには「作成」を使うと便利です。
入力を「式」モードにして、先程取得したトリガーの値を表す式から先頭の@マークを取り除いたものをequals関数の第1引数とし、シングルくウォーテーションで囲ったファイルのフルパスを第2引数にして記述すると以下のようになります。
equals(triggerOutputs()?['body/{FullPath}'],'Shared Documents/csv/test.csv')
この状態で、試しに「テスト」>「手動」で式に誤りがないかを確認します。テスト待機状態になったら、SharePointドキュメントライブラリの指定フォルダに、csvファイルを上書きコピーでアップロードします。
その結果、equals関数の2つの要素が一致しているので、trueが戻り値として返されました。
式に問題ないことがわかったので、「作成2」の中身にできた紫色の部分を選択して ctrl+Cでコピーします。
トリガーの条件の中に、先程作成した「作成2」の中身のコピーを貼り付けます。繰り返しになりますが、これを手書きするのは大変ですので、先程やったように第1引数、第2引数になるものを、いちど「作成」などに「動的なコンテンツ」として選択したあと、ctrl + Cでコピーしてやる方法が便利です。
テストする
トリガーの条件を設定できたので、「テスト」>「手動」で待機状態にしたあと、あえて別のファイルをSharePointドキュメントライブラリにアップロードしてみます。
アップロードしてから数分待ってみましたが、テストは反応しません。
次に、equals関数の第2引数に指定したファイルをアップロード(上書き)してみます。
んん・・・? 動かない・・・。
動かないときの対処法
どうやら、「作成2」で作った式そのままでは動作しないようで、少し修正します。ポイントは波括弧を外すことです。@マークの直後と、式の一番最後にある { }を外してから「完了」をクリックし、再度テストします。
今度は成功しました。別ファイルをアップロードしても動作しません。これで一安心です。
「条件」アクションが不要に!
トリガーだけで条件判定ができるようになったので、クラウドフローの中に作成していた「条件」は不要になりました。処理に必要な部分だけを残して以下のように修正しました。
まとめ
遠回りしましたが、トリガー条件を使うことで無駄な処理を省き、よりスマートなフローが実現できました!
トリガー条件をつかうアドバイスをいただいて感謝です。
Views: 3