カスタムインタラクティブフィルターの基本 - Support and Troubleshooting - Now Support Portal

<script custom-tag="" type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"カスタムインタラクティブフィルターの基本","image":"http://support.servicenow.com/29f1d2661baf6010cafa53d8624bcb43.iix","author":{"name":"ServiceNow Support","url":"http://support.servicenow.com/now"},"keywords":"ServiceNow, NowSupport public Knowledge Base articles, Support and Troubleshooting,KB1710807,","wordcount":"324","publisher":"ServiceNow","url":"https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1710807","datePublished":"2024-12-19","dateCreated":"2024-12-05","dateModified":"2025-01-19","description":"<h2>カスタムインタラクティブフィルターの基本</h2><br/><div style=\"overflow-x:auto\"><p><span style=\"font-size: 10pt; font-family: verdana, geneva;\">カスタムのインタラクティブフィルターを使用すると、異なるテーブルを使用して複数のレポートをフィルターで絞り込むことができます。単一または複数のテー","articleBody":"<h2>カスタムインタラクティブフィルターの基本</h2><br/><div style=\"overflow-x:auto\"><p><span style=\"font-size: 10pt; font-family: verdana, geneva;\">カスタムのインタラクティブフィルターを使用すると、異なるテーブルを使用して複数のレポートをフィルターで絞り込むことができます。単一または複数のテーブルのインタラクティブフィルターを公開する API は 2 種類あります。</span></p>\r\n<p><span style=\"font-size: 10pt; font-family: verdana, geneva;\">カスタムインタラクティブフィルターを作成する際には、次の点に注意してください。</span></p>\r\n<ul style=\"list-style-position: inside;\"><li style=\"font-size: 10pt; font-family: Calibri, sans-serif; color: black;\"><span style=\"font-size: 10pt; font-family: verdana, geneva;\">カスタムインタラクティブフィルターを 1 つのテーブルでのみ使用する予定の場合は、 <strong><em>DashboardMessageHandler.publishFilter()</em></strong> 関数を使用できます。</span></li><li style=\"font-size: 10pt; font-family: Calibri, sans-serif; color: black;\"><span style=\"font-family: verdana, geneva; font-size: 10pt;\">カスタムインタラクティブフィルターを複数のテーブルに適用する予定の場合は、 <strong><em><span style=\"color: black;\">DashboardMessageHandler.publishMessage()</span></em></strong> 関数を使用できます。 </span></li><li style=\"font-size: 10pt;\"><span style=\"font-family: verdana, geneva; font-size: 10pt;\">インタラクティブフィルターを公開する前に、Orlando 以降は <strong><em>SNC.canvas.interactiveFilters.setDefaultValue(</em>)</strong> 関数を呼び出す必要があります。</span></li><li style=\"font-size: 10pt; color: black;\"><span style=\"font-family: verdana, geneva; font-size: 10pt;\">フィルターをリセットする前に、関数 <strong><em>SNC.canvas.interactiveFilters.removeDefaultValue()</em></strong> または <strong><em>DashboardMessageHandler.removeFilter()</em></strong> を呼び出す必要があります。</span></li></ul>\r\n<p style=\"margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: Calibri, sans-serif;\"> </p>\r\n<p style=\"margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: Calibri, sans-serif;\"><span style=\"font-size: 10pt; font-family: verdana, geneva;\">ServiceNow <a title=\"Docs\" href=\"https://docs.servicenow.com/bundle/orlando-performance-analytics-and-reporting/page/use/dashboards/reference/r_CustomPublisherExample.html\">ドキュメント</a> サイトには、以前は単一のテーブルに対するインタラクティブフィルターの使用に関する例のみが掲載されていました。API <strong><em><span style=\"color: black;\">DashboardMessageHandler.publishMessage()</span></em></strong> についてもドキュメント化されています。ドキュメントでも同様の情報を見つけることができます。</span></p>\r\n<ol style=\"list-style-position: inside;\"><li style=\"font-size: 10pt; font-family: Calibri, sans-serif;\"><span style=\"font-size: 10pt; font-family: verdana, geneva;\">2 つの <strong>DashboardMessageHandler</strong> インスタンスを作成し、 <span style=\"font-family: verdana, geneva;\"><strong><em>publishFilter()</em></strong></span> メソッドを 2 回呼び出します。インタラクティブフィルターに従うすべてのレポートウィジェットが 2 回更新されます。</span></li><li style=\"font-size: 10pt; font-family: Calibri, sans-serif;\"><span style=\"font-size: 10pt; font-family: verdana, geneva;\">2 つ以上のテーブルに対してフィルターを使用する必要がある場合は、配列が作成され、ループ内で <strong>N</strong> <strong>DashboardMessageHandler</strong> インスタンスが構築されます。<strong>publishFilter()</strong> メソッドは <strong>N</strong> 回呼び出されるため、インタラクティブフィルターに続くすべてのレポートが <strong>N</strong> 回更新され、パフォーマンスの問題が発生する可能性があります。</span></li></ol>\r\n<h1><span style=\"font-size: 12pt;\"><strong><span style=\"font-family: verdana, geneva;\">カスタムインタラクティブフィルターを複数のテーブルに適用する方法</span></strong></span></h1>\r\n<p style=\"margin: 0cm 0cm 0.0001pt; font-size: 12pt; font-family: Calibri, sans-serif;\"><span style=\"font-family: verdana, geneva; font-size: 10pt;\">以下の例では、カスタムインタラクティブフィルターを使用して、アサイン先グループ別に <strong>incident</strong> テーブルと <strong>problem</strong> テーブルを使用してレポートをフィルタリングします。例：</span></p>\r\n<ul style=\"list-style-position: inside;\"><li style=\"font-size: 10pt; font-family: Calibri, sans-serif;\"><span style=\"font-family: verdana, geneva; font-size: 10pt;\">未解決の問題の数</span></li><li style=\"font-size: 10pt; font-family: Calibri, sans-serif;\"><span style=\"font-size: 10pt;\"><span style=\"font-family: verdana, geneva;\">オープンインシデントの数</span> </span></li></ul>\r\n<p><span style=\"font-size: 10pt;\"><span style=\"font-family: verdana, geneva;\"><strong><em><span style=\"color: black;\">DashboardMessageHandler.publishMessage() </span></em></strong></span><span style=\"font-family: verdana, geneva;\">複数のフィルターを配列として受け入れるので、フィルター配列を適切に構築し、 <strong>DashboardMessageHandler</strong> のインスタンスを 1 つだけ作成し、 <strong>DashboardMessageHandler.publishMessage([filters])</strong> を呼び出すことができます。これによりウィジェットは 1 回だけ更新され、 <strong><em>DashboardMessageHandler.publishFilter()</em></strong> を複数回呼び出すよりもパフォーマンスが向上します。 </span></span></p>\r\n<p> </p>\r\n<h2><span style=\"font-size: 10pt;\"><span style=\"font-size: 12pt;\"><strong>例：<br /></strong></span><br /></span></h2>\r\n<h2><?xml version="1.0" encoding="utf-8" ?><br /><j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null"><br /><script><br />var my_dashboardMessageHandler = new DashboardMessageHandler("my_unique_id");<br /><br />function publishMultipleFilter() {<br /><br />var finalFilter = [{"table":"incident","filter":"assignment_group=6fcd3b573b331300ad3cc9bb34efc447"}, {"table":"problem","filter":"assignment_group=6fcd3b573b331300ad3cc9bb34efc447"}];<br /><br />SNC.canvas.interactiveFilters.setDefaultValue({<br />id: my_dashboardMessageHandler._unique_id,<br />filters: finalFilter,<br />}, false);<br /><br /><br />my_dashboardMessageHandler.publishMessage(finalFilter);<br />}<br /><br />function clearFilter() {<br />SNC.canvas.interactiveFilters.removeDefaultValue(my_dashboardMessageHandler._unique_id, false);<br />my_dashboardMessageHandler.removeFilter();<br />}<br /></script><br /><br />Example of a filter that filters incident and problem table where assign_ment group is Problem solving <br/><br /><input id="allTasks" type="button" value="All" onclick="clearFilter();" /><br /><input id="onlyMine" type="button" value="Assignment group is [Problem solving]" onclick="publishMultipleFilter();" /><br /><br /></j:jelly></h2></div>"}</script>

Loading...