Google Sheets アドオン
AutomaDoc アドオンは、スプレッドシートの横のサイドバーで動作します。スプレッドシートのタブごとに独自のテンプレートがあり、見出し行より下の各行が1つのレコード、各列が1つのプレースホルダーになります。
インストールして開く
Section titled “インストールして開く”- Google Workspace Marketplace から AutomaDoc をインストールします（近日公開予定）。公開までは、Company Portal の 連携 で Google Sheets を接続し、HTTP トリガーまたはドキュメント API で生成します。
- スプレッドシートを開き、拡張機能 → AutomaDoc → 開く を選びます。
初回は、Google がアドオンの許可を求めます。求める内容はわずかです。開いているスプレッドシートの読み取り（ほかのファイルは対象外）、メニューとサイドバーの表示、そしてログインのためのメールアドレスの確認だけです。
サイドバーには 生成、テンプレート、変数、その他 の4つのタブがあります。
Google Sheets で使っている Google アカウントで、自動的にログインします。別のパスワードはありません。どの AutomaDoc アカウントに入るかは、その Google アカウントによって決まります。
- Google Workspace のアカウントは、ドメインの AutomaDoc アカウントに参加します（ドメインで最初の人がアカウントを作成し、その管理者になります）。
- 個人の Google アカウント（Gmail など）には、専用のメールアカウントが作成されます。
Google がメールアドレスを確認済みでないと、AutomaDoc はログインできません。その他 にある ログアウト でアドオンからログアウトし、もう一度ログイン で戻れます。アカウントの仕組みについては、Microsoft、Google、メールでログインを参照してください。
このスプレッドシートを接続
Section titled “このスプレッドシートを接続”アドオン自体の権限では、サイドバーが開いているスプレッドシートを読み取れるだけです。ドキュメントは AutomaDoc のサーバーで作られ、サーバーは あなたの Google の権限でシートを読み取ります。そのため、各スプレッドシートでテンプレートを作成または使用する前に、一人ひとりが一度だけそのスプレッドシートを接続します。
- このスプレッドシートを接続 をクリックします。Google のウィンドウが開きます。ブラウザがブロックした場合は、Google Sheets のポップアップを許可してからもう一度試してください。
- Sheets で使っているのと 同じ Google アカウントでログインし、選択した Google ドライブのファイルへの権限にはチェックを入れたままにします。
- Google のファイル選択画面には、開いているスプレッドシートが1つだけ表示されます。それを選択します。
- ウィンドウに スプレッドシートを接続しました と表示されます。ウィンドウを閉じて Google Sheets に戻ります。
サイドバーは自動的にこれを検知します。待機したままの場合は、完了しました をクリックします。
これは Google の drive.file 権限です。AutomaDoc が開けるのは、この方法で選択したスプレッドシートと、AutomaDoc があなたの Drive に作成したファイルだけで、Drive のほかのものは開けません。
後で AutomaDoc のアクセスが終了した場合（接続を解除した、Google の管理者が取り消した、ログインの有効期限が切れたなど）、サイドバーに Google に再接続 が表示されます。同じ方法でもう一度接続してください。
テンプレートを作成する
Section titled “テンプレートを作成する”テンプレートは、開いているタブに属します。上部の選択メニューには、「（タブ名）」のテンプレート の見出しの下にテンプレートが一覧表示されます。Sheets で別のタブに移動すると、サイドバーにはそのタブのテンプレートが表示されます。
- 新しいテンプレート をクリックします（生成 タブ、または選択メニューの 新しいテンプレート）。
- テンプレート名 を入力します。
- 見出し行 を設定します。列名が入っている行で、レコードはその下の行です。シートがもっと下から始まっていない限り、1行目です。
- キー列 を選びます。請求書番号のように、値が一意になる列です。なし: 行番号を使用 を選ぶと、各レコードを行番号で識別します。
- テンプレートを作成 をクリックします。
ほかの人がシートを編集する場合は、必ずキー列を選んでください。AutomaDoc はステータスやリンクを書き戻すときにキーで各行を探し直すため、ドキュメントの作成中にシートを並べ替えたり行を挿入したりしても、結果が別の行に書き込まれることはありません。キーが空の行はスキップされ、複数の行に同じキーがある場合はそのドキュメントが失敗します。どちらも、生成する前にサイドバーが警告します。
選択メニューの テンプレートをインポート では、.automadoc ファイルからこのタブ用のテンプレートを作成します。エクスポート、インポート、コピーを参照してください。
テンプレートファイルをアップロードする
Section titled “テンプレートファイルをアップロードする”テンプレート タブで テンプレートファイルをアップロード をクリックし、Word（.docx）、Excel（.xlsx）、PowerPoint（.pptx）のファイルを選びます。ファイルはアップロード時にチェックされます。エラーがある場合はサイドバーに表示されるので、ファイルを置き換え で修正したファイルをアップロードしてください。
プレースホルダーは列名から名付けられ、どのプラットフォームとも同じ構文を使います。スペース、ドット、そのほかの記号は _ になり、あらゆる言語の文字と数字はそのまま残ります。
| 列名 | プレースホルダー |
|---|---|
Customer |
{Customer} |
Invoice No. |
{Invoice_No_} |
Unit price |
{Unit_price} |
同じ名前の2つ目の列は {Notes_2}、3つ目は {Notes_3} になるため、互いに上書きすることはありません。名前のない列は除外されます。
セルの種類ごとにテンプレートに渡るもの
Section titled “セルの種類ごとにテンプレートに渡るもの”どのセルも、シートに表示されているとおりに出力されます。number、currency、date などのフィルターは、その元の値に対して働きます。
| セルの内容 | テンプレートでの扱い |
|---|---|
| テキスト | そのテキスト |
| 数値、通貨、パーセント | 数値。シートの書式どおりに出力されます |
| 日付、日時 | 日付。シートの書式どおりに出力されます |
| チェックボックス | はいかいいえ。{#if Paid}…{/if} に使えます |
| プルダウン | その選択肢。複数選択のプルダウンはリストになります |
| ユーザーチップ | 人（名前とメールアドレス）のリスト |
| リンク、またはスマートチップのリンク | そのリンク |
| ファイルチップ、または Drive ファイルへのリンク | ファイル。画像と {ATTACH:…} に使えます |
=IMAGE("https://…") |
画像 |
データと書き戻しの設定
Section titled “データと書き戻しの設定”データ セクションには、テンプレート名、見出し行、キー列 と、テンプレート自体の形式の代わりに PDFドキュメント(.pdf) を作るスイッチがあります。変更したら 保存 をクリックします。
シートへの書き戻し では、結果をシートに書き込みます。
- ステータス列：各行の生成ステータスがこの列に書き込まれます。
- リンク列：生成した各ドキュメントへのリンクがこの列に書き込まれます。セルにすでにリンクがある場合 は、置き換える か 新しい行を追加（以前のリンクが1行に1つずつ残ります）を選びます。
リンク列には、Pro、トライアル、または自分のシートが必要です。ステータス列には、Pro、トライアル、または Business シートが必要です。これらがない場合はサイドバーにその旨が表示され、設定はオフのままになります。プラン、シート、パックを参照してください。
タブの下部にある テンプレートを削除 でテンプレートを削除します。シートには一切触れません。
テンプレートファイルをアップロード（または ファイルを置き換え）の横にある 列から作成 は、タブのすべての列のプレースホルダーを入れ、関連タブの列をループにした Word テンプレートを作成し、テンプレートのファイルとして保存します。先に変更を保存してください。スターターは保存済みの見出し行と関連タブから作成されます。
ファイル名と 1 回の生成で作るドキュメント
Section titled “ファイル名と 1 回の生成で作るドキュメント”データ セクションの 出力ファイル名パターン で各ファイルの名前を決めます。波かっこで囲んだ列名は、その行の値に置き換わります（例: 請求書-{請求書番号}）。空欄にするとテンプレート名と行が使われます。
Word テンプレートでは、1 回の生成で作るドキュメント で レコードごとに1つの文書 か、選択したすべての行から 1 つの文書（一覧、行ごとに繰り返すテンプレート、ラベルのシート）を選べます。結合ドキュメント を参照してください。
別のタブの行を各ドキュメントに取り込めます（請求書の明細行、顧客の詳細など）。関連タブ で リレーションを追加 をクリックし、次を設定します。
- テンプレートでの名前: プレースホルダー（例:
Items） - 行の取得元タブ: 行があるタブ
- 照合する列: そのタブで、この行の値（請求書番号など）を持つ列
- このタブの照合先の列: キー列、またはこのタブの別の列
- 行:
{#Items}{明細}{/Items}には 一致するすべての行（ループ）、{顧客.名前}には 最初に一致した行
保存 をクリックします。タブの名前を変えてもリレーションはそのタブに従います。1 つのテンプレートに設定できるリレーションは最大 20 個です。
変数 タブには、タブと関連タブから読み取ったテンプレートのすべてのプレースホルダーが表示されます。クリックしてコピーし、テンプレートに貼り付けてください。関連タブの列は、そのループまたは入れ子のレコードの下に表示されます。
行を選択して生成する
Section titled “行を選択して生成する”- 生成 タブを開き、選択メニューでテンプレートを選びます。
- シートで行を選択します。行番号をクリックし、複数選ぶには Shift または Ctrl（Mac では ⌘）を押しながら選択します。セルを選択した場合は、そのセルがある行が数えられます。
- サイドバーに行数が表示されます（1 行を選択中、12 行を選択中）。ドキュメントを生成 または {count} 件のドキュメントを生成 をクリックします。
1回の生成に入れられるのは500行までです。サイドバーが選択に追従しなくなった場合（操作がないとしばらくして一時停止します）は、更新 をクリックします。
進捗カードがドキュメントの状況を表示します。完成したものには ダウンロード と 印刷 があり、キャンセル でまだ始まっていないものを止められます。
テンプレートが複数のレコードから1つのドキュメントを作る場合、サイドバーには 選択中（n） と タブ全体 の選択肢が表示され、最大500行から1つのドキュメントを作ります。
ドキュメントの保存先
Section titled “ドキュメントの保存先”- 常に：サイドバーの進捗カード。ここからダウンロードや印刷ができます。
- リンク列がある場合：ファイルは Google ドライブにも保存されます。保存先はスプレッドシートと同じフォルダーで、AutomaDoc がそのフォルダーにアクセスできない場合はマイドライブです。行のセルには、ファイル名を付けたリンクが入ります。複数の行から作った1つのドキュメントは一度だけ保存され、そのそれぞれの行からリンクされます。
- ステータス列がある場合：ドキュメントの作成に合わせて、各行にステータスが表示されます。
画像とファイル
Section titled “画像とファイル”AutomaDoc が読み取るのはあなたが選択したファイルだけなので、画像は次のいずれかである必要があります。
- セル内、または
=IMAGE("https://…")の中にある、画像への 公開リンク。 - AutomaDoc が開ける Drive ファイル。AutomaDoc 用に選択したファイルか、AutomaDoc が作成したファイルです。
AutomaDoc が開けない Drive ファイルはドキュメントから除外され、その列名を示す警告が出ます。Google ドキュメント、スプレッドシート、スライド、図形描画のファイルは、{ATTACH:…} によって PDF として PDF に追加されます。ただし、Google がこうしたファイルを PDF として書き出せるのは 10 MB までです。1つのファイルは最大 20 MB です。
接続を解除する
Section titled “接続を解除する”その他 にある Google ドライブへのアクセスを解除 で、Google ドライブのファイルへの AutomaDoc のアクセスを取り除きます。許可は Google 側で取り消され、テンプレートは残り、生成時にはスプレッドシートをもう一度接続するよう求められます。会社ポータルの 接続 ページで解除することもできます（Excel、SharePoint、Dataverse、Google Sheets の接続を参照）。
アドオン自体を削除するには、Google Sheets で 拡張機能 → アドオン → アドオンを管理 を使います。
プランとヘルプ
Section titled “プランとヘルプ”その他 の プラン では、管理者に プランを管理 が表示されます。プラン、シート、ドキュメントパックは、ブラウザで開く会社ポータルで購入します。メンバーには、どの管理者に依頼すればよいかが表示されます。ヘルプとドキュメント でこのドキュメントサイトが開きます。