標準機能で足りないときの実現レシピ

手段の選び方と、作り込むときの注意

1. どの手段を選ぶか：スクリプト・サーバスクリプト・API・拡張SQL・拡張機能の使い分け
2. 作り込むときの注意：バージョンアップのときの確認、性能、引き継ぎ
3. 困ったとき：年間サポートで聞けること、開発元やパートナーに頼む方法

標準機能でできること

1. 分析チャート：状況・担当者・分類などの項目ごとに、件数・合計・平均・最大・最小を円グラフで表示します。円グラフは複数並べられます
2. 時系列チャート：分類項目ごとの件数や、数値項目の合計・平均などを、面または折れ線のチャートで表示します。横軸は、日付項目や履歴から選べます
3. クロス集計：列に分類項目か日付項目、行に分類項目か数値項目を選んで集計します。バージョン1.5.8.0以降では、セルをクリックして、集計の対象になったレコードを一覧で確かめられます
4. 一覧画面の集計：レコードの件数や、数値項目の合計・平均などを、一覧画面に表示します。フィルタをかけると、その条件で集計し直します
5. ダッシュボード：タイムライン・カレンダー・カンバン・一覧などのパーツを並べられます。カレンダーと一覧のパーツでは、複数のテーブルのレコードをまとめて表示できます

分析チャートと時系列チャートの有効・無効は、テーブルの管理で切り替えられます。

足りないときの実現のしかた

マニュアルの該当ページ

標準機能
マニュアル：レコードの分析チャート表示
マニュアル：レコードの時系列チャート表示
マニュアル：レコードのクロス集計表示
マニュアル：レコードの集計
マニュアル：ダッシュボード機能

足りないとき
マニュアル：ダッシュボード機能：カスタムHTML
マニュアル：API：複数レコード取得
マニュアル：API：テーブルのエクスポート
FAQ：APIで200レコードを超えるデータを取得したい
マニュアル：スクリプト：イベント発火
FAQ：プリザンターに設定した日本語の表示名でデータベースのビューを作成したい
認定パートナーが提供するソリューション（BI・視覚化）

うまくいかないときは、年間サポートで書き方を聞けます。
年間サポートで聞けること

やりたいことから選ぶ

1. 画面をそのまま印刷できればよい：ブラウザの印刷機能で印刷します。印刷のときの表示は、スタイル（CSS）で整えられます
2. 決まった書式のExcel・PDFで出したい：認定パートナーのソリューションを使います。Excel・PDFで帳票を出力するツールや、帳票出力の実装を代行するサービスがあり、無償で公開されているものもあります
3. 自分で作る：エクスポートやAPIでデータを取り出し、表計算ソフトなど外部のツールで帳票の形にします

「Excel・帳票出力」の認定パートナーのソリューションを見る

標準機能でできること

1. エクスポート：一覧画面で選んだレコード（選ばなければすべてのレコード）を、CSVファイルに書き出せます。書き出す項目の順序などは、テーブルの管理の「エクスポート」で書式として設定できます
2. 印刷：画面は、ブラウザの印刷機能で印刷します

足りないときの実現のしかた

@media print {
    #MainCommandsContainer {    /* コマンドボタン */
        display:none;
    }
    #Footer {   /* Copyright表記 */
        display:none;
    }
}

テーブルの管理の「スタイル」に登録して使います。手順は、下のFAQにあります。

マニュアルの該当ページ

標準機能
マニュアル：レコードのエクスポート
マニュアル：テーブルの管理：エクスポート（書式の設定）

足りないとき
FAQ：印刷時に画面下部のコマンドボタンを非表示にしたい
マニュアル：開発者ガイド：スタイル
FAQ：入力したデータを帳票に出力して印刷したい
認定パートナーが提供するソリューション（Excel・帳票出力）
FAQ：ExcelからPleasanterへアクセスしたい
マニュアル：応用編：プロセスと状況による制御
マニュアル：サーバスクリプトによるファイルエクスポートサンプル

うまくいかないときは、年間サポートで書き方を聞けます。
年間サポートで聞けること

標準機能でできること

1. プロセス：状況を進めるボタン、入力検証、状況ごとの条件、ボタンを表示する相手のアクセス制御、自動採番、ボタンを押したときの通知を設定できます
2. 状況による制御：状況に応じて、レコードを読取専用にしたり、項目ごとに入力必須・読取専用・非表示を設定したりできます
3. 多段の例：マニュアルのサンプルコード集に、申請金額に応じて最大3段階の承認を経て経理で確定する、差戻しつきの承認プロセスを、プロセスと状況による制御で作る例があります。デモ環境の「稟議申請の例」で、設定を確かめられます

