수식에서 분석 메서드 가져오기

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기4분
  • 에서 분석 허브 계산된 값을 수식에 삽입하려면 수식에 방법을 사용합니다.

    시작하기 전에

    필요한 역할: pa_power_user, admin

    이 태스크 정보

    수식에 분석 허브 대한 입력으로 계산된 값을 사용할 수 있습니다. 이 값은 현재 수식 표시기 자체를 포함하여 모든 표시기에서 가져올 수 있습니다.

    에서 분석 허브값을 가져오려면 PAFormulaUtils() 의 메서드를 수식에 삽입합니다. 이러한 메서드 중 하나를 호출하려면 변수 pa퍼포먼스 분석 사용하십시오. 예를 들어, PAFormulaUtils.getScore 메서드를 사용하려면 pa.getScore를 호출합니다. 자세한 내용은 PAFormulaUtils API을(를) 참조하십시오.

    프로시저

    1. 수식 표시기 기록을 엽니다.
    2. 수식 상자 아래에서 메서드 찾아보기를 클릭합니다.
      방법을 선택할 수 있는 대화 상자가 열립니다.
    3. 필요에 맞는 방법을 찾아보십시오.
      방법은 편집 중인 현재 수식 또는 지정해야 하는 다른 표시기를 참조합니다. 목록에는 메서드 이름 대신 각 메서드에 대한 설명이 포함된 레이블이 표시됩니다.

      "수식에 방법 추가" 대화 상자에서 지정된 표시기의 전역 대상 간격 가져오기"가 강조 표시된 방법에 대한 설명이 포함된 레이블 목록입니다.
    4. 메서드를 선택합니다.
      메서드를 선택하면 메서드 이름과 매개변수 필드를 포함한 설명이 열립니다.

      선택한 지정된 표시기의 전역 대상 간격 가져오기 및 마지막으로 수집된 점수로 지정된 날짜를 보여주는 수식에 메서드 추가 대화 상자
      날짜 필드는 다음 값을 사용할 수 있습니다.
      • YYYY-MM-DD 형식의 절대 날짜입니다(예: 2018-12-21).
      • 변수 score_start 또는 score_end. 이러한 변수는 참조된 표시기에 대해 계산되는 수집 기간의 첫 번째와 마지막 초를 나타냅니다. 시간은 사용자의 시간대와 데이터베이스 서버 시간대(GMT) 간의 차이에서 계산됩니다. 자세한 내용은 다른 사용자 시간대로 인한 score_start/종료 변경을(를) 참조하십시오.
      • GlideDate 또는 GlideDateTime API를 사용하여 직접 코딩한 날짜 매개변수입니다.
    5. 매개변수를 입력하고 선택(Select)을 클릭합니다.
      대화 상자가 닫히고 방법이 표시기 양식의 수식 필드에 나타납니다.
    6. 표시기를 지정해야 하는 경우에는 커서로 표시기 매개변수를 선택하고 표시기 찾아보기를 클릭합니다.
      표시기 선택 대화 상자가 열립니다.
      수식의 메서드 내에서 표시기 선택 대화 상자 열기
    7. 표시기를 선택합니다.
    8. 옵션: 세부 항목 또는 요소와 시계열 집계를 선택합니다.
    9. 메서드에서 사용을 선택하고 제출을 클릭합니다.
      표시기를 선택하여 메서드가 완료되었습니다. 달러 기호 $가 표시기 앞에 옵니다. 이 달러 기호는 표시기 점수 대신 표시기 값이 반환됨을 의미합니다 분석 허브 . 분석 허브방법에 사용 확인란을 선택하면 점수 대신 값이 선택됩니다.
      표시기, 세부 항목, 요소 및 메서드에 사용 확인란이 선택됨

    인덱스 표시기

    인덱스 표시기는 여러 표시기를 나타내는 단일 점수를 생성하기 위한 수식 표시기의 사용 사례입니다. 다음 예에서는 다음 표시기에 대한 점수와 전역 대상 간의 격차를 집계하는 단일 인덱스가 필요합니다.
    • 지연된 인시던트의 백분율입니다.
    • 미해결 인시던트의 마지막 업데이트의 평균 연령입니다.
    • 미해결된 인시던트의 총 수입니다.
    이 단일 인덱스를 가져오려면 방향최대화로 설정된 수식 표시기를 만듭니다. 모든 인덱스 지표는 최대화되어야 합니다. 그런 다음 메서드 찾아보기표시기 찾아보기 함수를 사용하여 다음 수식을 만듭니다.
    var a = pa.getGap($[[% of open overdue incidents]], score_start) / pa.getGlobalTarget($[[% of open overdue incidents]],score_start);
    var b = pa.getGap($[[Average age of last update of open incidents]], score_start) / pa.getGlobalTarget($[[Average age of last update of open incidents]], score_start);
    var c = pa.getGap($[[Number of open incidents]], score_start) / pa.getGlobalTarget($[[Number of open incidents]], score_start);
    var res = 100 - (100 * (a + b + c) / 3);
    res;

    변경 자체에 대한 대상 설정

    인시던트 백로그에서 팀의 목표를 매월 10% 감소로 설정하려고 합니다. 다음 수식을 사용하여 수식 표시기를 만들고 에서 이 표시기 분석 허브의 목표를 -10%로 설정합니다.

    var lastPeriod = new GlideDateTime(score_start.getYearUTC() + '-' + score_start.getMonthUTC() + '-01');
    lastPeriod.addDaysUTC(-1);
    pa.getChangePercentage($[[Number of open incidents]], lastPeriod.addDaysUTC(-1), score_start);

    세부 항목 및 요소를 기준으로 점수를 필터링합니다.

    우선순위 = 1 - 중요인 인시던트의 점수를 필터링하려고 합니다.
    1. 우선순위 세부 항목과 1 - 중요 요소에 대한 고유 기록 식별자를 가져옵니다. 세부 항목 기록은 세부 항목 테이블에 있습니다. 요소 기록의 위치는 다양하지만 세부 항목의 세분화 소스에서 식별됩니다. 이 경우 요소는 선택 [sys_choice] 기록입니다. 고유 기록 식별자를 얻는 방법에 대한 지침은 고유 기록 식별자(sys_id)를 참조하십시오.

      고유 기록 식별자는 우선순위 세부 항목의 경우 baec0752bf130100b96dac808c0739ed, 1 - 중요 요소의 경우 8a4dde73c6112278017a6a4baf547aa7입니다.

    2. 다음 수식을 사용하여 표시기를 만듭니다.
      var res = [[Number of open incidents]];
      if(pa.getCurrentBreakdownID() == 'baec0752bf130100b96dac808c0739ed' && pa.getCurrentElementID() == '8a4dde73c6112278017a6a4baf547aa7')
      {
      res = 0;
      }
      res;