---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideTimelineItem - 전역

# GlideTimelineItem - 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 16분

GlideTimelineItem API는 추상 ScheduleItem 클래스를 확장하여 타임라인과 관련된 추가 속성을 정의합니다.

타임라인 항목은 기본적으로 타임라인에 걸쳐 단일 행으로 표시되는 모든 항목입니다. GlideTimelineItem에는 0개 이상의 연결된 범위(TimelineSpan 개체)가 있습니다.

## GlideTimelineItem - GlideTimelineItem(문자열 tableName) {#ariaid-title2}

"더미" GlideTimelineItem 객체를 만듭니다.
이는 YMoving을 허용하지 않는 행을 만드는 데 유용합니다. 그러나 중첩된 하위 항목(예: 그룹 자원 타임라인의 최상위 "사용자" 행)을 포함합니다. sys_id DOM 수준 기능이 올바르게 구문 분석하려면 고유해야 합니다. 기본적으로 이 객체는 테이블 이름이 지정되지 않았기 때문에 "삭제할 수 없는" 것입니다.
{#r_TLI-TimelineItem_S__table_dpl_1jm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 현재 객체와 연결된 테이블의 이름입니다. |
[표 1. 매개변수]

{#r_TLI-TimelineItem_S__table_dpl_1jm_zt} {#r_TLI-TimelineItem_S__table_epl_1jm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 2. 반환]

{#r_TLI-TimelineItem_S__table_epl_1jm_zt}

## GlideTimelineItem - GlideTimelineItem(문자열 tableName, 문자열 sys_id) {#ariaid-title3}

필요한 테이블과 sys_id 속성을 설정하는 생성자입니다.
이 개체의 나머지 속성은 호출자가 설정해야 합니다. 기본적으로 이 객체 인스턴스는 테이블 이름이 지정되어 있으므로 "삭제 가능"입니다.
{#r_TLI-TimelineItem_S_S__table_fpl_1jm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 현재 객체와 연결된 테이블의 이름입니다. |
| sys_id | 문자열 | 객체의 시스템 ID입니다. |
[표 3. 매개변수]

{#r_TLI-TimelineItem_S_S__table_fpl_1jm_zt} {#r_TLI-TimelineItem_S_S__table_gpl_1jm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 4. 반환]

{#r_TLI-TimelineItem_S_S__table_gpl_1jm_zt}

## GlideTimelineItem - createTimelineSpan(문자열 tableName) {#ariaid-title4}

현재 인스턴스 객체와 연결된 새 TimelineSpan 객체를 만듭니다.
다른 TimelineSpan 개체가 없는 경우 새로 만든 개체는 현재 인스턴스 개체와 동일한 sys_id 내용을 공유합니다. 그렇지 않으면 임의로 생성된 GUID가 사용됩니다.
{#r_TLI-createTimelineSpan_S__table_hpl_1jm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 현재 객체와 연결된 테이블의 이름입니다. |
[표 5. 매개변수]

{#r_TLI-createTimelineSpan_S__table_hpl_1jm_zt} {#r_TLI-createTimelineSpan_S__table_ipl_1jm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 새로 만든 범위 객체 인스턴스입니다. |
[표 6. 반환]

{#r_TLI-createTimelineSpan_S__table_ipl_1jm_zt}

## GlideTimelineItem - createTimelineSpan(문자열 tableName, 문자열 sys_id) {#ariaid-title5}

지정된 테이블과 sys_id 사용하여 현재 인스턴스 개체와 연결된 새 TimelineSpan 개체를 만듭니다.
{#r_TLI-createTimelineSpan_S_S__table_jpl_1jm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 현재 객체와 관련된 테이블의 이름 |
| sys_id | 문자열 | 객체에 대한 Sys_id입니다. |
[표 7. 매개변수]

{#r_TLI-createTimelineSpan_S_S__table_jpl_1jm_zt} {#r_TLI-createTimelineSpan_S_S__table_kpl_1jm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 새로 만든 범위 객체 인스턴스입니다. |
[표 8. 반환]

{#r_TLI-createTimelineSpan_S_S__table_kpl_1jm_zt}  
다음 예제에서는 createTimelineSpan() 을 사용하여 새 TimelineSpan 개체를 만드는 방법을 보여줍니다.

    var project_id="741cc7491b6f1c5043de32231b4bcbc5"; // Project ID 
    var grUser = new GlideRecord('user_resource');
    grUser.addQuery('planned_task', project_id);
    grUser.setQueryReferences(true);
    grUser.orderBy('user.name', 'DESC');
    grUser.query();
    while (grUser.next()) {
      var item = new GlideTimelineItem(grUser.getTableName(), grUser.user);
      /* Specify the text to display in the left pane for this item. */
      item.setLeftLabelText(grUser.user.name); 
      /* Set the name of the image file (including it's path) */
      item.setImage('../images/icons/user.gifx'); 
      /* Specify whether or not to bold the text style of the item in the left pane. */
      item.setTextBold(true); 
      /* Set whether or not the current instance object can be clicked and dragged into another GlideTimelineItem */
      item.setIsDraggable(true);
      /* Create a new TimelineSpan object associated with the current instance object using the specified table and sys_id. */ 
      item.createTimelineSpan(grUser.getTableName(), grUser.getUniqueValue());
    }

## GlideTimelineItem - getImage( ) {#ariaid-title6}

현재 GlideTimelineItem과 연결된 이미지 파일의 이름을 지정하는 문자열을 반환합니다.
{#r_TLI-getImage__table_lpl_1jm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 9. 매개변수]

{#r_TLI-getImage__table_lpl_1jm_zt} {#r_TLI-getImage__table_mpl_1jm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 GlideTimelineItem과 연결된 이미지 파일의 이름입니다. 현재 항목과 연결된 이미지가 없으면 빈 문자열("")이 반환됩니다. |
[표 10. 반환]

{#r_TLI-getImage__table_mpl_1jm_zt}

## GlideTimelineItem - getIsDroppable( ) {#ariaid-title7}

타임라인 요소를 세로로 이동할 때 현재 인스턴스 객체를 "드롭 영역"으로 허용해야 하는지 여부를 나타냅니다.
{#r_TLI-getIsDroppable__table_npl_1jm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 11. 매개변수]

{#r_TLI-getIsDroppable__table_npl_1jm_zt} {#r_TLI-getIsDroppable__table_opl_1jm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 드롭 가능한 경우 예입니다. 그렇지 않으면 false입니다. |
[표 12. 반환]

{#r_TLI-getIsDroppable__table_opl_1jm_zt}

## GlideTimelineItem - getLeftLabelText( ) {#ariaid-title8}

왼쪽 창에 표시할 텍스트를 반환합니다(활성화된 경우).
{#r_TLI-getLeftLabelText__table_fmb_2tm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 13. 매개변수]

{#r_TLI-getLeftLabelText__table_fmb_2tm_zt} {#r_TLI-getLeftLabelText__table_gmb_2tm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 왼쪽 창에 표시할 텍스트의 값입니다. |
[표 14. 반환]

{#r_TLI-getLeftLabelText__table_gmb_2tm_zt}

## GlideTimelineItem - getParent( ) {#ariaid-title9}

현재 GlideTimelineItem의 상위 객체의 고유 sysId 를 반환합니다.
{#r_TLI-getParent__table_hmb_2tm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 15. 매개변수]

{#r_TLI-getParent__table_hmb_2tm_zt} {#r_TLI-getParent__table_imb_2tm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 GlideTimelineItem의 상위 객체의 고유 sysId입니다. 상위 항목이 없으면 빈 문자열("")이 반환됩니다. |
[표 16. 반환]

{#r_TLI-getParent__table_imb_2tm_zt}

## GlideTimelineItem - getTimelineSpans( ) {#ariaid-title10}

ArrayList의 현재 인스턴스와 연결된 모든 TimelineSpan 객체를 반환합니다.
{#r_TLI-getTimelineSpans__table_jmb_2tm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 17. 매개변수]

{#r_TLI-getTimelineSpans__table_jmb_2tm_zt} {#r_TLI-getTimelineSpans__table_kmb_2tm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 배열 | 현재 인스턴스와 연결된 TimelineSpan 객체의 목록입니다. |
[표 18. 반환]

{#r_TLI-getTimelineSpans__table_kmb_2tm_zt}

## GlideTimelineItem - isTextBold( ) {#ariaid-title11}

왼쪽 창 텍스트가 굵게 스타일을 사용하여 표시되도록 설정되었는지 여부를 나타냅니다.
{#r_TLI-isTextBold__table_lmb_2tm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 19. 매개변수]

{#r_TLI-isTextBold__table_lmb_2tm_zt} {#r_TLI-isTextBold__table_mmb_2tm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 텍스트를 굵게 표시해야 하는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 텍스트는 굵게 해야 합니다. * false: 텍스트는 굵게 사용할 수 없습니다. {#r_TLI-isTextBold__ul_nrf_mzd_2sb} |
[표 20. 반환]

{#r_TLI-isTextBold__table_mmb_2tm_zt}  
다음 예에서는 인시던트의 상태가 "신규"인지 확인하고 항목 텍스트를 굵게 설정합니다.

    var NewIncidentTimelineScriptInclude = Class.create();
    NewIncidentTimelineScriptInclude.prototype = Object.extendsObject(AbstractTimelineSchedulePage, {

      getItems: function() {
        // Specify the page title 
        this.setPageTitle('New Incident Timeline');

        var groupNew = new GlideTimelineItem('new');
        groupNew.setLeftLabelText('New Incidents');

        groupNew.setImage('../images/icons/all.gifx');
        this.add(groupNew);

        // Get all the new incidents and add them to a new label 
        var grIncident = new GlideRecord('incident');
        grIncident.query();
        while (grIncident.next()) {
          // Loop through all and capture new incidents 
          if (grIncident.incident_state != '1') continue;

          // Create the item and the span item. 
          var item = new GlideTimelineItem(grIncident.getTableName(), grIncident.sys_id);
          var span = item.createTimelineSpan(grIncident.getTableName(), grIncident.sys_id);

          if (grIncident.incident_state == '1') { // New
            item.setParent(groupNew.getSysId());
            // Check and set bold text
              item.setTextBold(item.isTextBold() ? false : true);
            } 
          item.setImage('../images/icons/open.gifx');
          span.setTimeSpan(grIncident.getElement('opened_at').getGlideObject().getNumericValue(),
          grIncident.getElement('opened_at').getGlideObject().getNumericValue());

          // Show different colors based upon the priorities only for new incidents 
          switch (grIncident.getElement('priority').toString()) {
            case '1':
              span.setPointIconClass('red_circle');
              break;
            case '2':
              span.setPointIconClass('red_square');
              break;
            case '3':
              span.setPointIconClass('blue_circle');
              break;
            case '4':
              span.setPointIconClass('blue_square');
              break;
            case '5':
              span.setPointIconClass('sepia_circle');
              break;

              default: // Otherwise, the default point icon class will be used (Milestone)
          }

          // Common item properties 
          item.setLeftLabelText(grIncident.short_description);

          // Common span properties
          span.setSpanText(grIncident.short_description);
          span.setSpanColor('blue');
          span.setTooltip('<strong>' + GlideStringUtil.escapeHTML(grIncident.short_description) +
            '</strong><br>' + grIncident.number);
          this.add(item);
        }
      }

    });

## GlideTimelineItem - setImage(String strImageName) {#ariaid-title12}

왼쪽 창에 있는 항목의 아이콘으로 사용할 이미지 파일의 이름(경로 포함)을 설정합니다.
{#r_TLI-setImage_S__table_nmb_2tm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| strImageName | 문자열 | 경로를 포함한 이미지의 이름입니다. |
[표 21. 매개변수]

{#r_TLI-setImage_S__table_nmb_2tm_zt} {#r_TLI-setImage_S__table_omb_2tm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 22. 반환]

{#r_TLI-setImage_S__table_omb_2tm_zt}  
다음 예시에서는 setImage() 를 사용하여 왼쪽 창의 아이콘에 표시할 이미지를 정의하는 방법을 보여줍니다.

    var project_id="741cc7491b6f1c5043de32231b4bcbc5"; // Project ID 
    var grUser = new GlideRecord('user_resource');
    grUser.addQuery('planned_task', project_id);
    grUser.setQueryReferences(true);
    grUser.orderBy('user.name', 'DESC');
    grUser.query();
    while (grUser.next()) {
      var item = new GlideTimelineItem(grUser.getTableName(), grUser.user);
      /* Specify the text to display in the left pane for this item. */
      item.setLeftLabelText(grUser.user.name); 
      /* Set the name of the image file (including it's path) */
      item.setImage('../images/icons/user.gifx'); 
      /* Specify whether or not to bold the text style of the item in the left pane. */
      item.setTextBold(true); 
      /* Set whether or not the current instance object can be clicked and dragged into another GlideTimelineItem */
      item.setIsDraggable(true); 
    }

## GlideTimelineItem - setIsDraggable(부울 b) {#ariaid-title13}

현재 인스턴스 객체를 클릭하여 다른 GlideTimelineItem으로 드래그할 수 있는지 여부를 설정합니다.
{#r_TLI-setIsDraggable_B__table_pmb_2tm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| b | 부울 | 클릭 및 끌기를 사용하여 항목을 이동할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 클릭 및 끌기를 사용하여 항목을 이동할 수 있습니다. * 아니오: 클릭 및 끌기를 사용하여 항목을 이동할 수 없습니다. {#r_TLI-setIsDraggable_B__ul_h4z_jt1_fsb} |
[표 23. 매개변수]

{#r_TLI-setIsDraggable_B__table_pmb_2tm_zt} {#r_TLI-setIsDraggable_B__table_qmb_2tm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 24. 반환]

{#r_TLI-setIsDraggable_B__table_qmb_2tm_zt}  
다음 예제는 setIsDraggable() 을 사용하여 현재 객체를 다른 GlideTimelineItem으로 드래그할 수 있도록 하는 방법을 보여줍니다.

    var project_id="741cc7491b6f1c5043de32231b4bcbc5"; // Project ID 
    var grUser = new GlideRecord('user_resource');
    grUser.addQuery('planned_task', project_id);
    grUser.setQueryReferences(true);
    grUser.orderBy('user.name', 'DESC');
    grUser.query();
    while (grUser.next()) {
      var item = new GlideTimelineItem(grUser.getTableName(), grUser.user);
      /* Specify the text to display in the left pane for this item. */
      item.setLeftLabelText(grUser.user.name); 
      /* Set the name of the image file (including it's path) */
      item.setImage('../images/icons/user.gifx'); 
      /* Specify whether or not to bold the text style of the item in the left pane. */
      item.setTextBold(true); 
      /* Set whether or not the current instance object can be clicked and dragged into another GlideTimelineItem */
      item.setIsDraggable(true); 
    }

## GlideTimelineItem - setLeftLabelText(String strText) {#ariaid-title14}

이 항목의 왼쪽 창에 표시할 텍스트를 지정합니다.
{#r_TLI-setLeftLabelText_S__table_ibb_lvm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| str텍스트 | 문자열 | 이 항목의 왼쪽 창에 표시할 텍스트입니다. |
[표 25. 매개변수]

{#r_TLI-setLeftLabelText_S__table_ibb_lvm_zt} {#r_TLI-setLeftLabelText_S__table_jbb_lvm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 26. 반환]

{#r_TLI-setLeftLabelText_S__table_jbb_lvm_zt}  
다음 예제는 setLeftLabelText() 를 사용하여 왼쪽 창의 텍스트를 설정하는 방법을 보여줍니다.

    var project_id="741cc7491b6f1c5043de32231b4bcbc5"; // Project ID 
    var grUser = new GlideRecord('user_resource');
    grUser.addQuery('planned_task', project_id);
    grUser.setQueryReferences(true);
    grUser.orderBy('user.name', 'DESC');
    grUser.query();
    while (grUser.next()) {
      var item = new GlideTimelineItem(grUser.getTableName(), grUser.user);
      /* Specify the text to display in the left pane for this item. */
      item.setLeftLabelText(grUser.user.name); 
      /* Set the name of the image file (including it's path) */
      item.setImage('../images/icons/user.gifx'); 
      /* Specify whether or not to bold the text style of the item in the left pane. */
      item.setTextBold(true); 
      /* Set whether or not the current instance object can be clicked and dragged into another GlideTimelineItem */
      item.setIsDraggable(true); 
    }

## GlideTimelineItem - setParent(문자열 sysId) {#ariaid-title15}

현재 GlideTimelineItem의 상위 항목을 설정합니다.
{#r_TLI-setParent_S__table_kbb_lvm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sysId | 문자열 | 현재 GlideTimelineItem의 상위 항목이 되어야 하는 GlideTimelineItem의 sysID입니다. |
[표 27. 매개변수]

{#r_TLI-setParent_S__table_kbb_lvm_zt} {#r_TLI-setParent_S__table_lbb_lvm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 28. 반환]

{#r_TLI-setParent_S__table_lbb_lvm_zt}

## GlideTimelineItem - setTextBold(부울 b) {#ariaid-title16}

왼쪽 창에서 항목의 텍스트 스타일을 굵게 표시할지 여부를 지정합니다.
{#r_TLI-setTextBold_B__table_obb_lvm_zt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| b | 부울 | 왼쪽 창의 텍스트를 굵게 표시해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 텍스트는 굵게 해야 합니다. * false: 텍스트는 굵게 사용할 수 없습니다. {#r_TLI-setTextBold_B__ul_kn4_1zz_2sb} |
[표 29. 매개변수]

{#r_TLI-setTextBold_B__table_obb_lvm_zt} {#r_TLI-setTextBold_B__table_pbb_lvm_zt__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 30. 반환]

{#r_TLI-setTextBold_B__table_pbb_lvm_zt}  
다음 예는 왼쪽 창의 텍스트를 굵게 설정하는 방법을 보여줍니다.

    var project_id="741cc7491b6f1c5043de32231b4bcbc5"; // Project ID 
    var grUser = new GlideRecord('user_resource');
    grUser.addQuery('planned_task', project_id);
    grUser.setQueryReferences(true);
    grUser.orderBy('user.name', 'DESC');
    grUser.query();
    while (grUser.next()) {
      var item = new GlideTimelineItem(grUser.getTableName(), grUser.user);
      /* Specify the text to display in the left pane for this item. */
      item.setLeftLabelText(grUser.user.name); 
      /* Set the name of the image file (including it's path) */
      item.setImage('../images/icons/user.gifx'); 
      /* Specify whether or not to bold the text style of the item in the left pane. */
      item.setTextBold(true); 
      /* Set whether or not the current instance object can be clicked and dragged into another GlideTimelineItem */
      item.setIsDraggable(true); 
    }