インポート・一括更新・APIでレコードを登録・更新するときは、状況による制御の読取専用や入力必須の設定は働きません。

足りないときの実現のしかた

マニュアルの該当ページ

標準機能
マニュアル：テーブルの管理：プロセス
マニュアル：テーブルの管理：状況による制御
マニュアル：応用編：プロセスと状況による制御
FAQ：稟議申請などのワークフロー（承認プロセス）をプロセス機能で実現する
FAQ：項目の非表示や読取専用などの状態変更を「状況による制御」機能で実現する
FAQ：利用シーンにあわせた通知設定をしたい（承認担当者のグループへの通知の例）

足りないとき
マニュアル：サンプルコード集
FAQ：稟議申請などのワークフロー（承認プロセス）をサーバスクリプトで実現する
FAQ：稟議申請ワークフローの例のサイトパッケージをインポートする
マニュアル：スクリプト：$p.execProcess
マニュアル：Site Visualizer：プロセス図表示
プリザンターで作るワークフローの紹介

うまくいかないときは、年間サポートで書き方を聞けます。
年間サポートで聞けること

標準機能でできること

1. リンク：テーブルの間に親子の関係を設定できます。親のレコードの編集画面に、リンクした子のレコードの一覧と、子のテーブルへの新規作成ボタンが表示されます
2. サマリ：子のレコードの件数や、数値項目の合計・平均・最大・最小を、親のレコードの数値項目に入れられます
3. 一覧編集：一覧編集種別を「一覧画面で編集」にすると、編集画面に移らずに、一覧画面でレコードを編集できます。タイトル・内容の項目やコメントの項目は編集できないなどの制限があります
4. インポート：CSVファイルから、レコードをまとめて取り込めます。キーにする項目を指定して、すでにあるレコードを更新することもできます

足りないときの実現のしかた

{
    "ApiVersion": "1.1",
    "ApiKey": "（APIキー）",
    "Keys": [
        "ClassA"
    ],
    "KeyNotFoundCreate": true,
    "Data": [
        {
            "Title": "新機能XXを開発する1",
            "ClassHash": {
                "ClassA": "RC0001"
            }
        },
        {
            "Title": "新機能XXを開発する2",
            "ClassHash": {
                "ClassA": "RC0002"
            }
        }
    ]
}

マニュアルに載っているサンプルです。このJSONを、/api/items/{サイトID}/bulkupsert にPOSTします。この例では、分類Aをキーにしています。APIキーは、環境に合わせて読み替えてください。

マニュアルの該当ページ

標準機能
マニュアル：応用編：リンク
マニュアル：テーブルの管理：サマリ
マニュアル：レコードの一覧編集
マニュアル：テーブルの管理：一覧編集種別
マニュアル：レコードのインポート
マニュアル：インポート時のキー項目指定

足りないとき
マニュアル：API：レコード一括作成・更新
FAQ：バッチ処理でCSVファイルを読み込んで対象のレコードを作成または更新したい
マニュアル：スクリプト：$p.apiCreate
FAQ：更新ボタンを押したタイミングで別テーブルに新規レコードを作成したい
マニュアル：サーバスクリプト：items.Create
マニュアル：サーバスクリプトによるファイルインポートサンプル

うまくいかないときは、年間サポートで書き方を聞けます。
年間サポートで聞けること

標準機能でできること

1. リマインダー：期日を過ぎたレコードや、指定した範囲内で期日が近づいたレコードを、指定した時刻と周期（毎日・毎週・毎月など）で通知します。通知には、メールやチャットツールを使えます
2. 対象の絞り込み：状況が完了・保留のレコードは、既定では通知されません。条件にビューを指定して、対象を絞ることもできます
3. 宛先：固定のメールアドレスのほか、レコードの担当者・管理者や、項目に書かれたメールアドレスを宛先にできます
4. 通知：レコードの作成・更新・削除のときに通知します。ビューと組み合わせて、通知する条件を指定できます

リマインダーを使うには、あらかじめサーバー側でリマインダー機能を有効にしておきます。

足りないときの実現のしかた

let notification = notifications.New();
notification.Address = 'xxxxx@example.com';
notification.CcAddress = 'yyyyy@example.com';
notification.BccAddress = 'zzzzz@example.com';
notification.Title = '通知テスト';
notification.Body = 'サーバスクリプトから通知しています。';
notification.Send();

使うには、パラメータ（Notification.json）で、対象の通知種別を有効にしておきます。

マニュアルの該当ページ

