---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://www.servicenow.com/docs/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideElement - スコープ指定

# GlideElement - スコープ指定 {#ariaid-title1}

スコープ付き GlideElement API には、フィールドとその値を処理する便利なスクリプトメソッドが多数用意されています。スコープ付き GlideElement メソッドは、現在の Glide レコードのフィールドで使用できます。

## スコープ対象 GlideElement - canCreate() {#ariaid-title2}

ユーザーのロールで関連付けられたフィールドでの新しいエントリの作成が可能かどうかを判断します。
{#SGE-canCreate__table_hq2_gmp_fz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 1. パラメーター]

{#SGE-canCreate__table_hq2_gmp_fz} {#SGE-canCreate__table_iq2_gmp_fz__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 現在のユーザーが関連フィールドに新しいエントリを作成する権限を持っているかどうかを示すフラグ。 可能な値： * true：ユーザーは新しいエントリを作成できます。 * false：ユーザーは新しいエントリを作成できません。 {#SGE-canCreate__ul_w1j_ggm_vrb} |
[表 : 2. 返される内容]

{#SGE-canCreate__table_iq2_gmp_fz}  
次の例は、ユーザーが問題 \[problem\] テーブルの最新の 3 つのレコードのエントリを作成する権限を持っているかどうかを判断する方法を示しています。

    var gr = new GlideRecord('problem');

    // Get records in new state in Problem Table
    gr.addQuery('state','101');

    // Sort records in order of recent to earlier Created Date
    gr.orderByDesc('sys_created_on');

    // Limit the query to three records
    gr.setLimit(3); 
    gr.query();

    while(gr.next()){
      if(gr.short_description.canCreate()){ ///check to see if the current user is allowed to create the record
      gs.info("I can create new records for the field Problem statement for - " + gr.number);
      }
    }

出力：

    I can create new records for the field Problem statement for - PRB0000004
    I can create new records for the field Problem statement for - PRB0001000
    I can create new records for the field Problem statement for - PRB0001001

### スコープ対応 {#SGE-canCreate__section_k21_xyr_mcb}

スコープ対象のアプリケーションで canCreate() メソッドを使用するには、対応するスコープ対象のメソッド [canCreate()](https://www.servicenow.com/docs/WyfgRdisCAXy_29MGIpHMw#SGE-canCreate "ユーザーのロールで関連付けられたフィールドでの新しいエントリの作成が可能かどうかを判断します。") を使用します。

## スコープ対象 GlideElement - canRead() {#ariaid-title3}

ユーザーのロールで関連する GlideRecord の読み取りが可能かどうかを示します。
{#SGE-canRead__table_wdj_mnp_fz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 3. パラメーター]

{#SGE-canRead__table_wdj_mnp_fz} {#SGE-canRead__table_xdj_mnp_fz__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | フィールドが読み込み可能な場合は true、可能でない場合は false。 |
[表 : 4. 返される内容]

{#SGE-canRead__table_xdj_mnp_fz}  
次の例は、読み取り可能な \[簡単な説明\] フィールドを持つアクティブなインシデントレコードリストを取得する方法を示しています。

    var grIncident = new GlideRecord('incident');
    grIncident.addEncodedQuery("active=true"); //Query the Incident table for active incidents
    grIncident.orderByDesc('number');
    grIncident.setLimit(3); // limit to three results for example
    grIncident.query();

    while (grIncident.next()) {
        if (grIncident.short_description.canRead()) { //check to see if the current user is allowed to read the record
            gs.info('You have permission to read the short description of: ' + grIncident.number + ' ' + grIncident.short_description);
        }
    }

出力：

    *** Script: You have permission to read the short description of: INC0009009 Unable to access the shared folder.
    *** Script: You have permission to read the short description of: INC0009005 Email server is down.
    *** Script: You have permission to read the short description of: INC0009001 Unable to post content on a Wiki page

## スコープ対象 GlideElement - canWrite() {#ariaid-title4}

ユーザーのロールで関連する GlideRecord の書き込みが可能かどうかを判断します。
{#SGE-canWrite__table_myz_1pp_fz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 5. パラメーター]

{#SGE-canWrite__table_myz_1pp_fz} {#SGE-canWrite__table_nyz_1pp_fz__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | フィールドに書き込み可能な場合は true、可能でない場合は false。 |
[表 : 6. 返される内容]

{#SGE-canWrite__table_nyz_1pp_fz}  
次の例は、書き込み可能な \[簡単な説明\] フィールドを持つアクティブなインシデントレコードリストを取得する方法を示しています。

    var grIncident = new GlideRecord('incident');
    grIncident.addEncodedQuery("active=true"); //Query the Incident table for active incidents
    grIncident.orderByDesc('number');
    grIncident.setLimit(3); // limit to three results for example
    grIncident.query();

    while (grIncident.next()) {
        if (grIncident.short_description.canWrite()) { //check to see if the current user is allowed to write to the record
            gs.info('You have permission to write to the short description of: ' + grIncident.number + ' ' + grIncident.short_description);
        }
    }

出力：

    *** Script: You have permission to write to the short description of: INC0009009 Unable to access the shared folder.
    *** Script: You have permission to write to the short description of: INC0009005 Email server is down.
    *** Script: You have permission to write to the short description of: INC0009001 Unable to post content on a Wiki page

## スコープ対象 GlideElement - changes() {#ariaid-title5}

現在のフィールドが変更されているかどうかを判断します。この機能は、ジャーナルフィールドを除くすべての利用可能なデータタイプで使用できます。
注:  
changes() メソッドは ACL スクリプト内ではサポートされていません。  
注:  
このメソッドを実行している GlideRecord が初期化されて読み込まれているだけで、書き込まれていない場合、基になる前後の値は同じです。この場合、データストアに変更がないため、メソッドは「false」を返します。
{#r_ScopedGlideElementChanges__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 7. パラメーター]

{#r_ScopedGlideElementChanges__table_vy2_525_jq} {#r_ScopedGlideElementChanges__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | フィールドが変更されている場合は true、フィールドが変更されていない場合は false。 |
[表 : 8. 返される内容]

{#r_ScopedGlideElementChanges__table_qpt_3f5_jq}  
ビジネスルールからの次の例は、\[assigned_to\] フィールドの値が変更された場合に EventQueue にイベントを作成する方法を示しています。

    if (!current.assigned_to.nil() && current.assigned_to.changes()) {
      gs.eventQueue('incident.assigned', current, current.assigned_to.getDisplayValue(), previous.assigned_to.getDisplayValue());
    }

## スコープ対象 GlideElement - changesFrom(オブジェクト o) {#ariaid-title6}

現在のフィールドの前の値が指定されたオブジェクトと一致するかどうかを判断します。
注:  
このメソッドを実行している GlideRecord が初期化されて読み込まれているだけで、書き込まれていない場合、基になる前後の値は同じです。この場合、データストアに変更がないため、メソッドは「false」を返します。
{#r_ScopedGlideElementChangesFrom_Object_o__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| o | オブジェクト | 現在のフィールドの前の値と照合するオブジェクト値。 |
[表 : 9. パラメーター]

{#r_ScopedGlideElementChangesFrom_Object_o__table_vy2_525_jq} {#r_ScopedGlideElementChangesFrom_Object_o__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 前の値が一致する場合は true、一致しない場合は false。 |
[表 : 10. 返される内容]

{#r_ScopedGlideElementChangesFrom_Object_o__table_qpt_3f5_jq}  

    // The following example shows that in a business rule, if "active" field is changed from true, 
    // insert a event in the EventQueue.
    if (current.active.changesFrom(true)) {
      gs.eventQueue("incident.inactive", current, current.incident_state, previous.incident_state);
    }

## スコープ対象 GlideElement - changesTo(オブジェクト o) {#ariaid-title7}

変更後のフィールドの新しい値が指定されたオブジェクトと一致するかどうかを判断します。
注:  
changesTo() メソッドは ACL スクリプト内ではサポートされていません。  
注:  
このメソッドを実行している GlideRecord が初期化されて読み込まれているだけで、書き込まれていない場合、基になる前後の値は同じです。この場合、データストアに変更がないため、メソッドは「false」を返します。
{#r_ScopedGlideElementChangesTo_Object_o__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| o | オブジェクト | 現在のフィールドの新しい値と照合するオブジェクト値。 |
[表 : 11. パラメーター]

{#r_ScopedGlideElementChangesTo_Object_o__table_vy2_525_jq} {#r_ScopedGlideElementChangesTo_Object_o__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 前の値が一致する場合は true、一致しない場合は false。 |
[表 : 12. 返される内容]

{#r_ScopedGlideElementChangesTo_Object_o__table_qpt_3f5_jq}  

    // The following example shows that in a business rule, if "active" field is changed to false, 
    // insert a event in the EventQueue.
    if (current.active.changesTo(false)) {
      gs.eventQueue("incident.inactive", current, current.incident_state, previous.incident_state);
    }

## スコープ対象 GlideElement - dateNumericValue() {#ariaid-title8}

期間フィールドに対して 1970 年 1 月 1 日 00:00:00 GMT 以降のミリ秒数を返します。期間フィールドはすでに GlideDateTime オブジェクトであるため、GlideDateTime オブジェクトを作成する必要はありません。
{#SGE-dateNumericValue__table_wzd_zlp_j2b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 13. パラメーター]

{#SGE-dateNumericValue__table_wzd_zlp_j2b} {#SGE-dateNumericValue__table_xzd_zlp_j2b__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | 1970 年 1 月 1 日 00:00:00 GMT 以降のミリ秒数。 |
[表 : 14. 返される内容]

{#SGE-dateNumericValue__table_xzd_zlp_j2b}  

    var inc = new GlideRecord('incident');
    inc.get('17c90efb13418700cc36b1422244b05d');
    gs.info(inc.calendar_duration.dateNumericValue());

出力：

    98000

## スコープ対象 GlideElementget - getAttribute(文字列 attributeName) {#ariaid-title9}

指定された属性の値をディクショナリから返します。
属性がブーリアン属性の場合は、getBooleanAttribute(文字列) を使用して、値を文字列ではなくブーリアンとして取得します。
{#SGE-getAttribute_String__table_dsj_hqp_fz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| attributeName | 文字列 | 属性の名前 |
[表 : 15. パラメーター]

{#SGE-getAttribute_String__table_dsj_hqp_fz} {#SGE-getAttribute_String__table_esj_hqp_fz__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 属性値 |
[表 : 16. 返される内容]

{#SGE-getAttribute_String__table_esj_hqp_fz}  

    doit();
    function doit() {
      var now_GR = new GlideRecord('sys_user');
      now_GR.query("user_name","admin");
      if (now_GR.next()) {
        gs.info("we got one");
        gs.info(now_GR.location.getAttribute("tree_picker"));
      }
    }

## スコープ対象 GlideElementget - getBooleanAttribute(文字列 attributeName) {#ariaid-title10}

指定された属性のブーリアン値をディクショナリから返します。
値を文字列として取得するには、getAttribute(文字列) を使用します。
{#SGE-getBooleanAttribute_String__table_fv5_prp_fz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| attributeName | 文字列 | 属性の名前 |
[表 : 17. パラメーター]

{#SGE-getBooleanAttribute_String__table_fv5_prp_fz} {#SGE-getBooleanAttribute_String__table_gv5_prp_fz__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 属性のブーリアン値。属性が存在しない場合は false を返します。 |
[表 : 18. 返される内容]

{#SGE-getBooleanAttribute_String__table_gv5_prp_fz}  
次の例は、2 つのフィールドの ignore_filter_on_new 属性のブール値を取得する方法を示しています。

    var inc = new GlideRecord('incident');
    inc.query();

    if (inc.next())
     {
       // opened_by field has attribute "ignore_filter_on_new = true"
       gs.info(inc.opened_by.getBooleanAttribute("ignore_filter_on_new"));

      // short_description field does not have attribute ignore_filter_on_new
       gs.info(inc.short_description.getBooleanAttribute("ignore_filter_on_new"));
     }

出力：

    true
    false

## スコープ対象 GlideElement - getChoices(文字列 dependent) {#ariaid-title11}

指定されたフィールドの選択リストを返します。
選択リストを返すフィールドは、メソッド呼び出しで指定されます。例：`var choices = glideRecord.urgency.getChoices();`。選択リストのフィールドタイプとその関連機能の詳細については、「 [選択リストのフィールドタイプ](https://www.servicenow.com/docs/access?context=c_ChoiceLists&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。
{#r_ScopedGlideElementGetChoices_String_dependent__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| dependent | 文字列 | オプション。選択リストフィールドが依存する関連レコード内のフィールド。 |
[表 : 19. パラメーター]

{#r_ScopedGlideElementGetChoices_String_dependent__table_vy2_525_jq} {#r_ScopedGlideElementGetChoices_String_dependent__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| アレイ | 選択リストの可能な値のリスト。これは、選択 \[sys_choice\] テーブルの値です。dependent パラメーターが渡された場合、返される結果には、指定された依存フィールドで利用可能な選択肢のみが反映されます。 |
[表 : 20. 返される内容]

{#r_ScopedGlideElementGetChoices_String_dependent__table_qpt_3f5_jq}  

    var glideRecord = new GlideRecord('incident'); 
    glideRecord.query('priority','1'); 
    glideRecord.next(); 
     
    // urgency has choice list: 1 - High, 2 - Medium, 3 - Low, with value: 1, 2, 3
    var choices = glideRecord.urgency.getChoices();

## スコープ対象 GlideElement - getChoiceValue() {#ariaid-title12}

現在の選択の選択肢ラベルを返します。
選択には値 (数値) とラベル (文字列) があります。このメソッドはラベルを返します。
{#r_ScopedGlideElementGetChoiceValue__table_kgb_3z3_ps__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 21. パラメーター]

{#r_ScopedGlideElementGetChoiceValue__table_kgb_3z3_ps} {#r_ScopedGlideElementGetChoiceValue__table_lgb_3z3_ps__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 選択された選択肢のラベル。 |
[表 : 22. 返される内容]

{#r_ScopedGlideElementGetChoiceValue__table_lgb_3z3_ps}  

    var glideRecord = new GlideRecord('incident'); 
    glideRecord.query('priority','1'); 
    glideRecord.next(); 
     
    // urgency has choice list: 1 - High, 2 - Medium, 3 - Low, with value: 1, 2, 3
    var choiceLabel = glideRecord.urgency.getChoiceValue(); 
    gs.info(choiceLabel);

出力：

    1 - High

## スコープ対象 GlideElement - getDecryptedValue() {#ariaid-title13}

スコープ対象のアプリケーションでパスワード (双方向暗号化) フィールドのクリアテキスト値を返します。
{#SGE-getDecryptedValue__table_xd2_gsp_jz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 23. パラメーター]

{#SGE-getDecryptedValue__table_xd2_gsp_jz} {#SGE-getDecryptedValue__table_yd2_gsp_jz__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | クリアテキストのパスワード。 |
[表 : 24. 返される内容]

{#SGE-getDecryptedValue__table_yd2_gsp_jz}  

    var tablename = 'x_scoped_app_table'
    var CI = new GlideRecord(tablename);  
    CI.addQuery('number', '0001002'); 
    CI.query(); 
    CI.next(); 

    var password = CI.password_field
    var decrypted = password.getDecryptedValue(); 
    gs.info(decrypted);

出力：

    x_scoped_app: cleartextpassword

## スコープ対象 GlideElement - getDisplayValue(数値 maxCharacters) {#ariaid-title14}

関連する GlideRecord オブジェクトから指定されたフィールドの書式設定された表示値を返します。
表示値は、データベース内の実際の値と、ユーザーやシステムの設定と環境設定に基づいて操作されます。  
返される表示値はフィールドタイプに依存します。

* 選択肢フィールド：データベース値は数値にできますが、表示値の方がわかりやすくなります。
* 日付フィールド：データベース値は UTC 形式で、表示値はユーザーのタイムゾーンに基づいたものになります。
* 暗号化テキスト：データベース値は暗号化されますが、表示値はユーザーの暗号化コンテキストに基づいて非暗号化されます。
* 参照フィールド：データベース値は sys_id ですが、表示値は参照レコードの表示フィールドになります。
{#r_ScopedGlideElementGetDisplayValue_Number_maxCharacters__ul_ok1_cbv_hsb}

表示値の詳細については、「 [表示値](https://www.servicenow.com/docs/access?context=c_DisplayValues&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。
{#r_ScopedGlideElementGetDisplayValue_Number_maxCharacters__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| maxCharacters | 数値 | オプション。望ましい最大文字数。 デフォルト：すべて |
[表 : 25. パラメーター]

{#r_ScopedGlideElementGetDisplayValue_Number_maxCharacters__table_vy2_525_jq} {#r_ScopedGlideElementGetDisplayValue_Number_maxCharacters__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 指定したフィールドの表示値。 |
[表 : 26. 返される内容]

{#r_ScopedGlideElementGetDisplayValue_Number_maxCharacters__table_qpt_3f5_jq}  
次の例は、インシデントレコードの優先度フィールドの表示値を取得する方法を示しています。

    var glideRecord = new GlideRecord('incident');
    glideRecord.query('priority','1');
    glideRecord.next();
    gs.info(glideRecord.priority.getDisplayValue());

出力：

    1 - Critical

次の例は、インシデントデータベース内の指定されたフィールドの表示値と内部値の両方を取得する方法を示しています。

    var now_GR = new GlideRecord('incident');
    now_GR.get('9c573169c611228700193229fff72400'); //INC0000001
    gs.info('Display Values:');
    gs.info('Opened at ' + now_GR.opened_at.getDisplayValue());
    gs.info('Opened by ' + now_GR.opened_by.getDisplayValue());
    gs.info('Priority ' + now_GR.priority.getDisplayValue());
    gs.info('Values:');
    gs.info('Opened at ' + now_GR.opened_at.getValue());
    gs.info('Opened by ' + now_GR.opened_by.getValue());
    gs.info('Priority ' + now_GR.priority.getValue());

出力:

    Display Values:
    Opened at 2022-02-01 15:09:51
    Opened by Joe Employee
    Priority 1 - Critical
    Values:
    Opened at 2022-02-01 23:09:51
    Opened by 681ccaf9c0a8016400b98a06818d57c7
    Priority 1

## スコープ付き GlideElement - getDisplayValueLang(文字列言語) {#ariaid-title15}

パラメーターとして渡された言語でのフィールドの表示値を取得します。
結果は、 選択肢、 翻訳済みフィールド、 翻訳済みテキストなどの翻訳可能なフィールドタイプにのみ適用されます。その他のフィールドタイプの場合、結果のデフォルトは [getDisplayValue()](https://www.servicenow.com/docs/WyfgRdisCAXy_29MGIpHMw#r_ScopedGlideElementGetDisplayValue_Number_maxCharacters "関連する GlideRecord オブジェクトから指定されたフィールドの書式設定された表示値を返します。") になります。

翻訳された値を取得するには、対応する言語プラグインが必要です。詳細については、「[Activate a language](https://www.servicenow.com/docs/access?context=t_ActivateALanguage&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。{#SGE-getDisplayValueLang_S__p_SGE-getDspOrLabellLang-plugins}

「[スコープ付き GlideElement - getLabelLang(文字列言語)](https://www.servicenow.com/docs/WyfgRdisCAXy_29MGIpHMw#SGE-getLabelLang_S "パラメーターとして渡された言語でフィールドのラベル値を取得します。")」も参照してください。
{#SGE-getDisplayValueLang_S__table_GE-language-parm__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 言語 | 文字列 | IETF BCP-47 に準拠した言語タグ。 |
[表 : 27. パラメーター]

{#SGE-getDisplayValueLang_S__table_GE-language-parm} {#SGE-getDisplayValueLang_S__table_qpt_3f5_jq__entry__2}{#SGE-getDisplayValueLang_S__ph_getDisOrLblLang_returns_if}

| タイプ | 説明 |
|-|-|
| 文字列 | 渡された言語でフィールドの値を表示します。翻訳が利用できない場合、メソッドは現在のユーザーの言語に翻訳された値を取得します。翻訳が利用できない場合、結果はデフォルトで英語になります。 |
[表 : 28. 返される内容]

{#SGE-getDisplayValueLang_S__table_qpt_3f5_jq}  
次の例は、 承認 (UI ビュー) タイトルフィールドから元のテキストとドイツ語に翻訳されたテキストを取得する方法を示しています。

    var uiView = new GlideRecord("sys_ui_view");
    uiView.get("fa776f6d97700100f309124eda2975bc");

    gs.info("getDisplayValue: " + uiView.getElement("title").getDisplayValue());
    gs.info("getDisplayValueLang: " + uiView.getElement("title").getDisplayValueLang("de"));

出力:

    getDisplayValue: Accept
    getDisplayValueLang: Akzeptieren

## スコープ対象 GlideElement - getED() {#ariaid-title16}

フィールドの要素記述子を返します。
{#r_ScopedGlideElementGetED__table_k23_ps3_yr__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 29. パラメーター]

{#r_ScopedGlideElementGetED__table_k23_ps3_yr} {#r_ScopedGlideElementGetED__table_l23_ps3_yr__entry__2}

| タイプ | 説明 |
|-|-|
| GlideElementDescriptor | フィールドの要素記述子。 |
[表 : 30. 返される内容]

{#r_ScopedGlideElementGetED__table_l23_ps3_yr}  

    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
     
    var field = grInc.getElement('priority');
    var ed = field.getED();

## スコープ対象 GlideElement - getGlobalDisplayValue() {#ariaid-title17}

国際形式の電話番号を返します。
{#r_SGE-getGlobalDisplayValue__table_nfm_lq2_bx__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 31. パラメーター]

{#r_SGE-getGlobalDisplayValue__table_nfm_lq2_bx} {#r_SGE-getGlobalDisplayValue__table_ofm_lq2_bx__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 国際形式の電話番号。 |
[表 : 32. 返される内容]

{#r_SGE-getGlobalDisplayValue__table_ofm_lq2_bx}  
次の例は、Walk-up 場所の電話番号を取得する方法を示しています。この例には ウォークアップエクスペリエンス プラグインが必要です。

    // Passing walkup location name and closed phone number in parameters
    setWalkupLocPhone('Santa Clara Tech Lounge','phone_number');

    function setWalkupLocPhone(locName, field) {
      var walkupLoc = new GlideRecord('wu_location_queue');
      walkupLoc.addQuery('name',locName);
      walkupLoc.query();
      walkupLoc.next();

      // Returns the phone number of walk-up location queue in international format
      gs.info(walkupLoc[field].getGlobalDisplayValue());
    }

出力：

    +91 98124 56789

## スコープ対象 GlideElement - getHTMLValue(数値 maxChars) {#ariaid-title18}

フィールドの HTML 値を返します。
{#SGE-getHTMLValue_Number__table_p1h_2tp_fz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| maxChars | 数値 | オプション。返される最大文字数。 |
[表 : 33. パラメーター]

{#SGE-getHTMLValue_Number__table_p1h_2tp_fz} {#SGE-getHTMLValue_Number__table_q1h_2tp_fz__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | フィールドの HTML 値。 |
[表 : 34. 返される内容]

{#SGE-getHTMLValue_Number__table_q1h_2tp_fz}  

    var inccause = new GlideRecord("incident");
    inccause.short_description = current.short_description;
    inccause.comments = current.comments.getHTMLValue();
    inccause.insert();

## スコープ対象 GlideElement - getJournalEntry(数値 mostRecent) {#ariaid-title19}

最新のジャーナルエントリまたはすべてのジャーナルエントリを返します。
{#SGE-getJournalEntry_N__table_lpt_2wp_fz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| mostRecent | 数値 | 1 の場合、最新のエントリを返します。-1 の場合、すべてのジャーナルエントリを返します。 |
[表 : 35. パラメーター]

{#SGE-getJournalEntry_N__table_lpt_2wp_fz} {#SGE-getJournalEntry_N__table_mpt_2wp_fz__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 最新のエントリの場合、ジャーナルエントリのフィールドラベル、タイムスタンプ、およびユーザー表示名を含む文字列を返します。 すべてのジャーナルエントリについて、これまでに入力されたすべてのジャーナルエントリに対する同じ情報を、各エントリが「\\n\\n」で区切られた単一の文字列として返します。 |
[表 : 36. 返される内容]

{#SGE-getJournalEntry_N__table_mpt_2wp_fz}  

    //gets all journal entries as a string where each entry is delimited by '\n\n'
    var notes = current.work_notes.getJournalEntry(-1); 
    //stores each entry into an array of strings
    var na = notes.split("\n\n");  
                          
    for (var i = 0; i < na.length; i++)                 
      gs.info(na[i]);

## スコープ対象 GlideElement - getLabel() {#ariaid-title20}

オブジェクトのラベルを返します。
{#SGE-getLabel__table_tlw_sxp_fz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 37. パラメーター]

{#SGE-getLabel__table_tlw_sxp_fz} {#SGE-getLabel__table_ulw_sxp_fz__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | オブジェクトのラベル |
[表 : 38. 返される内容]

{#SGE-getLabel__table_ulw_sxp_fz}  

    var now_GR = new GlideRecord("sc_req_item");
    now_GR.addQuery("request", current.sysapproval);
    now_GR.query();
    while(now_GR.next()) {
    var nicePrice = now_GR.price.toString();
        if (nicePrice != ) {
            nicePrice = parseFloat(nicePrice);
            nicePrice = nicePrice.toFixed(2);
        }
        template.print(now_GR.number + ":  " + now_GR.quantity + " X " + now_GR.cat_item.getDisplayValue() + " at $" + nicePrice + " each \n");
        template.print("    Options:\n");
        var variables = now_GR.variables.getElements();    
        for (var key in variables) {
          var now_V = variables[key];
          if(now_V.getQuestion().getLabel() != ) {
             template.space(4);
             template.print('     ' +  now_V.getQuestion().getLabel() + " = " + now_V.getDisplayValue() + "\n");  
          }
        }
    }

## スコープ付き GlideElement - getLabelLang(文字列言語) {#ariaid-title21}

パラメーターとして渡された言語でフィールドのラベル値を取得します。
翻訳された値を取得するには、対応する言語プラグインが必要です。詳細については、「[Activate a language](https://www.servicenow.com/docs/access?context=t_ActivateALanguage&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。  
関連項目：

* [getDisplayValueLang()](https://www.servicenow.com/docs/WyfgRdisCAXy_29MGIpHMw#SGE-getDisplayValueLang_S "パラメーターとして渡された言語でのフィールドの表示値を取得します。")
* [getLabel()](https://www.servicenow.com/docs/WyfgRdisCAXy_29MGIpHMw#SGE-getLabel "オブジェクトのラベルを返します。")
{#SGE-getLabelLang_S__ul_fw4_b1b_txb}
{#SGE-getLabelLang_S__id_nbn_4c5_sxb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 言語 | 文字列 | IETF BCP-47 に準拠した言語タグ。 |
[表 : 39. パラメーター]

{#SGE-getLabelLang_S__id_nbn_4c5_sxb} {#SGE-getLabelLang_S__table_ulw_sxp_fz__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 渡された言語のフィールドラベルの値。 翻訳が利用できない場合、メソッドは現在のユーザーの言語に翻訳された値を取得します。翻訳が利用できない場合、結果はデフォルトで英語になります。 |
[表 : 40. 返される内容]

{#SGE-getLabelLang_S__table_ulw_sxp_fz}  
次の例は、元のラベル テキストと 、Accept (UI ビュー) タイトルのドイツ語訳を取得する方法を示しています。

    var uiView = new GlideRecord("sys_ui_view");
    uiView.get("fa776f6d97700100f309124eda2975bc");

    gs.info("getLabel: " + uiView.getElement("title").getLabel());
    gs.info("getLabelLang: " + uiView.getElement("title").getLabelLang("de"));

出力:

    getLabel: Title
    getLabelLang: Titel

## スコープ対象 GlideElement - getName() {#ariaid-title22}

フィールドの名前を返します。
{#SGE-getName__table_vdn_vyp_fz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 41. パラメーター]

{#SGE-getName__table_vdn_vyp_fz} {#SGE-getName__table_wdn_vyp_fz__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | フィールド名。 |
[表 : 42. 返される内容]

{#SGE-getName__table_wdn_vyp_fz}  
次の例は、sys_user レコードの各フィールドの名前とその他の値を取得する方法を示しています。

    var userRec = new GlideRecord("sys_user"); // GlideRecord to sys_user table

    userRec.get("5137153cc611227c000bbd1bd8cd2005"); // Sys Id of user: Fred Luddy

    var fields = userRec.getFields();

    for (var i = 0; i < fields.size(); i++) {

        var field = fields.get(i);
        var name = field.getName(); // Name of the field
        var label = field.getLabel(); // Label of the field
        var value = field.getDisplayValue(); // Value of the field

        gs.info((Number(i) + 1) + ".\n" + "Field Label: " + label + "\n" + "Field Name: " + name + "\n" + "Field Value: " + value);

    };

出力。結果には 62 個のフィールドが含まれており、スペースを節約するために省略記号 (...) が付けられています。

    *** Script: 1.
    Field Label: Country code
    Field Name: country
    Field Value: 
    *** Script: 2.
    Field Label: Calendar integration
    Field Name: calendar_integration
    Field Value: Outlook
    ...
    *** Script: 47.
    Field Label: First name
    Field Name: first_name
    Field Value: Fred
    ...
    *** Script: 54.
    Field Label: Last name
    Field Name: last_name
    Field Value: Luddy
    ...

## スコープ対象 GlideElement - getReferenceTable() {#ariaid-title23}

参照要素のテーブル名を取得します。
{#r_ScopedGlideElementGetReferenceTable__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 43. パラメーター]

{#r_ScopedGlideElementGetReferenceTable__table_vy2_525_jq} {#r_ScopedGlideElementGetReferenceTable__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 参照のテーブル名。 |
[表 : 44. 返される内容]

{#r_ScopedGlideElementGetReferenceTable__table_qpt_3f5_jq}  

    var grINC = new GlideRecord('incident');
    grINC.query('number','INC0010041'); // record assignment group assigned to "CAB Approval"
    if (grINC.next()) { 
      // Get the table name 
      var tableName = grINC.assignment_group.getReferenceTable();
      gs.info( tableName ); 
    }

## スコープ対象 GlideElement - getRefRecord() {#ariaid-title24}

指定された参照要素の GlideRecord オブジェクトを返します。
警告:  
参照要素に値が含まれていない場合は、NULL オブジェクトではなく、空の GlideRecord オブジェクトを返します。
{#r_ScopedGlideElementGetRefRecord__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 45. パラメーター]

{#r_ScopedGlideElementGetRefRecord__table_vy2_525_jq} {#r_ScopedGlideElementGetRefRecord__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| GlideRecord | GlideRecord オブジェクト |
[表 : 46. 返される内容]

{#r_ScopedGlideElementGetRefRecord__table_qpt_3f5_jq}  


    var grINC = new GlideRecord('incident'); 
    grINC.addNotNullQuery('caller_id'); 
    grINC.query(); 
    if (grINC.next()) { 

    // Get a GlideRecord object for the referenced sys_user record 
    var grUSER = grINC.caller_id.getRefRecord(); 
    if (grUSER.isValidRecord()) 
      gs.info(grUSER.getValue('name')); 

    } 

## スコープ対象 GlideElement - getTableName() {#ariaid-title25}

フィールドが存在するテーブルの名前を返します。
{#SGE-getTableName__table_gfq_szp_fz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 47. パラメーター]

{#SGE-getTableName__table_gfq_szp_fz} {#SGE-getTableName__table_hfq_szp_fz__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | テーブルの名前。返される値は、レコードが存在するテーブルクラスとは異なる場合があります。製品ドキュメントのテーブルとクラスを参照してください。 |
[表 : 48. 返される内容]

{#SGE-getTableName__table_hfq_szp_fz}  

    if (current.approver.getTableName() == "sysapproval_approver") {
      if (current.approver == email.from_sys_id)  {
         current.comments = "reply from: " + email.from + "\n\n" + email.body_text;
     
       // if it's been cancelled, it's cancelled.
      var doit = true;
      if (current.state=='cancelled')
          doit = false;
     
      if (email.body.state != undefined)
         current.state= email.body.state;
     
       if (doit)
          current.update();
    } else {
       gs.log("Approval for task ("+current.sysapproval.getDisplayValue()+") rejected because user sending 
               email( "+email.from+") does not match the approver ("+current.approver.getDisplayValue()+")");
    }
     
    }

## スコープ対象 GlideElement - nil() {#ariaid-title26}

フィールドが null かどうかを判断します。
{#r_ScopedGlideElementNil__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 49. パラメーター]

{#r_ScopedGlideElementNil__table_vy2_525_jq} {#r_ScopedGlideElementNil__table_bdf_zfr_2r__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | フィールドが null かどうかを示すフラグ。 可能な値： * true：フィールドは null です。 * false：フィールドは null ではありません。 {#r_ScopedGlideElementNil__ul_lhk_bzp_krb} |
[表 : 50. 返される内容]

{#r_ScopedGlideElementNil__table_bdf_zfr_2r}  

    var glideRecord = new GlideRecord('incident'); 
    glideRecord.query('priority','1'); 
    glideRecord.next(); 
    gs.info(glideRecord.state.nil());

出力：

    false

## スコープ対象 GlideElement - setDateNumericValue(数値 milliseconds) {#ariaid-title27}

日時要素の値を 1970 年 1 月 1 日 00:00:00 GMT 以降のミリ秒数に設定します。
setDateNumericValue() が呼び出されると、必要な GlideDateTime/GlideDate/GlideDuration オブジェクトが自動的に作成され、要素が指定された値に設定されます。  
注:  
このメソッドを呼び出す前に、既存のレコードをクエリするか、now_GR.initialize() メソッドを使用して新しいレコードを初期化することによって、要素が存在している必要があります。
{#SGE-setDateNumericValue_N__table_hqp_hfd_1z__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| milliseconds | 数値 | 1970 年 1 月 1 日以降のミリ秒数 |
[表 : 51. パラメーター]

{#SGE-setDateNumericValue_N__table_hqp_hfd_1z} {#SGE-setDateNumericValue_N__table_iqp_hfd_1z__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 52. 返される内容]

{#SGE-setDateNumericValue_N__table_iqp_hfd_1z}  

    var now_GR = new GlideRecord("incident");
    now_GR.initialize();
    now_GR.opened_at.setDateNumericValue(10000);

## スコープ対象 GlideElement - setDisplayValue(オブジェクト value) {#ariaid-title28}

フィールドの表示値を設定します。
{#r_ScopedGlideElementSetDisplayValue_Object_value__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| value | オブジェクト | フィールドに設定する値。 |
[表 : 53. パラメーター]

{#r_ScopedGlideElementSetDisplayValue_Object_value__table_vy2_525_jq} {#r_ScopedGlideElementSetDisplayValue_Object_value__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 54. 返される内容]

{#r_ScopedGlideElementSetDisplayValue_Object_value__table_qpt_3f5_jq}  

    var glideRecord = new GlideRecord('incident'); 
    glideRecord.query('priority','1'); 
    glideRecord.next();
     
    //change the urgency to 3 
    glideRecord.urgency.setDisplayValue('3 - Low');
    gs.info(glideRecord.urgency);

## スコープ対象 GlideElement - setError(文字列 errorMessage) {#ariaid-title29}

エラーメッセージを追加します。Fuji パッチ 3 で利用可能です。
{#r_ScopedGlideElementSetError_String__table_ix3_q5t_vr__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| errorMessage | 文字列 | エラーメッセージ。 |
[表 : 55. パラメーター]

{#r_ScopedGlideElementSetError_String__table_ix3_q5t_vr} {#r_ScopedGlideElementSetError_String__table_jx3_q5t_vr__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 56. 返される内容]

{#r_ScopedGlideElementSetError_String__table_jx3_q5t_vr}  

    var glideRecord = new GlideRecord('incident');
    glideRecord.query('priority','1');
    glideRecord.next();
     
    glideRecord.short_description.setError('Error text');

## スコープ対象 GlideElement - setPhoneNumber(オブジェクト phoneNumber, ブーリアン strict) {#ariaid-title30}

フィールドを指定された電話番号に設定します。
このメソッドは、電話番号の GlideElement でのみ使用できます。
{#r_SGE-setPhoneNumber_O_B__table_exy_3m2_bx__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| phoneNumber | オブジェクト | 設定する電話番号。国際形式またはローカル形式のいずれかになります。 |
| strict | ブーリアン | true の場合、指定された番号は正しい形式に一致する必要があります。false の場合、システムは不適切に書式設定された電話番号を修正しようとします。 |
[表 : 57. パラメーター]

{#r_SGE-setPhoneNumber_O_B__table_exy_3m2_bx} {#r_SGE-setPhoneNumber_O_B__table_fxy_3m2_bx__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 電話番号の値が設定されたかどうかを示すフラグ。 可能な値： * true：値は設定されました。 * false：値は設定されていません。 {#r_SGE-setPhoneNumber_O_B__ul_zts_mzp_krb} |
[表 : 58. 返される内容]

{#r_SGE-setPhoneNumber_O_B__table_fxy_3m2_bx}  
次の例は、Walk-up 場所の電話番号を設定する方法を示しています。この例には ウォークアップエクスペリエンス プラグインが必要です。

    setWalkupLocPhone('Santa Clara Tech Lounge','+91 9812456789'); 

    function setWalkupLocPhone(locName, phoneNumber) {
      var walkupLoc = new GlideRecord('wu_location_queue');
      walkupLoc.addQuery('name', locName);
      walkupLoc.query();
      walkupLoc.next();
      
      // Set phone number of walk-up location
      var isPhoneNumberSet = walkupLoc.phone_number.setPhoneNumber(phoneNumber, true);
      walkupLoc.update();
      gs.info('Phone Number: ' + walkupLoc.phone_number);
      gs.info('Is phone number specified match the correct format: ' + isPhoneNumberSet);
    }

出力：

    Phone Number: +919812456789
    Is phone number specified match the correct format: true

## スコープ対象 GlideElement - setValue(オブジェクト value) {#ariaid-title31}

フィールドの値を設定します。
注:  
このメソッドを呼び出す前に、既存のレコードをクエリするか、now_GR.initialize() メソッドを使用して新しいレコードを初期化することによって、要素が存在している必要があります。
{#r_ScopedGlideElementSetValue_Object_value__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| value | オブジェクト | フィールドを設定するオブジェクト値。 |
[表 : 59. パラメーター]

{#r_ScopedGlideElementSetValue_Object_value__table_vy2_525_jq} {#r_ScopedGlideElementSetValue_Object_value__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 60. 返される内容]

{#r_ScopedGlideElementSetValue_Object_value__table_qpt_3f5_jq}  
文字列を渡す値を設定します。

    var glideRecord = new GlideRecord('incident');
    glideRecord.query('priority','1');
    glideRecord.next();
    glideRecord.short_description.setValue('Network failure');

オブジェクトを渡す値を設定します。

    var now_GR  = new GlideRecord('student');
    now_GR.initialize();
    now_GR.setValue('first_name', 'Joe');
    now_GR.setValue('last_name', 'Smith');
    now_GR.insert();

## スコープ対象 GlideElement - toString() {#ariaid-title32}

GlideRecord フィールドの値を文字列に変換します。
{#r_ScopedGlideElementToString__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 61. パラメーター]

{#r_ScopedGlideElementToString__table_vy2_525_jq} {#r_ScopedGlideElementToString__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 文字列としての値。 |
[表 : 62. 返される内容]

{#r_ScopedGlideElementToString__table_qpt_3f5_jq}  

    var glideRecord = new GlideRecord('incident');
    glideRecord.query('priority','1');
    glideRecord.next();
    gs.info(glideRecord.opened_at.toString());

出力：

    2019-08-31 23:09:51