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

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

    시작하기 전에

    필요한 역할: pa_power_user, admin

    이 태스크 정보

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

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

    프로시저

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

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

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

    인덱스 표시기

    인덱스 표시기는 여러 표시기를 나타내는 단일 점수를 생성하기 위한 수식 표시기의 사용 사례입니다. 다음 예제에서는 다음 표시기에 대해 점수와 전역 대상 간의 격차를 집계하는 단일 인덱스가 필요합니다.
    • 지연된 인시던트의 백분율입니다.
    • 미해결 인시던트의 마지막 업데이트의 평균 연령입니다.
    • 미해결 인시던트의 총 수입니다.
    이 단일 인덱스를 가져오려면 방향최대화로 설정된 수식 표시기를 만듭니다. 모든 인덱스 지표는 최대화되어야 합니다. 그런 다음 메서드 찾아보기표시기 함수 찾아보기를 사용하여 다음 수식을 만듭니다.
    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.getYear() + '-' + score_start.getMonth() + '-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;