AbstractTimelineSchedulePage - 전역

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기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(개체 ObjTimeline)

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

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

    AbstractTimelineSchedulePage - addSeparator()

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

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

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

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

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

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

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

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

    AbstractTimelineSchedulePage - elementMoveXY(문자열 spanSysId, 문자열 itemSysId, 문자열 itemSysId, 문자열 newItemSysId, 문자열 newStartDateTimeMs)

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

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

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

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

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

    AbstractTimelineSchedulePage - elementSuccessor(문자열 spanSysId, 문자열 newSuccSpanId)

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

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

    AbstractTimelineSchedulePage - elementTimeAdjustEnd(문자열 spanSysId, 문자열 newEndDateTimeMs)

    타임라인 범위의 종료 날짜가 수정되었을 때의 이벤트 핸들러입니다.

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

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

    타임라인 범위의 시작 날짜가 수정되었을 때의 이벤트 핸들러입니다.

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

    AbstractTimelineSchedulePage - getItems()

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

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

    AbstractTimelineSchedulePage - inputBox(문자열 strInputText)

    문자열이 왼쪽 창 입력 상자에 입력되었을 때의 이벤트 핸들러입니다.

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

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

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

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

    AbstractTimelineSchedulePage - setDoReRenderTimeline(부울 b)

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

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

    AbstractTimelineSchedulePage - setPageTitle(문자열 strTitle)

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

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

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

    AbstractTimelineSchedulePage - setStatusError(문자열 문자열 제목, 문자열 문자열 메시지)

    현재 이벤트 요청을 GlideTimeline 이벤트 처리의 2단계에서 표시할 지정된 제목 및 메시지와 함께 오류 상태로 설정합니다.

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

    AbstractTimelineSchedulePage - setStatusPrompt(문자열 strTitle, 문자열 strOkFunction, 문자열 strCancelFunction, 문자열 strCloseFunction)

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

    확인 상자에는 각각 매개 변수 인수에 지정된 함수를 호출하는 새 이벤트를 생성하는 확인 및 취소 단추가 표시됩니다.
    주:
    OK,Cancel, Close에 대한 사용자 정의 함수는 현재 이벤트에 대한 것과 동일한 파라미터 인수를 받습니다.
    표 29. 매개변수
    이름 유형 설명
    strTitle (영문) 문자열 대화 상자에 표시할 텍스트입니다. 텍스트에는 HTML 서식이 포함될 수 있습니다.
    strOk함수 문자열 사용자가 확인 버튼을 클릭할 경우 현재 스크립트 포함 클래스에서 호출할 함수입니다.
    strCancelFunction (영문) 문자열 사용자가 취소 버튼을 클릭할 경우 현재 스크립트 포함 클래스에서 호출할 함수입니다.
    strClose함수 문자열 사용자가 닫기 버튼을 클릭할 경우 현재 스크립트 포함 클래스에서 호출할 함수입니다.
    표 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 (영문) 문자열 대화 상자 제목에 표시할 텍스트입니다.
    str메시지 문자열 대화 상자 내에 표시할 텍스트입니다. 텍스트에는 HTML 서식이 포함될 수 있습니다.
    표 32. 반환
    유형 설명
    void