一意のレコード識別子 (sys_id)

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む3読むのに数分

    • Sys ID (sys_id) と呼ばれる一意の 32 文字の GUID (グローバル一意識別子) によって、インスタンス内の各レコードが識別されます。レコードに sys_id を割り当てる方法はいくつかあります。

    アプリケーション内で作成された場合、sys_id の値は一意です。Now Platform とデータベースは、sys_id 値に対するすべての操作を管理する必要があります。同じ sys_id 値が 2 回生成されることはありません。これにより、世界中のすべてのインスタンスのすべてのテーブルで作成されたすべてのレコードが一意の識別子を持つようになります。2 つのレコードの sys_id 値が同じである場合は、次の状況の結果として発生します。
    • sys_id を持つレコードが Now Platform の外部のデータベースレベルで他のものにコピーされた場合。

    • sys_id を持つレコードが更新セットを使用して、または XML を介してコピーされた場合、その sys_id は同じです。

    注:
    新しいレコードの sys_id は -1 で、挿入されると新しい sys_id が割り当てられます。sys_id は、フォーム上のフィールドまたはリストの列として表示されるようには設計されていません。詳細については、Now Support ナレッジベースの「sys_id フィールドをフォームまたはリストビューに追加できない (Users are unable to add the sys_id field to a form or list view)」[KB0690876] の記事を参照してください。

    ヘッダーバーから sys_id を取得する

    ユーザーは、ヘッダーバーを使用してレコードの sys_id を見つけることができます。

    手順

    1. レコードに移動します。
    2. ヘッダーバーを右クリックして、[URL のコピー] を選択します。

      sys_id は、URL 内のパラメーター sys_id= の後にあります。たとえば、次の URL はインシデントです。

      https://<instance name>.service-now.com/nav_to.do?uri=incident.do?sys_id=9d385017c611228701d22104cc95c371

      したがって、sys_id は 9d385017c611228701d22104cc95c371 です。

    スクリプトから sys_id を取得する

    ユーザーは、スクリプトを使用してレコードの sys_id を見つけることができます。

    手順

    • レコードの sys_id 値は、GlideRecord からドット連結することで、ビジネスルール (または他のサーバー側 JavaScript) で見つけることができます。 
      var id = current.sys_id;
    • レコードの sys_id は、次の例に示すように、g_form.getUniqueValue() を使用してクライアント側の JavaScript で見つけることができます。 
      function onLoad() {
    var incSysid = g_form.getUniqueValue();
    alert(incSysid);
}

    URL から sys_id を取得する

    ユーザーは、URL を表示することにより、レコードの sys_id を見つけることができます。

    このタスクについて

    レコードの sys_id は常にそのレコードへのリンクの URL の一部であるため、URL を表示して sys_id を取得できます。

    手順

    レコードへのリンクにカーソルを合わせて、ブラウザの情報バーに sys_id を表示します。
    例：URL が https://<インスタンス名>.service-now.com/nav_to.do?uri=incident.do?sys_id=23dc968f0a0a3c1900534f399927740e のインシデントの sys_id は 23dc968f0a0a3c1900534f399927740e です。
    sys_id の例