Sheetコンポーネント
Last updated
Last updated
Lightning Experience環境では、作成したシートを画面部品としてページ内に配置できる「Sheetコンポーネント」を利用できます。これによってホーム画面やレコード詳細ページなどでもMashmatrix Sheetのレコード閲覧・編集のインターフェースを利用することが可能になります。
LightningページにSheetコンポーネントを配置するには、以下の手順に従います。
ページ内に配置したいブックのブック設定、あるいはシートのシート設定から、ブックIDおよびシートIDを確認しメモしておきます。
Lightning アプリケーションビルダーにアクセスし、Sheetコンポーネントを配置したいページを開きます。
画面左側のコンポーネント一覧から「Mashmatrix Sheet」を検索し、該当のコンポーネントをドラッグしてページ内の領域にドロップします。
ドロップしたコンポーネントが選択された状態で、右側のプロパティ設定から「Book ID」として先程メモしたブックIDを入力します。
ブック内の特定のシートのみを表示したい場合は「Sheet ID」に先程メモしたシートIDを入力します。
コンポーネントの高さを指定する場合、「Height」に高さを指定します。高さには「数値＋単位」のようにCSSで用いられる形式で大きさを指定できます。単位としてはpx, em, rem, %, vh, vwがサポートされています。単位を省略した場合はpx（ピクセル）として取り扱われます。
必要に応じてコンポーネントのヘッダとなるタイトルを「Title」に入力します。
Message Channel APIを利用してSheetコンポーネントと連携するカスタムアプリケーションの開発を行う場合には、「Publish Events in Message Channel」プロパティのチェックおよび「Component ID」プロパティの入力が必要になる場合があります。
Sheetコンポーネントをレコードページに配置する場合に、表示しているレコードに関連したもののみがシート内に表示されるようにするためには、あらかじめ配置されるシートに対して適切にフィルタ設定がされている必要があります。
レコードに関連したものが表示されるようにフィルタを設定するには、以下の手順に従います。
レコードページのオブジェクトへの参照ID項目をシート内の列として追加します。
1) で追加した列の列メニューからフィルタを選択します。
フィルタ設定ダイアログで、フィルタ値入力ボックスの右にある「参照値選択ボタン」をクリックし、参照値選択ダイアログを表示します。
ダイアログから参照の種別として「関連するレコードID」を選択し、フィルタを適用します。
必要に応じて、1) で追加した列を非表示に設定します。
たとえば、取引先レコードページに商談シートを配置する場合は、商談シートに「取引先ID」項目を列として追加します。追加した「取引先ID」列のフィルタ設定で参照値として「関連するレコードID」を選びます。
レコードページに配置したSheetコンポーネントの中で新規レコードを作成する際、以下の場合には新規レコードに現在表示しているレコードのIDが自動的に設定されます。
フィルタを設定した列に表示している参照ID項目がシート内に表示している主オブジェクトに直接所属している項目である
例：取引先レコードページにケースを一覧するシートを表示している場合、「取引先ID」項目でのフィルタは対象となるが、「取引先 > 取引先ID」項目や「親ケース > 取引先ID」項目などでのフィルタでは対象とならない
フィルタを設定した列に表示している参照ID項目が編集可能である
