AbstractTimeLineSchedulePage - 전역

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기11분

    • AbstractTimeLineSchedulePage API는 타임라인에 표시되는 데이터 작업을 용이하게 하는 도우미 클래스입니다.

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

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

    • 항목을 업데이트하지 않음 - 기본 동작입니다. 1단계의 나머지 단계는 수행하지 마십시오.
    • 특정 항목으로 업데이트 - add()를 사용하여 수행됩니다.
    • getItems() 함수를 사용하여 타임라인 렌더링 - setDoReRenderTimeline(true)을 사용하여 수행됩니다.
    주:
    두 TimelineItems가 모두 반환되고 setDoReRenderTimeline true로 설정된 경우 시스템은 속성을 무시 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. 매개변수
    이름 유형 설명
    Obj타임라인 객체 타임라인에 추가할 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입니다.
    newStartDateTimeMs 문자열 범위의 새로운 시작 시간(밀리초)입니다. 숫자 비교를 수행하기 전에 parseInt()를 사용하여 문자열을 구문 분석해야 합니다.
    표 6. 반환
    유형 설명
    void

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

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

    표 7. 매개변수
    이름 유형 설명
    spanSysId 문자열 조정되는 현재 범위의 시스템 ID입니다.
    itemSysId 문자열 현재 범위와 연결된 타임라인 항목의 시스템 ID입니다.
    새 항목SysID 문자열 현재 범위를 끌어 놓은 타임라인 항목(행)의 시스템 ID입니다.
    표 8. 반환
    유형 설명
    void

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

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

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

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

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

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

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

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

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

    AbstractTimelineSchedulePage - elementTimeAdjustEnd(spanSysId 문자열, newEndDateTimeMs)

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

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

    AbstractTimelineSchedulePage - getItems()

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

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

    AbstractTimelineSchedulePage - inputBox(strInputText문자열)

    왼쪽 창 입력 상자에 문자열을 입력한 경우의 이벤트 처리기입니다.

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

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

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

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

    AbstractTimelineSchedulePage - setDoReRenderTimeline(부울 b)

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

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

    AbstractTimelineSchedulePage - setPageTitle(strTitle 문자열)

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

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

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

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

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

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

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

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

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