標準機能
マニュアル：テーブルの管理：リマインダー
マニュアル：リマインダーの宛先を動的に設定する
マニュアル：プリザンターのリマインダー機能を有効化する
マニュアル：テーブルの管理：通知

足りないとき
マニュアル：サーバスクリプト：notifications
マニュアル：サーバスクリプト：notification.Send
マニュアル：テナント管理機能：バックグラウンドサーバスクリプト
マニュアル：大規模環境でリマインダー利用におけるDBの定常負荷を低減する

うまくいかないときは、年間サポートで書き方を聞けます。
年間サポートで聞けること

標準機能でできること

1. 入力必須：項目ごとに、入力必須を設定できます
2. 入力検証：タイトル・内容・分類・説明・コメントの項目は、入力した内容を正規表現で検証し、エラーメッセージを表示できます。項目からフォーカスが移ったときの検証と、レコードの作成・更新のときの検証を設定できます
3. 状況による制御：状況に応じて、項目を入力必須にできます。日付が未入力のときに、別の項目を入力必須にする設定例がFAQにあります
4. プロセス：プロセスのボタンごとに、入力検証を設定できます

足りないときの実現のしかた

マニュアルの該当ページ

標準機能
マニュアル：項目の詳細設定：入力必須
マニュアル：項目の詳細設定：入力検証
FAQ：日付が未入力の場合に別の分類項目を入力必須にしたい
マニュアル：プロセス：入力検証

足りないとき
FAQ：独自の入力検証を行い、その結果によりメッセージを表示したい
マニュアル：スクリプト：$p.events.before_validate
マニュアル：サーバスクリプト：context.Error
開発者向けのページ（サーバスクリプトで更新を止めるコードの例）

うまくいかないときは、年間サポートで書き方を聞けます。
年間サポートで聞けること

標準機能でできること

1. 計算式（既定）：数値項目を対象に、四則演算と、かっこによる計算順序の変更ができます
2. 計算式（拡張）：数値・分類・日付・説明・チェックの項目を使い、関数（日付・時刻、文字列、論理、数学、統計など）と場合分けの計算ができます。関数を使うときは「拡張」を選びます
3. 計算のタイミング：画面を表示したとき、レコードを追加・更新・削除したときに計算します。計算式を足す前に作ったレコードには、「同期」で反映します
4. 条件つきの計算：ビューのフィルタ条件を満たすときと、満たさないときとで、別の計算式を使えます

計算式（拡張）でエラーが起きたときは、計算結果は表示されませんが、レコードの更新は正常に終わります。

足りないときの実現のしかた

マニュアルの該当ページ

標準機能
マニュアル：テーブルの管理：計算式
マニュアル：計算式（既定）
マニュアル：計算式（拡張）
マニュアル：計算式（拡張）の関数

足りないとき
FAQ：編集画面を登録・更新する際に誕生日から年齢を自動計算したい
FAQ：状況項目の値により進捗率を自動で指定する
マニュアル：サーバスクリプト：条件
FAQ：ある項目の値を特定の値に変更したときに別の項目の値を変更する

うまくいかないときは、年間サポートで書き方を聞けます。
年間サポートで聞けること

標準機能でできること

1. リンク：親のテーブルのタイトルを、子のテーブルの分類項目に選択肢として表示します。選択肢に親のタイトル以外の項目を出したり、画面の項目の値で選択肢を絞り込んだりもできます
2. ルックアップ：リンク先のレコードを選んだときに、その項目の値を自分のテーブルの項目に転記します。たとえば商談のテーブルで顧客を選ぶと、顧客のテーブルの住所や電話番号を転記できます。組織・グループ・ユーザの情報も転記できます
3. 一覧画面：リンクしたテーブルの、タイトル以外の項目を一覧に表示できます
4. サマリ：子のレコードの件数や、数値項目の合計・平均などを、親のレコードの数値項目に入れられます

ルックアップは転記した値を登録するので、親のテーブルの値をあとで変えても、転記した値は変わりません。複数選択にした項目では使えません。

足りないときの実現のしかた

マニュアルの該当ページ

標準機能
マニュアル：応用編：リンク
マニュアル：項目の詳細設定：ルックアップ
FAQ：ルックアップ機能を使用して組織・ユーザ・グループの情報を取得する
FAQ：親テーブル、子テーブルの項目を一覧画面に表示したい
マニュアル：テーブルの管理：サマリ

