AbstractTimelineSchedulePage - 전역

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 11분

    • AbstractTimelineSchedulePage 스크립트 포함은 타임라인에 표시된 데이터 작업을 용이하게 하는 도우미 클래스입니다.

    타임라인 내에 표시되는 데이터 처리는 지정된 스크립트 포함의 해당 함수를 실행하여 시작됩니다. 다른 스크립트 포함과 마찬가지로 언어 구문은 JavaScript이며 이 유형의 자원에 대한 기본 보안 제약 조건을 따릅니다. 그러나 다양한 유형의 표시 옵션이 복잡하기 때문에 도우미 클래스가 생성되었습니다. 타임라인을 표시하려면 AbstractTimelineSchedulePage 클래스를 확장하고 해당 일정 페이지와 페어링합니다. 최소한 확장 클래스는 getItems() 메서드를 재정의해야 하는데, 이는 클라이언트에 표시할 항목을 반환하기 위한 기본 이벤트 처리기이기 때문입니다.

    클라이언트는 AbstractTimelineSchedulePage 가 반환하는 데이터를 두 단계로 처리합니다. 첫 번째 단계에서는 타임라인을 실제로 업데이트합니다. 구성된 경우 두 번째 단계에서는 성공 메시지 상자, 오류 메시지 상자 또는 대화 상자 메시지 프롬프트가 표시된 직후에 표시됩니다. 1단계에서 데이터 조작에 사용할 수 있는 옵션은 다음과 같습니다.

    • 항목을 업데이트하지 않음: 기본 동작입니다. 1단계의 나머지 단계는 수행하지 마십시오.
    • 특정 항목으로 업데이트: add()를 사용하여 수행됩니다.
    • getItems() 함수를 사용하여 타임라인을 렌더링합니다. 이 작업은 setDoReRenderTimeline(true)를 사용하여 수행됩니다.
    주:
    두 TimelineItems가 모두 반환되고 setDoReRenderTimelinetrue로 설정된 경우 시스템은 속성을 무시 setDoReRenderTimeline 하고 add() 함수에 의해 추가된 TimelineItems만 명시적으로 표시합니다.

    2단계에서 사용할 수 있는 옵션은 다음과 같습니다.

    • 메시지 상자를 표시하지 않음: 기본 동작입니다.
    • 성공 대화 상자를 표시합니다. 이 작업은 setStatusSuccess()를 사용하여 수행됩니다.
    • 오류 대화 상자 표시: 이 작업은 setStatusError()를 사용하여 수행됩니다.
    • 대화 상자 확인 상자 표시: setStatusPrompt()를 사용하여 수행됩니다.
    주:

    AbstractTimelineSchedulePage를 확장하는 스크립트 포함 클래스는 접두사가 sysparm_timeline_로 시작하는 원래 URL에서 모든 URI 매개변수를 자동으로 수신합니다. 이러한 값에 액세스하려면 다음을 사용하십시오. this.getParameter("sysparm_timeline_VARIABLE"); 확장 클래스 내에서.

    이 기능은 목록의 컨텍스트 메뉴와 같은 동적 요소에서 일정 페이지를 표시해야 하는 경우에 유용합니다. URL을 통해 동적 데이터를 전달하면 일정 페이지에 Ajax 호출 내에 이러한 매개 변수가 자동으로 포함되므로 AbstractTimelineSchedulePage 스크립트 포함 내에서 액세스할 수 있습니다.

    AbstractTimelineSchedulePage - add(Object ObjTimeline)

    클라이언트에 반환되고 타임라인에 적절하게 표시될 TimelineItem 개체를 추가합니다.

    표 1. 매개변수
    이름 유형 설명
    Obj타임라인 객체 타임라인에 추가할 TimelineItem 객체입니다.
    표 2. 반환
    유형 설명
    void

    AbstractTimelineSchedulePage - addSeparator()

    타임라인 항목 목록에 가로 프레임 구분선을 추가합니다. add()를 통해 추가된 모든 향후 항목은 후속 타임라인 프레임에 추가됩니다.

    add() 메서드를 사용하여 추가된 모든 향후 항목은 후속 타임라인 프레임에 추가됩니다.

    표 3. 매개변수
    이름 유형 설명
    없음
    표 4. 반환
    유형 설명
    void

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    // Inside of a script include that extends AbstractTimelineSchedulePage
      this.addSeparator();

    AbstractTimelineSchedulePage - elementMoveX(String spanSysId, String newStartDateTimeMs)

    타임라인 범위가 가로로 이동할 때의 이벤트 핸들러입니다.

    표 5. 매개변수
    이름 유형 설명
    spanSysId 문자열 조정 중인 현재 범위의 시스템 ID입니다.
    newStartDateTimeMs 문자열 범위의 새 시작 시간(밀리초)입니다. 수치 비교를 수행하기 전에 parseInt()를 사용하여 문자열을 구문 분석해야 합니다.
    표 6. 반환
    유형 설명
    void

    AbstractTimelineSchedulePage - elementMoveXY(String spanSysId, String itemSysId, String itemSysId, String newItemSysId, String newStartDateTimeMs)

    타임라인 범위가 가로 및 세로로 모두 이동할 때의 이벤트 핸들러입니다.

    표 7. 매개변수
    이름 유형 설명
    spanSysId 문자열 조정 중인 현재 범위의 시스템 ID입니다.
    itemSysId 문자열 현재 범위와 연결된 타임라인 항목의 시스템 ID입니다.
    newItemSysId 문자열 현재 범위를 끌어온 타임라인 항목(행)의 시스템 ID입니다.
    newStartDateTimeMs 문자열 범위의 새 시작 시간(밀리초)입니다. 수치 비교를 수행하기 전에 parseInt() 를 사용하여 문자열을 구문 분석해야 합니다.
    표 8. 반환
    유형 설명
    void

    AbstractTimelineSchedulePage - elementMoveY(문자열 spanSysId, 문자열 itemSysId, 문자열 newItemSysId)

    타임라인 범위가 세로로 이동할 때의 이벤트 핸들러입니다.

    표 9. 매개변수
    이름 유형 설명
    spanSysId 문자열 조정 중인 현재 범위의 시스템 ID입니다.
    itemSysId 문자열 현재 범위와 연결된 타임라인 항목의 시스템 ID입니다.
    newItemSysId 문자열 현재 범위를 끌어온 타임라인 항목(행)의 시스템 ID입니다.
    표 10. 반환
    유형 설명
    void

    AbstractTimelineSchedulePage - elementSuccessor(String spanSysId, string newSuccSpanId)

    두 범위 간에 타임라인 관계가 생성된 경우에 대한 이벤트 핸들러입니다.

    표 11. 매개변수
    이름 유형 설명
    spanSysId 문자열 새로 만든 관계의 선행 작업이 될 현재 범위의 시스템 ID입니다.
    newSuccSpanId 문자열 생성된 관계의 후속 범위 시스템 ID입니다.
    표 12. 반환
    유형 설명
    void 반환 값

    AbstractTimelineSchedulePage - elementTimeAdjustEnd(String spanSysId, String newEndDateTimeMs)

    타임라인 범위의 종료 날짜가 수정된 경우에 대한 이벤트 핸들러입니다.

    표 13. 매개변수
    이름 유형 설명
    spanSysId 문자열 조정 중인 현재 범위의 시스템 ID입니다.
    newEndDateTimeMs 문자열 범위의 새 종료 시간(밀리초)입니다. 수치 비교를 수행하기 전에 parseInt() 를 사용하여 문자열을 구문 분석해야 합니다.
    표 14. 반환
    유형 설명
    void

    AbstractTimelineSchedulePage - elementTimeAdjustStart(문자열 spanSysId, 문자열 newStartDateTimeMs)

    타임라인 범위의 시작 날짜가 수정된 경우에 대한 이벤트 핸들러입니다.

    표 15. 매개변수
    이름 유형 설명
    spanSysId 문자열 조정 중인 현재 범위의 시스템 ID입니다.
    newStartDateTimeMs 문자열 범위의 새 시작 시간(밀리초)입니다. 수치 비교를 수행하기 전에 parseInt() 를 사용하여 문자열을 구문 분석해야 합니다.
    표 16. 반환
    유형 설명
    void

    AbstractTimelineSchedulePage - getItems()

    타임라인에 표시할 일정 항목을 반환하는 이벤트 핸들러입니다.

    표 17. 매개변수
    이름 유형 설명
    없음
    표 18. 반환
    유형 설명
    void

    AbstractTimelineSchedulePage - inputBox(String, strInputText)

    왼쪽 창 입력 상자에 문자열을 입력한 경우에 대한 이벤트 핸들러입니다.

    표 19. 매개변수
    이름 유형 설명
    strInputText 문자열 왼쪽 창의 입력 상자에 입력된 텍스트입니다.
    표 20. 반환
    유형 설명
    void

    AbstractTimelineSchedulePage - itemMove(문자열 itemSysId, 문자열 newItemSysId)

    타임라인 행 항목이 다른 행 항목으로 이동하고 끌 때의 이벤트 핸들러입니다.

    표 21. 매개변수
    이름 유형 설명
    itemSysId 문자열 현재 범위와 연결된 타임라인 항목의 시스템 ID입니다.
    newItemSysId 문자열 현재 범위를 끌어온 타임라인 항목(행)의 시스템 ID입니다.
    표 22. 반환
    유형 설명
    void

    AbstractTimelineSchedulePage - setDoReRenderTimeline(부울 b)

    getItems() 함수를 사용하여 모든 타임라인 항목을 다시 렌더링할지 여부를 지정합니다.

    표 23. 매개변수
    이름 유형 설명
    b 부울 true이면 서버의 getItems() 핸들러에 새 이벤트 호출을 수행하여 타임라인을 다시 렌더링합니다.
    표 24. 반환
    유형 설명
    void

    AbstractTimelineSchedulePage - setPageTitle(String strTitle)

    타임라인의 제목으로 표시할 텍스트를 지정합니다.

    페이지 제목은 모든 대화형 이벤트에서 설정(및 업데이트)할 수 있습니다. 그러나 getItems() 이벤트 중에 설정하는 것이 좋습니다.

    표 25. 매개변수
    이름 유형 설명
    strTitle 문자열 타임라인 제목에 표시할 텍스트입니다.
    표 26. 반환
    유형 설명
    void

    AbstractTimelineSchedulePage - setStatusError(String strTitle, String strMessage)

    GlideTimeline 이벤트 처리의 2단계에서 표시할 지정된 제목과 메시지를 사용하여 현재 이벤트 요청을 오류 상태로 설정합니다.

    표 27. 매개변수
    이름 유형 설명
    strTitle 문자열 대화 상자 제목에 표시할 텍스트입니다.
    strMessage 문자열 대화 상자에 표시할 텍스트입니다. 텍스트에는 HTML 서식이 포함될 수 있습니다.
    표 28. 반환
    유형 설명
    void

    AbstractTimelineSchedulePage - setStatusPrompt(String strTitle, String strOkFunction, String strCancelFunction, String strCloseFunction)

    현재 이벤트 요청을 GlideTimeline 이벤트 처리의 2단계 중 확인 대화 상자에 표시할 지정된 제목과 메시지와 함께 프롬프트 오류 상태로 설정합니다. 확인 상자에는 각각 매개 변수 인수를 지정하는 함수를 호출할 새 이벤트를 생성하는 OK 및 Cancel 단추가 표시됩니다. OK,Cancel 및 Close에 대한 사용자 정의 함수는 현재 이벤트에 대한 매개 변수 인수와 동일한 매개 변수 인수를 받습니다.

    확인 상자에는 각각 매개 변수 인수를 지정하는 함수를 호출할 새 이벤트를 생성하는 OK 및 Cancel 단추가 표시됩니다.
    주:
    OK,Cancel 및 Close에 대한 사용자 정의 함수는 현재 이벤트에 대한 매개 변수 인수와 동일한 매개 변수 인수를 받습니다.
    표 29. 매개변수
    이름 유형 설명
    strTitle 문자열 대화 상자에 표시할 텍스트입니다. 텍스트에는 HTML 서식이 포함될 수 있습니다.
    strOk함수 문자열 사용자가 확인 단추를 클릭할 경우 현재 스크립트 포함 클래스에서 호출할 함수입니다.
    strCancelFunction 문자열 사용자가 취소 버튼을 클릭할 경우 현재 스크립트 포함 클래스에서 호출할 함수입니다.
    strCloseFunction 문자열 사용자가 닫기 버튼을 클릭할 경우 현재 스크립트 포함 클래스에서 호출할 함수입니다.
    표 30. 반환
    유형 설명
    void 
    var MyTimelineScriptIncludeClass = Class.create();
      MyTimelineScriptIncludeClass.prototype = Object.extendsObject(AbstractTimelineSchedulePage, {
      
      getItems: function() {
      //...
      },
      
      elementTimeAdjustEnd: function(spanSysId, newEndDateTimeMs) {
      // Display a status prompt dialog box
      this.setStatusPrompt('Confirm Action', 'Are you sure you want to do that?',
      'this._myOkHandlerFunction',  
      'this._myCancelHandlerFunction',
      'this._myCloseHandlerFunction');
      },
      
      _myOkHandlerFunction: function(spanSysId, newEndDateTimeMs) { // ... },
      
      _myCancelHandlerFunction: function(spanSysId, newEndDateTimeMs) { // ... },
      
      _myCloseHandlerFunction: function(spanSysId, newEndDateTimeMs) { // ... }
      };

    AbstractTimelineSchedulePage - setStatusSuccess(문자열 strTitle, 문자열 strMessage)

    GlideTimeline 이벤트 처리의 2단계에서 표시할 지정된 제목과 메시지를 사용하여 현재 이벤트 요청을 성공 상태로 설정합니다.

    표 31. 매개변수
    이름 유형 설명
    strTitle 문자열 대화 상자 제목에 표시할 텍스트입니다.
    strMessage 문자열 대화 상자에 표시할 텍스트입니다. 텍스트에는 HTML 서식이 포함될 수 있습니다.
    표 32. 반환
    유형 설명
    void