Word アクション
Word オートメーション機能を使用すると、ローカルまたはクラウドに保存されている Word ファイルをシームレスに操作できます。 まず、'Word を起動' または '実行中の Word にアタッチ' アクションを使用して Word インスタンスを作成する必要があります。 このインスタンスは、グループ内の残りのアクションの入力パラメーターとして機能し、目的の Word ファイルに対してアクションを簡単に実行できるようにします。
現在、以下のアクションが使用可能です:
- Word の起動: デスクトップの Power Automate でこのアクションがトリガーされると、Word ドキュメントが開き、同じデスクトップ フロー内で後続の Word アクションで使用できる Word インスタンスが作成されます。 ユーザーは、新しい空の Word 文書を開くか、ローカル マシンまたはクラウド (OneDrive または SharePoint 経由) にある既存の Word 文書を開くかを選択できます。 アクションの構成に応じて、Word アプリケーションを表示または非表示で起動し、文書を読み取り専用モードで開くことができます。 ドキュメントを読み取り専用モードで開いた場合、Power Automate デスクトップ アクションや手動でドキュメントを編集することはできないことに注意してください。
- 実行中の Word に添付: このアクションは、現在開いている既存の Word ドキュメントを添付する機能を提供し、同じデスクトップ フロー内の後続の Word アクションで使用できる Word インスタンスを作成します。 ユーザーは、設計時に同じマシン上ですでに開いている Word ドキュメントをドロップダウン メニューから挿入するか、ローカル マシンまたはクラウドにある既存の Word ドキュメントを選択するかを選択できます (OneDrive 経由または SharePoint)。
- Word の保存: このアクションにより、ユーザーは Word アプリケーションが現在サポートしている任意の形式で Word 文書を保存できます。 デフォルトのドキュメント形式は 'デフォルト (拡張子から)' です。これは、値を C:\TestWord.pdf PDFとして保存するなど、ユーザーが ドキュメント パス パラメータでドキュメント形式を設定する必要があることを意味します。
- Word を閉じる: このアクションは Word 文書を閉じ、Power Automate の特定の Word インスタンスを非アクティブにします。 ユーザーは Word アプリケーションが現在サポートしている任意の形式で Word 文書を閉じる前に保存できます。 デフォルトのドキュメント形式は 'デフォルト (拡張子から)' です。これは、値を C:\TestWord.pdf に PDF として保存するなど、ユーザーが ドキュメント パス パラメータでドキュメント形式を設定する必要があることを意味します。
- Word 文書から読み取る: このアクションにより、ユーザーは Word 文書からコンテンツを取得し、それをフローの後続のアクションで使用できるようになります。 文書全体、特定のページ、またはブックマークのコンテンツを柔軟に読むことができます。 ページの場合は、特定のページまたはページのリストを指定できます。 たとえば、値 2-5 をそれぞれの Pages パラメータに挿入して、ページのコンテンツを取得できます。2 ～ 5 ページ (例: ページ 2、3、4、5)、または値 3,5,6,7 を挿入して、それぞれのページのコンテンツを取得するか、2-4,6,8,9 のように、両方の方法を組み合わせて使用します。 Word ドキュメント形式は取得できず、出力パラメータはプレーン テキストであることに注意することが重要です。
- Word 文書内の単語の検索と置換: ユーザーは、このアクションで新しい機能を適用できます。これは、Word 文書内の特定のテキストを検索して置換する機能です。 ユーザーは、テキストの最初の出現のみを置換するか、一致するすべてを置換するかを選択できます。 さらに、ワイルドカードを使用すると、ワイルドカードが 検索するテキスト 入力パラメータに挿入されることで動的なテキスト検索を可能にします。 検索をさらに絞り込むには、テキストの大文字と小文字を一致させるか、単語全体のみを一致させるようにツールを設定します。 これらの設定は、ワイルドカードを使用する パラメータがオフに設定されています。
- Word 文書に書き込む: このアクションにより、ユーザーは Word 文書内の特定の位置にテキストを挿入できるようになります。 これは、ファイルの先頭または末尾、または特定のブックマークの前後で実行できます。 さらに、ユーザーは好みに応じて、挿入されたテキストの前に新しい行を追加するかどうかを選択できます。
- Word 文書に画像を挿入する: このアクションにより、ユーザーは Word 文書内の特定の位置に画像を挿入できるようになります。 これは、ファイルの先頭または末尾、または特定のブックマークの前後、または特定のテキストの前後で実行できます。 スペースや改行は追加されないことに注意してください。 ユーザーは、ローカル コンピューター保存されているファイルとして画像を取得するか、クリップボードのコンテンツとして画像を取得するかを選択できます。
注意
デスクトップ用 Power Automate の Word アクションは、Microsoft Word 2013 以降のバージョンと互換性があります。
Word を起動する
新しい Word インスタンスを開くか、Word 文書を開きます。
入力パラメーター
| 引数 | オプション | 受入 | Default Value | Description |
|---|---|---|---|---|
| Word を起動する | N/A | 空白のドキュメント、以下のドキュメントを開く | 空白のドキュメント | 新しい Word ドキュメントを開くか、既存のドキュメントを開くかを指定します |
| ドキュメント パス | いいえ | File | 開く既存の Word ドキュメントの完全なパス | |
| Make instance visible | N/A | ブール値 | True | Word ウィンドウを表示するかどうかを指定 |
| Open as ReadOnly | N/A | ブール値 | False | 保存されているドキュメントを読み取り専用モードで開くかどうかを指定 |
| 読み取り保護パスワード | はい | 直接暗号化された入力またはテキスト値 | パスワードで保護されている場合は、Word ドキュメントの読み取り保護パスワード | |
| 書き込み保護パスワード | はい | 直接暗号化された入力またはテキスト値 | 読み取り保護パスワードで保護されている場合は、Word ドキュメントのパスワード |
生成される変数
| 引数 | タイプ | Description |
|---|---|---|
WordInstance |
Word インスタンス | 後続の Word アクションで使用する特定の Word インスタンスです。 これにより、ユーザーは複数の Word ドキュメントのうち、どのシートにアクセスするかを指定することができます |
例外
| 例外 | Description |
|---|---|
| Word を起動できませんでした | Word インスタンスを起動するときに問題が発生したことを示します |
| Word ドキュメントが見つかりませんでした。 | 指定された Word ドキュメントが提供された場所に見つからなかったことを示します |
| 既存の Word ドキュメントを開くことができませんでした | 指定された Word ドキュメントを開くときに問題が発生したことを示します |
| Word アプリケーションを起動できませんでした | 内部エラーにより Word アプリケーションを起動できなかったことを示します |
| Word アプリケーションがインストールされていません | Word アプリケーションが特定のマシンにインストールされていないことを示します |
実行中の Word に接続する
既に開いている Word ドキュメントに接続します。
入力パラメーター
| 引数 | オプション | 受入 | Default Value | Description |
|---|---|---|---|---|
| Document name | いいえ | File | 添付先の Word ドキュメントの名前またはパス |
生成される変数
| 引数 | タイプ | Description |
|---|---|---|
WordInstance |
Word インスタンス | 今後の Word アクションで使うためにこのアクションが添付された Excel インスタンス |
例外
| 例外 | Description |
|---|---|
| Word ドキュメントに添付できませんでした | 特定の Wird ドキュメントに添付するときに問題が発生したことを示します |
| 指定された Word ドキュメントが見つかりません | 指定された Word ドキュメントが提供された場所に見つからなかったことを示します |
| Word を起動できませんでした | 内部エラーにより Word アプリケーションを起動できなかったことを示します |
Word を保存
既に起動している Word インスタンスを保存します。
入力パラメーター
| 引数 | オプション | 受入 | Default Value | Description |
|---|---|---|---|---|
| Word インスタンス | いいえ | Word インスタンス | 保存する Word のインスタンスです。 個の変数は、Word の起動 または 稼働している Word へアタッチする アクションで以前指定されていなければなりません。 | |
| Save mode | N/A | ドキュメントの保存、ドキュメントを名前を付けて保存 | ドキュメントを保存 | このインスタンスのドキュメントを保存する方法。 |
| ドキュメント形式 | N/A | Word アプリから利用可能なすべての形式 | 既定 (拡張機能から) | ドキュメントの形式。 |
| ドキュメント パス | いいえ | File | ドキュメントの完全なパス。 での選択に従って、目的のドキュメント ファイル拡張子を挿入します。 文書形式 パラメータ。 |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 | Description |
|---|---|
| Word の保存に失敗しました | Word ドキュメントを保存するときに問題が発生したことを示します |
| Word インスタンスまたは Word 文書が初期化されていません | アクションで指定された Word インスタンスまたは Word ドキュメントが初期化されていないことを示します |
| 読み取り専用ドキュメントに対して操作を実行することはできません | Word 文書が読み取り専用で開かれているため保存できないことを示します |
Word を閉じる
Word インスタンスを閉じます。
入力パラメーター
| 引数 | オプション | 受入 | Default Value | Description |
|---|---|---|---|---|
| Word インスタンス | いいえ | Word インスタンス | 閉じる Word のインスタンスです。 個の変数は、Word の起動 または 稼働している Word へアタッチする アクションで以前指定されていなければなりません。 | |
| Word を閉じる前 | N/A | ドキュメントを保存しない、ドキュメントを保存する、名前を付けてドキュメントを保存する | ドキュメントを保存しない | インスタンスを閉じる前にこのインスタンスのドキュメントを保存するかどうかとその方法を指定します。 |
| ドキュメント形式 | N/A | Word アプリから利用可能なすべての形式 | 既定 (拡張機能から) | ドキュメントの形式。 |
| ドキュメント パス | いいえ | File | ドキュメントの完全なパス。 文書形式 パラメータでの選択に従って、目的のドキュメント ファイル拡張子を挿入します。 |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 | Description |
|---|---|
| Word を閉じるのに失敗しました | Word ドキュメントを閉じるときに問題が発生したことを示します |
| Word の保存に失敗しました | Word ドキュメントを保存するときに問題が発生したことを示します |
| 読み取り専用ドキュメントに対して操作を実行することはできません | Word 文書が読み取り専用で開かれているため保存できないことを示します |
Word 文書から読み取る
Word インスタンスの文書からテキスト コンテンツを読み取ります。
入力パラメーター
| 引数 | オプション | 受入 | Default Value | Description |
|---|---|---|---|---|
| Word インスタンス | いいえ | Word インスタンス | 作業対象の Word インスタンスです。 | 個の変数は、Word の起動 または 稼働している Word へアタッチする アクションで以前指定されていなければなりません。 |
| Retrieve | N/A | 文書全体/ページ/ブックマーク | ドキュメント全体 | ドキュメント全体、特定のページ、またはブックマークのコンテンツを取得するかどうか |
| ぺージ | いいえ | 数値 | 1 | 読み込まれる Word ドキュメントのページ。 ページ範囲またはリストは 2-5 のように指定できます、これは、ページ 2 からページ 5 または、2、3、7、ページ までのコンテンツを取得し、2、3、7 ページからコンテンツを取得します。 |
| ブックマーク | いいえ | テキスト値 | 読み込まれる Word ドキュメントのブックマーク。 |
生成される変数
| 引数 | タイプ | Description |
|---|---|---|
| WordData | テキスト値 | 取得されたコンテンツの値 |
例外
| 例外 | Description |
|---|---|
| Word 文書からコンテンツを読み取ることができませんでした | 指定した Word ドキュメントからコンテンツを取得する際に問題が発生したことを示します |
| Word インスタンスまたは Word 文書が初期化されていません | アクションで指定された Word インスタンスまたは Word ドキュメントが初期化されていないことを示します |
Word 文書に書き込む
Word ファイルにテキストを書き込むか、または追加します。
入力パラメーター
| 引数 | オプション | 受入 | Default Value | Description |
|---|---|---|---|---|
| Word インスタンス | いいえ | Word インスタンス | 作業対象の Word インスタンスです。 | 個の変数は、Word の起動 または 稼働している Word へアタッチする アクションで以前指定されていなければなりません。 |
| 書き込むテキスト | はい | 一般の値 | 指定された Word ドキュメントに書き込むテキスト | |
| Append new line | N/A | ブール値 | True | ドキュメントに書き込むテキスト全体の最初に、新しい行を追加するかどうかを指定します |
| テキストの書き込み先 | N/A | Word ファイルの先頭/ Word ファイルの末尾/ブックマークの前/ブックマークの後 | Word ファイルの先頭 | テキストを追加する Word 文書の位置を指定します |
| ブックマーク | いいえ | テキスト値 | テキストを追加する Word 文書のターゲット ブックマーク | このアクションは、Word 文書内の指定されたブックマークの前後にテキストを追加します。 |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 | Description |
|---|---|
| Word インスタンスまたは Word 文書が初期化されていません | アクションで指定された Word インスタンスまたは Word ドキュメントが初期化されていないことを示します |
| 読み取り専用ドキュメントに対して操作を実行することはできません | Word 文書が読み取り専用で開かれているため編集できないことを示します |
| Word ドキュメント インスタンスに対する書き込み操作が失敗しました | 指定した Word ドキュメントからコンテンツを書き込む際に問題が発生したことを示します |
Word 文書に画像を挿入する
Word ファイルに画像を挿入します。
入力パラメーター
| 引数 | オプション | 受入 | Default Value | Description |
|---|---|---|---|---|
| Word インスタンス | いいえ | Word インスタンス | 作業対象の Word インスタンスです。 | 個の変数は、Word の起動 または 稼働している Word へアタッチする アクションで以前指定されていなければなりません。 |
| 画像の挿入先 | N/A | Word ファイルの先頭/ Word ファイルの末尾/ブックマークの後/特定のテキストの後/特定テキストの後 | Word ファイルの先頭 | 画像を追加する Word 文書の位置を指定します |
| 画像の挿入元 | N/A | ファイル/クリップボード | File | 指定された Word 文書に挿入される画像の場所 |
| 画像パス | いいえ | File | 挿入する画像の完全なパス | |
| Text to find | いいえ | テキスト値 | 画像を挿入するために Word 文書内で検索するテキスト | 画像は、指定されたテキストが出現する前または後に追加されます |
| ブックマーク | いいえ | テキスト値 | テキストを追加する Word 文書のターゲット ブックマーク |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 | Description |
|---|---|
| Word インスタンスまたは Word 文書が初期化されていません | アクションで指定された Word インスタンスまたは Word ドキュメントが初期化されていないことを示します |
| 読み取り専用ドキュメントに対して操作を実行することはできません | Word 文書が読み取り専用で開かれているため編集できないことを示します |
| 画像を挿入できませんでした | 指定した Word ドキュメントから画像を挿入する際に問題が発生したことを示します |
Word 文書内の単語を検索して置換する
Excel インスタンスのアクティブなワークシート内のテキストを検索して、別のテキストに置換します。
入力パラメーター
| 引数 | オプション | 受入 | Default Value | Description |
|---|---|---|---|---|
| Word インスタンス | いいえ | Word インスタンス | 作業対象の Word インスタンスです。 | 個の変数は、Word の起動 または 稼働している Word へアタッチする アクションで以前指定されていなければなりません。 |
| すべて一致 | N/A | ブール値 | False | 一致するセル内のテキストをすべて検索/置換するか、一致する最初の発生のテキストのみを検索/置換するか |
| Text to find | いいえ | テキスト値 | ワークシート内で検索するテキスト | |
| 置換するテキスト | いいえ | テキスト値 | 一致するセルの置換に使用するテキスト | |
| ワイルドカードを使う | N/A | ブール値 | False | 検索するテキストにワイルドカードを使用するかどうか |
| ケースを一致させる | N/A | ブール値 | False | データの大文字と小文字を区別して検索するかどうか |
| 単語全外のみの一致 | N/A | ブール値 | False | 指定したテキスト同じ単語を検索するかどうか |
生成される変数
このアクションは変数を生成しません。
例外
| 例外 | Description |
|---|---|
| Word 文書内のテキストを置換できませんでした | 提供されたインプットで指定されたテキストの検索や置換に問題があることを示します |
| Word インスタンスまたは Word 文書が初期化されていません | アクションで指定された Word インスタンスまたは Word ドキュメントが初期化されていないことを示します |
| 読み取り専用ドキュメントに対して操作を実行することはできません | Word 文書が読み取り専用で開かれているため編集できないことを示します |
既知の制限
OneDrive または SharePoint を通じて同期された Word ファイルを使用します
Microsoft Word または OneDrive で同期されたフォルダーに含まれる SharePoint ファイルを操作すると、誤ったフローが発生する可能性があります。 デスクトップ用 Power Automate は、Word との対話に COM オブジェクトを利用します。 OneDrive と SharePoint は、COM を通じて起動された Word インスタンスと完全な互換性はありません。
このため、OneDrive または SharePoint ディレクトリに保存されている Word ファイルを開こうとすると、ファイルが見つからない というエラーが発生する場合があります。 この問題を解決するには、次のアクションのいずれかを回避策を使用します:
回避策 1
- それぞれの Word ファイルのローカル コピーを作成します。
- デスクトップの Word オートメーション アクションの Power Automate を使用して、Word ファイルのローカル コピーを変更します。
- OneDriveまたは Sharepoint を通じて同期された Word ファイルのコピーを、最新の変更を含むローカル コピーで上書きします。
回避策 2
- アプリケーションの実行 アクションを使用して、新しい Word インスタンスを開きます。 アクションの間に十分な待ち時間を設けて、アドインを含む Word プロセスが完全に読み込まれるようにしてください。
- 新しいプロセスに添付するには、アクション 実行している Word にアタッチする を使用します。
注意
この回避策は、通常、 Word の起動 アクションの実行に失敗した場合に使用できます。