足りないとき
FAQ：親テーブルの項目の値を子テーブルの項目に転記したい
マニュアル：スクリプト：$p.apiGet
マニュアル：サーバスクリプト：items.Get
FAQ：親・子・孫とリンクしているとき、孫テーブルのサマリ結果が親テーブルに反映されない
FAQ：プリザンターから外部DBのテーブルを参照したい

うまくいかないときは、年間サポートで書き方を聞けます。
年間サポートで聞けること

標準機能でできること

1. 通知：レコードの作成・更新・削除のときに、メールやチャットツールに通知します。通知種別に「HTTPクライアント」を選ぶと、指定したURLにリクエスト（GET・POST・PUT・DELETE）を送れます（バージョン1.3.17.0以降。パラメータ（Notification.json）で有効にします）
2. インポート・エクスポート：CSVファイルで、レコードを取り込んだり書き出したりできます

足りないときの実現のしかた

マニュアルの該当ページ

標準機能
マニュアル：テーブルの管理：通知
マニュアル：HTTPクライアントで通知できるように設定する
マニュアル：レコードのインポート
マニュアル：レコードのエクスポート

足りないとき
マニュアル：API
マニュアル：APIキーの作成
マニュアル：サーバスクリプト：httpClient
マニュアル：拡張SQL
FAQ：プリザンターから外部DBのテーブルを参照したい
FAQ：バッチ処理でCSVファイルを読み込んで対象のレコードを作成または更新したい
FAQ：ExcelからPleasanterへアクセスしたい

うまくいかないときは、年間サポートで書き方を聞けます。
年間サポートで聞けること

標準機能でできること

1. フォーム：記録テーブルまたは期限付きテーブルを、公開アドレスで、アカウントを持たない外部のユーザに公開します。外部のユーザは、公開アドレスからレコードを作成できます
2. 公開の期間：開始日時と終了日時を設定できます（UTCで設定します）。期間外にアクセスした人には、利用できない旨を表示します。送信したあとに、回答者への伝達事項を表示できます
3. 入力する項目：公開する画面の項目は、ふだんのエディタの設定で作ります
4. 安全に使うための設定：CAPTCHA（Cloudflare Turnstile・Google reCAPTCHA）を使えます。SSL/TLSの導入が推奨されています

使うには、パラメータ（Form.json）でフォーム機能を有効にし、プリザンターを再起動します。ログインしているユーザの権限で動く一部のスクリプト・サーバスクリプトは、フォームでは動きません。

足りないときの実現のしかた

フォームで足りない場合の代わりの作り方は、マニュアルにはサンプルがありません。ほかのシステムやWebサイトからデータを登録する場合は、APIを使います（ほかのシステムとつなぎたい）。

マニュアルの該当ページ

標準機能
マニュアル：テーブルの管理：フォーム
マニュアル：フォーム：基本設定
マニュアル：フォーム：より安全に利用するための設定
マニュアル：パラメータ：Form.json

足りないとき
マニュアル：API：レコード作成

うまくいかないときは、年間サポートで書き方を聞けます。
年間サポートで聞けること

標準機能でできること

1. 自動採番：タイトル・内容・分類・説明の項目に、書式に沿って番号を振ります。[NNNN]は固定長、[n]は可変長の連番です。日付（[yyyyMM]など）や、ほかの項目の値も書式に入れられます（例：[yyyyMM]-[支店]-[部門]-[NNN] → 202203-横浜支店-営業部-001）
2. 振り直し：年・月・日ごと、または連番以外の部分の文字列が変わったときに、連番を振り直せます（支店ごと・月ごとの連番など）
3. 開始の値と間隔：既定値（開始の値）と、ステップ（間隔）を設定できます

足りないときの実現のしかた

マニュアルの該当ページ

標準機能
マニュアル：項目の詳細設定：自動採番

足りないとき
マニュアル：プロセス：自動採番

うまくいかないときは、年間サポートで書き方を聞けます。
年間サポートで聞けること

標準機能でできること

1. テーブルのアクセス制御：テーブル（サイト）ごとに、読取り・作成・更新・削除などの権限を、ユーザ・組織・グループに付けます。フォルダに設定すると、配下のテーブルに引き継げます
2. レコードのアクセス制御：特定のレコードだけに権限を付けられます。テーブルの管理で、レコードの作成時・更新時に、作成した人の組織や、担当者・管理者などへ自動で権限を付ける設定もできます（すでにあるレコードの権限は変わりません）
3. 項目のアクセス制御：作成時・読取り時・更新時のそれぞれで、項目を使える人を制限します。読取りの権限が無い人には、項目が表示されません
4. ビューとプロセスのボタン：ビューを使える人や、プロセスのボタンを表示する人を指定できます（例：経理部の人だけに「支払」ボタンを表示する）

