05:56更新フォローするこんにちは。今回はOfficeアドインを使ったExcel帳票を作成し、それをViewFramerを通してkintoneから出力をする手順をご紹介したいと思います。Office」というアドインを利用して、動的項目の設定を行います。最初に事前の準備物をチェックします。Live(デザイナー)を契約されていればどなたでもお使いいただけますが、2018年11月以前にご契約のライセンスでは、一部有効化が必要になる場合があります。有効化はサポートが行いますので、サポートサイトから「Officeアドイン版を使いたい!」とお問い合わせください。Office2013以上のバージョンである必要があります。お手元の端末をご確認ください。2.Officeアドインを設定するまず、デザインをあらかじめExcelで作ります。(白紙から作る方法もありますが、今回はすでにあるExcelを使う形にしたいと思います。)今回、以下のようなデザインを作ってみました。◎アドインをいれるデザインがされているExcelにアドインを挿入しましょう。説明とスクリーンショットはExcel2016になります。すみませんが、2013の方はご参考にしてください。[挿入]タブの[個人用アドイン]をクリックします。するとOfficeアドインの画面が開かれますので、この中の[ストア]を開いてください。検索窓で、「OPRO」と検索してください。Office』というアドインがありますので、こちらを追加してください。追加をすると、[挿入]タブの一番端にOPROアドインのアイコンが出てくると思います。アイコンをクリックすると、右側にアドインの画面が出てきます。使いたいExcelファイルにアドインの追加ができました。◎アドインを使ってマッピングを行うアドインを使って、マッピングを行っていきましょう。アドインで使用するサービスを選択します。今回は[OPROARTS]になります。選択すると、アドインが設定画面になりました。フィールドの作成とマッピングを行っていきましょう!まず作成する帳票タイプですが、もっともポピュラーな「ヘッダー明細型」を作りたいと思います。ヘッダー明細型は、明細と非明細の分けられる帳票です。「TD1」と書いてある欄の「フィールドを追加」を行っていきましょう。ここで追加するフィールドは、明細ではない部分に置きたいフィールドを作成します。-+++【補足】「フィールド」って?帳票に表示したいkintoneの項目と思ってもらえればOKです。イメージとしては、「フィールド」はExcel上に置く箱です。この箱にはデータがはいります。実際のデータ(kintoneの項目)は、ViewFramerで定義し、Excel上のフィールドと紐づけられることになります。-+++フィールド名を入力して[Enter]キーで追加していくことができますが、カンマ区切りやタブ区切りで複数指定して一括登録することもできます。作成したフィールドをExcel上にマッピングしていきます。これでマッピング完了です。この調子ですべてのフィールドをセルにマッピングしていきます。TD1のマッピングが完了したら、明細も行っていきます。「明細テキストデータセットを追加」ボタンをクリックすると、「TD」(TextDataset)が追加されます。今度は明細行のフィールドを作成して、これもマッピングを行います。一通りマッピングができたら、明細行のタグをつけます。アドインの左から2番目のタブを開きます。「現在位置の行を繰り返し出力する」というボタンで、どこが明細行なのかを指定するためのタグを挿入します。タグを挿入する場所は、明細行で使われていないセルです。実際の出力の際にはこのタグは見えなくなります。これでExcelテンプレートのマッピングは以上です。ここで必ず保存をしてください。仕上げとして、作成したExcelファイルをOPROARTSにアップロードします。◎アドイン付きExcelをアップロードするアドインを追加したExcelをOPROARTSと紐づけるために、アップロードを行います。kintoneにログインをして、デザイナー画面を開いてください。-+++【補足】kintoneからデザイナーにアクセスしなくてもいい方法があります。先ほどのExcelのアドインに「OPROARTSへアップロード」というボタンがあります。これをクリックするとブラウザが立ち上がり、デザイナーへのログイン画面が開かれます。Liveにログインしていない場合は、以下のようにログイン画面が表示されます。これはデザイナー用UID/UPWを使ってログインすることができます。Liveにログインしている場合は、一気に新規作成画面まで行くことができます。これはこれから紹介する手順を何個か省略できます。やりやすいと思う手順で作成をしていただいて結構です。-+++手順に戻ります。デザイナー画面で「新規作成」をクリックし、「Excel」タブを開いてください。この時「Excel」「Word」タブが見当たらなかったら、OPROARTSのアドイン機能有効化ができていませんのでサポートにご連絡ください。Excelタブ内を1ページめくっていただいて、「アドイン入りExcelアップロード」をクリックしてください。テンプレートの設定画面になります。以下のように設定をしてください。連携方法:ViewFramer/D3Worker(CSVを選んでも問題ありません)出力形式:Excelテンプレート名:任意の英数字Excelブック:作成したアドイン入りExcelをアップロードする設定できたら「作成」をクリックします。これでExcelのアップロードができました。最後に、テンプレートの配備を行います。配備を行うと、実際にテンプレートとして使用できるようになります。配備状況の「配備」ボタンをクリックしてください。再度配備ボタンをクリックしてください。OPROARTSサーバに「****」テンプレートが配備されています。できたら配備完了です。デザインとマッピングはこれで完了ですので、デザイナータブを閉じてもOKです。3.ViewFramerでマッピングを行うここから先はViewFramerを使って、Excelテンプレートに作成したフィールドに対してkintoneの項目を定義する工程になります。kintone側で帳票に使用するアプリのAPIトークンを取得します。今回はアプリ「ARTS_DEMO」を使用します。~kintone側の定義~1.kintoneの画面で帳票にて利用するアプリの「設定」を開きます。2.「設定タブ」より「APIトークン」を開きます。3.「生成する」ボタンを押しレコードを生成し「保存」します。この時、「レコードの閲覧」、「レコードの編集」にチェックします。同時にレコードIDをコピーします。4.保存後、アプリ設定画面より「アプリを更新」します。~ViewFramer側の定義~1.ViewFramerにログインします。https://vfui.ap.oproarts.com/view_framer_ui2.[認証設定]タブよりログインします。3.帳票にて利用するアプリの「トークン」に生成したレコードのIDを設定し「保存」します。<ヘッダービューを定義>次に、ViewFramer上でヘッダービューを作成します。ヘッダービューは、非明細部分を定義するビューになります。1.「ビュー」タブより「新規」を選択します。2.「基本設定」より任意の「ビュー名」を指定します。指定したら[次へ]で進みます。3.「リレーション設定」の以下の項目を指定します。ViewFramerの画面上ではkintoneの「アプリ」を「オブジェクト」と表記している箇所がございます。主オブジェクト:起点となるアプリを選択し、ショートネームを入力します。オブジェクト」、「項目名」については参照項目とアプリを結びつける条件を指定します。リレーションを追加する際には「+」ボタンを選択し追加します。今回、使用するアプリは1つですので、以下の設定になります。設定が完了したら、[次へ]で進みます。4.「出力項目設定」の以下の項目を指定します。取得元オブジェクトを指定。Liveにて作成したテンプレート上で定義されているフィールド名と以下の赤枠部分を同じにしておけば、後で自動マッピングが可能となります。設定が完了したら、[次へ]で進みます。5.「出力条件設定」ではレコードの出力条件を指定します。見積書に条件を追加するには、以下のように設定してください。パラメータ名は任意ですが、今回は「RecordId」にします。設定が完了したら、保存します。<明細ビューを定義>続いて、明細ビューを作成します。明細ビューは、明細部分を定義するビューになります。ヘッダービューと同様に、「基本設定」より任意の「ビュー名」を指定します。今回は特に設定せず、[保存]をします。<マッピングを定義>ViewFramerの設定は、あと少しで完了です!各ビューを、1つのデータの固まりとしてまとめる「マッピング」の定義を行っていきます。1.[マッピング]タブより「新規」を選択します。2.マッピング名とタイプを指定し、ビューを選択します。マッピング名は任意の名前になります。タイプについては、今回はヘッダー明細型を選択してください。「主データ」では、1任意の名前をつけ、2作成したヘッダービューを選んで[取得]をクリックします。すると、項目が自動で出てきます。「明細データ」は、1、2は同様ですが、3で主データと明細データを紐づけるキーを設定します。[見積番号]が同じであることをキーにしたいので「見積番号」を指定します。3.[Documentizer]タブより、帳票テンプレートとのマッピングを行います。1テンプレートを選択Live側の帳票テンプレートを指定します。「td1」には、主データを選択します。([マッピング管理:詳細画面]で作成したもの)「td2」には、明細データを選択します。([マッピング管理:詳細画面]で作成したもの)3テンプレートのCSVフィールドとビュー定義のデータフィールドをマッピングLive[自動マッピング]でテンプレートと簡単にマッピングできます。手動でマッピングを行ってください。設定が完了したら、[配備]をしてください。4.ボタンを作成するkintoneにログインし、アプリの設定画面を開きます。「プラグインの追加」をクリックします。ViewFramer」をチェックし「追加」をクリックします。ViewFramerの「設定」をしていきます。kintone」を選び、「追加」をクリックします。ViewFramerで作成したマッピングを選んで「追加」をクリックします。次に「編集」をクリックしてボタンの設定を行います。この設定では、ボタン名を好きなように変更することができますよ!「ボタン名を置き換える」にチェックをして任意の名前を付けていきます。(※本コラムではボタン名を「EXCEL出力」とします。)また、全てのユーザーにボタンを表示するために「開発中」のチェックをオフにしておきます。出力形式で「Excel[DDO]」を選択してください。ViewFramerで作成したときにパラメーターを作成した場合は、ここでパラメーター設定を行います。「パラメーター選択」をクリックし、項目を選択します。(※本コラムでは「見積番号」をパラメーターに設定しています。)選択したら、「変更する」をクリックします。ボタン作成までもう一息です!アプリの設定画面に戻り、「アプリを更新」を必ずクリックしてくださいね!アプリ変更の確認画面が表示されるので、「OK」をクリックします。明細データが記載されたExcelが出力されました!<さいごに>Excelのアドイン版はいかがでしたでしょうか?これまでもExcel出力はできましたが、アドインによってとても簡単に作れるようになりました。kintoneを利用したWord出力ランニングコストがかかるのは負担です。結局コスト増になるのでは?コメント0件のコメント記事コメントは受け付けていません。