読取り時のアクセス制御を設定した項目をタイトルの結合に入れると、タイトルの上ではアクセス制御が働きません。

足りないときの実現のしかた

サーバスクリプトも、ログインしているユーザの権限で実行されます。アクセス権の無い操作はできません。

マニュアルの該当ページ

標準機能
マニュアル：アクセス制御の概要
マニュアル：テーブルの管理：サイトのアクセス制御
マニュアル：テーブルの管理：レコードのアクセス制御
マニュアル：テーブルの管理：項目のアクセス制御
マニュアル：ビュー：アクセス制御
マニュアル：プロセス：アクセス制御

足りないとき
マニュアル：サーバスクリプト：view.Filters
FAQ：一覧表示するレコードを所属組織別に分けたい
マニュアル：サーバスクリプト：items.Update
誰が何を見られるかを一覧で確かめる（Enterprise Editionのツール）

うまくいかないときは、年間サポートで書き方を聞けます。
年間サポートで聞けること

スクリプトとサーバスクリプトは、ログインしているユーザの権限で実行されます。
マニュアル：開発者ガイド
拡張の仕組みの全体像と、コードの例（開発者向けのページ）

1. バージョンアップ：プリザンターを上げるたびに、足した処理の動作を確かめます。新しいバージョンで変わったことは、リリースノートで確かめられます
2. 性能：サーバスクリプトでレコードの読み書きを行うと、サーバー側の処理の負荷が増えることがあります。実行時間がタイムアウトの時間を超えると、処理が止まります
3. サンプルコード：マニュアルのサンプルコードは、すべてのケースでの動作を保証するものではありません。お使いの環境で動作を確かめてから使います
4. 引き継ぎ：スクリプトで足した処理は、作った方が保守します。担当者が替わると、引き継ぎが要ります
5. 環境の移行：サイトパッケージで別の環境へ移すと、サイトIDやレコードIDが変わります。スクリプトの中にIDを直接書いている場合は、移したあとに書き換えが要ります
6. 生成AIで書いたスクリプト：AIに書かせたスクリプトも、作った方が保守することと、バージョンアップのたびに動作を確かめることは同じです

マニュアル：リリースノート
マニュアル：サーバスクリプト：items（注意事項）
マニュアル：サンプルコードのご利用について（免責事項）
マニュアル：サイトパッケージのインポート
バージョンアップ・環境移行の進め方
作る人や使う部署が増えるとき（部署から全社へ：全社で使うときのガイド）
生成AIとプリザンターを組み合わせる

多くの利用者に役立つ機能なら

ほかの利用者にも役立つ汎用的な機能であれば、スクリプトで作り込むほかに、2つの方法があります。機能の要望としてGitHubのIssueに書く方法と、技術支援サービスの「標準機能追加」で、プリザンター本体の標準機能として追加する開発を開発元に依頼する方法です。

標準機能で足りないとき（スクリプトで作り込む場合と、標準機能の追加を依頼する場合の違い）
GitHub：プリザンターのIssue（機能の要望）

スクリプトの編集と反映の手間を減らすツール

Enterprise Editionに含まれるCode Assist（Visual Studio Codeの拡張機能）を使うと、Visual Studio Codeでスクリプト・サーバスクリプト・スタイルなどを保存したときに、同時にプリザンターへ登録・更新されます。自社の環境に構築したCommunity Editionでは、トライアル機能で90日間試せます。

マニュアル：Code Assist
Code Assist・Site Visualizerなどで、困りごとがどう変わるか（Enterprise Editionのツール）
90日間のトライアルのご案内

年間サポートで質問する

年間サポートサービスでは、「スクリプトをどう書けばよいか」といった質問を、開発元のサポートエンジニアにできます。開発機能についてのアドバイスや、サンプルスクリプトの提供を受けられます。機能の要望は、年間サポートでは受け付けていません。GitHubのIssueにお書きください。

年間サポートで聞けること（相談の例と対応の一覧）

開発元に頼む

設計のレビュー、外部システムとの連携、性能の改善などをまとめて頼みたい場合は、個別の有償サービスの技術支援サービスがあります。

技術支援サービス

認定パートナーに頼む

構築を任せたい場合は、認定パートナーを探せます。帳票出力やデータの可視化など、認定パートナーが提供するソリューションもあります。

認定パートナーを探す
認定パートナーが提供するソリューション

学ぶ

公式トレーニングでは、基本操作から業務アプリの設計・構築、拡張スクリプトの活用まで、レベル別に学べます。

公式トレーニング