ProcessMiningIntegrationAPI - 범위 지정됨

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

    • ProcessMiningIntegrationAPI 스크립트 포함은 프로세스 마이닝 프로젝트를 관리하고 결과 및 세부 항목을 검색하는 메서드를 제공합니다.

    이 스크립트 포함에는 프로세스 마이닝 Core 플러그인(com.sn_process_optimization)이 필요합니다. 자세한 내용은 Process Mining 문서를 참조하십시오.

    호출하는 사용자에게 sn_process_optimization_analyst 또는 sn_process_optimization_power_user 역할이 있어야 합니다.

    다음 시스템 속성을 사용하여 API 기능을 관리할 수 있습니다.
    promin.limit.api.project_creation
    API를 사용하여 매일 생성할 수 있는 프로젝트 수를 제한합니다.

    기본값: 25.

    promin.limit.api.max_daily_minings
    API를 사용하여 매일 예약할 수 있는 마이닝 수를 제한합니다.

    기본값: 25.

    promin.limit.api.max_daily_minings_per_project
    API를 사용하여 프로젝트당 매일 예약할 수 있는 마이닝 수를 제한합니다.

    기본값: 1.

    promin.api.allow_no_role_mining
    sn_process_optimization_analyst 역할이 없는 사용자가 프로젝트를 마이닝할 수 있도록 허용합니다.

    기본값: False.

    promin.api.auto_share_project_with_creator
    프로젝트를 프로젝트 작성자와 자동으로 공유합니다.

    기본값: False.

    ProcessMiningIntegrationAPI - createProject(문자열 테이블, 배열 활동, 배열 세부 항목, 문자열 encodedQuery, 문자열 templateType, 객체 권한, 부울 자동 폐기)

    프로세스 마이닝 프로젝트를 생성합니다.

    프로젝트는 프로세스 마이닝 작업에 대한 청사진 역할을 합니다. 마이닝이 수행되는 프로세스와 마이닝하는 동안 고려되는 프로세스의 속성을 선택합니다.

    표 1. 매개변수
    이름 유형 설명
    테이블 문자열 분석할 데이터가 포함된 테이블의 이름입니다.
    activities 배열 프로젝트에 대한 활동 정의입니다.

    활동 정의는 상태 또는 할당 그룹과 같이 마이닝하는 동안 고려해야 할 프로세스의 속성입니다. 매개변수에 지정된 테이블의 열이어야 합니다 table . 프로젝트를 마이닝하려면 하나 이상의 활동 정의가 필요합니다. 활동 정의에 대한 자세한 내용은 다음 문서를 Set activity definitions참조하십시오.

    주:
    활동 정의는 매개변수에 templateType 지정된 프로젝트 템플릿에도 포함됩니다. activities 매개변수를 사용하여 템플릿에 포함되지 않은 추가 활동을 지정합니다.
    ["<column_name>"]
    세부 항목 배열 프로젝트에 대한 세부 항목 정의입니다.

    세부 항목 정의를 사용하면 기록을 필터링하고 우선순위 또는 비즈니스 범주와 같은 범주별로 프로세스 맵을 분석할 수 있습니다. 매개변수에 지정된 테이블의 열이어야 합니다 table . 프로젝트를 마이닝하는 데는 세부 항목 정의가 필요하지 않습니다. 세부 항목 정의에 대한 자세한 내용은 다음 문서를 참조하십시오 Set breakdown definitions.

    주:
    세부 항목 정의는 매개변수에 templateType 지정된 프로젝트 템플릿에도 포함됩니다. breakdowns 이 매개변수를 사용하여 템플릿에 포함되지 않은 추가 세부 항목을 지정합니다.
    ["<column_name>"]
    encodedQuery 문자열 분석할 데이터를 선택하는 인코딩된 쿼리입니다. 이렇게 하면 지정된 기간의 데이터만 선택하는 것과 같이 분석되는 데이터를 제한할 수 있습니다.

    테이블의 모든 데이터를 포함하려면 빈 문자열을 전달할 수 있습니다.
    templateType 문자열 프로젝트에 사용할 템플릿의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 기본값
    • 디지털 포트폴리오 관리
    • 벤더 관리
    • WFO

    WFO, 벤더 관리 또는 디지털 포트폴리오 관리에 속하지 않는 프로젝트의 경우 기본값을 선택합니다. 예를 들어 Performance Analytics 프로젝트를 만들려면 기본값을 선택합니다.
    권한 객체 프로젝트를 공유할 그룹, 역할 및 사용자의 맵으로, 키는 sys_id이고 값은 유형(그룹, 역할 또는 사용자)을 지정합니다.

    프로젝트를 공유하는 모든 사용자는 분석된 모델을 보고 프로젝트 구성을 볼 수 있습니다. sn_process_optimization_analyst 또는 sn_process_optimization_power_user 있는 사용자만 프로젝트를 마이닝할 수 있습니다.

    {
   "<user_sys_id>":"user",
   "<role_sys_id>":"role",
   "<group_sys_id>":"group"
}
    autoRetire 부울

    옵션입니다. 프로젝트를 자동으로 폐기할지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 프로젝트가 생성 후 7일 후에 자동으로 폐기됩니다.
    • false: 프로젝트가 자동으로 폐기되지 않습니다.

    기본값: False
    표 2. 반환
    유형 설명
    객체 프로젝트에 대한 정보를 포함하는 객체입니다.
    {
   "entity": {Object},
   "findingDefinitionKPIMap": {Object},
   "id": "String",
   "lastMined": String",
   "miningState": "String",
   "name": "String",
   "permissions": [Array],
   "retiredDate": "String"
}
    <Object>.실체 프로젝트에서 분석된 데이터에 대한 정보를 포함하는 객체입니다.

    데이터 유형: 객체

    {
   "activityDefinitions": [Array],
   "breakdownDefinitions": [Array],
   "condition": "String,"
   "table": "String"
}
    <Object>.entity.activityDefinitions 프로젝트에 대한 활동 정의입니다.

    데이터 유형: 배열

    [
   {
      "activityOfInterest":Boolean,
      "field":"String",
      "type":"String"      
   }
]
    <Object>.entity.activityDefinitions.activityOfInterest

    분석가 워크벤치에 필드 변경 내용이 표시되는지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 분석가 워크벤치에 필드 변경 내용이 나타납니다.
    • false: 필드 변경 내용이 분석가 워크벤치에 표시되지 않지만 전환 또는 결과의 상황별 조건에서 계속 사용할 수 있습니다.
    <Object>.entity.activityDefinitions.field 분석할 데이터가 포함된 필드입니다. 필드는 매개변수에 지정된 테이블에서 가져와야 합니다 table .
    <Object>.entity.activityDefinitions.type 마이닝할 값의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 필드 값(기본값): 기본 선택 사항입니다. 이 옵션은 활동 정의를 생성할 때마다 사용할 수 있습니다.
    • 날짜 시간: 감사 이력이 아닌 실제 기록의 날짜 시간 값을 사용하며 프로세스 맵에 그룹화된 노드로 표시됩니다.
    • 복합: 감사 이력이 아닌 실제 기록에서 여러 필드 값의 변화를 나타내는 하나의 노드 또는 프로세스 그래프입니다.
    • 하위 첨부: 이 옵션은 테이블 구성을 위해 두 개의 테이블을 선택하고 하위-상위 관계를 설정한 경우에 사용할 수 있습니다. 이 옵션은 상위 테이블 구성에만 사용할 수 있습니다. 시각화에서는 하위 항목이 프로세스에서 연결된 시기를 확인할 수 있습니다.
    • 상위 첨부됨: 이 옵션은 상위 기록이 하위에 첨부된 시기를 나타내는 하위 프로세스에 노드를 생성합니다.
    <Object>.entity.breakdownDefinitions 프로젝트에 대한 세부 항목 정의입니다.

    데이터 유형: 배열

    [
 {
   "field":"String",
   "fieldLabel":"String"
 }
]
    <Object>.entity.breakdownDefinitions.field 세부 항목에 사용되는 필드의 이름입니다.

    데이터 유형: 문자열
    <Object>.entity.breakdownDefinitions.fieldLabel 세부 항목에 사용되는 필드의 레이블입니다.

    데이터 유형: 문자열
    <Object>.entity.condition 분석할 데이터를 선택하는 인코딩된 쿼리입니다.

    데이터 유형: 문자열
    <Object>.entity.table 분석할 데이터가 포함된 테이블의 이름입니다.

    데이터 유형: 문자열
    <Object>.findingDefinitionKPIMap 찾기 정의 및 KPI(핵심성과지표)의 맵으로, 여기서 키는 찾기 정의 sys_id이고 값은 찾기 정의의 영향을 받는 KPI sys_ids 배열입니다.

    찾기 정의는 찾기 정의[promin_finding_def] 및 자동화된 찾기 정의[promin_automated_finding] 테이블에 있습니다. KPI는 지표 [pa_indicators] 테이블에 있습니다.

    정의 및 KPI 찾기에 대한 자세한 내용은 해당 Viewing business insights문서를 Working with finding definitions 참조하십시오.

    데이터 유형: 객체

    {
   "<finding_def_sys_id":[
      "<kpi_sys_id>"
   ]
}
    <Object>.아이디 프로젝트의 Sys_id입니다.

    테이블: 프로젝트 정의 [promin_project]

    데이터 유형: 문자열
    <Object>.lastMined 프로젝트가 마지막으로 마이닝된 날짜입니다.

    데이터 유형: 문자열
    <Object>.miningState 프로젝트의 마이닝 상태입니다.

    마이닝 상태에 대한 설명은 문서를 참조하십시오 Mine states.

    데이터 유형: 문자열
    <Object>.이름 프로젝트의 이름입니다.

    데이터 유형: 문자열
    <Object>.권한을 프로젝트에 대한 그룹, 역할 및 사용자 권한입니다.

    데이터 유형: 객체

    [
   {
      "type":"String",
      "value":"String"      
   }
]
    <Object>.permissions.type 권한의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 그룹
    • role
    • 사용자

    데이터 유형: 문자열
    <Object>.permissions.value 권한을 부여할 그룹, 역할 또는 사용자의 Sys_id입니다.

    데이터 유형: 문자열
    <Object>.폐기날짜 프로젝트가 폐기되는 날짜입니다.

    데이터 유형: 문자열

    이 예에서는 지난 달에 생성된 인시던트의 데이터를 사용하여 프로젝트를 만듭니다.

    SNC.ProcessMiningIntegrationAPI
.createProject(
"incident", // table name
["state"], // activity definitions
["priority"], // breakdown definitions
"sys_created_onONLast month@javascript:gs.beginningOfLastMonth()@javascript:gs.endOfLastMonth()", // incident created on last month
"DEFAULT", // template type
{"02acf036b3120010ed7fc9c316a8dc0c":"user"}, // map of permissions "sys_id":"type"
true // auto retire project
);

    출력:

    {
   "entity":{
      "table":"incident",
      "condition":"sys_created_onONLast month@javascript:gs.beginningOfLastMonth()@javascript:gs.endOfLastMonth()",
      "activityDefinitions":[
         {
            "field":"assignment_group",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"business_service",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"category",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"priority",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"state",
            "type":"DEFAULT",
            "activityOfInterest":false
         }
      ],
      "breakdownDefinitions":[
         {
            "field":"contact_type",
            "fieldLabel":"Channel"
         },
         {
            "field":"assignment_group",
            "fieldLabel":"Assignment group"
         },
         {
            "field":"location",
            "fieldLabel":"Location"
         },
         {
            "field":"priority",
            "fieldLabel":"Priority"
         },
         {
            "field":"category",
            "fieldLabel":"Category"
         }
      ]
   },
   "name":"Incident Process",
   "permissions":[
      {
         "value":"62826bf03710200044e0bfc8bcbe5df1",
         "type":"user"
      },
      {
         "value":"02acf036b3120010ed7fc9c316a8dc0c",
         "type":"user"
      }
   ],
   "id":"a4286c4f4f831210c98b8a4a91ce0bf5",
   "miningState":"NEW",
   "findingDefinitionKPIMap":{
      "f23c20c34fc31210c98b8a4a91ce0bac":[
         "002d65c3d7131100b96d45a3ce6103e2"
      ]
   },
   "retiredDate":null,
   "lastMined":null
}

    ProcessMiningIntegrationAPI - deleteProject(String projectId)

    프로세스 마이닝 프로젝트를 삭제합니다.

    표 3. 매개변수
    이름 유형 설명
    projectId 문자열 프로젝트의 Sys_id입니다.

    테이블: 프로젝트 정의 [promin_project]
    표 4. 반환
    유형 설명
    없음

    이 예에서는 프로세스 마이닝 프로젝트를 삭제합니다.

    SNC.ProcessMiningIntegrationAPI.deleteProject("a4286c4f4f831210c98b8a4a91ce0bf5");

    ProcessMiningIntegrationAPI - getBreakDownStats(문자열 projectId)

    프로세스 마이닝 프로젝트에 대한 세부 항목 통계를 가져옵니다.

    세부 항목을 사용하면 기록을 필터링하고 우선순위 또는 비즈니스 범주와 같은 범주별로 프로세스를 분석할 수 있습니다.

    표 5. 매개변수
    이름 유형 설명
    projectId 문자열 프로젝트의 Sys_id입니다.

    테이블: 프로젝트 정의 [promin_project]
    표 6. 반환
    유형 설명
    배열 세부 항목 객체의 배열입니다. 각 객체에는 세부 항목에 대한 통계가 포함되어 있습니다.
    [
   {
      "caseCount": Number,
      "field": "String",
      "fieldValue": "String",
      "performanceStats": {Object},
      "tableName": "String",
      "variantCount": Number     
   }
]
    <배열>.caseCount 이 세부 항목의 일부인 케이스 기록 [promin_case_record] 테이블의 케이스 수입니다.

    데이터 유형: 숫자
    <배열>.필드 세부 항목에 사용되는 필드입니다.

    데이터 유형: 문자열
    <배열>.fieldValue 세부 항목에 사용되는 필드 값입니다.

    데이터 유형: 문자열
    <배열>.performanceStats 세부 항목에 대한 성과 통계입니다.
    {
   "max": Number,
   "mean": Number,
   "median": Number, 
   "min": Number,  
   "n": Number, 
   "q1": Number, 
   "q3": Number, 
   "q4": Number, 
   "stdDeviation": Number, 
   "sum": Number, 
   "total": Number, 
   "trimmedAverage": Number, 
   "trimmedPercentage": Number
}

    데이터 유형: 객체
    <배열>.performanceStats.max 기록이 경로를 완료하는 데 걸린 가장 긴 시간입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <배열>.performanceStats.mean 기록이 열린 시간부터 종결된 시간까지 기록이 경로를 완료하는 데 걸린 평균 시간입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <Array>.performanceStats.median 지속 시간 중간 값 또는 두 중간 값의 평균입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <배열>.performanceStats.min 기록이 경로를 완료하는 데 걸린 최단 시간입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <Array>.performanceStats.n 이 세부 항목의 일부인 기록 수입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <배열>.performanceStats.q1 기간 첫 번째 사분위수 값입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <배열>.performanceStats.q3 기간 세 번째 사분위수 값입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <배열>.performanceStats.q4 기간 4사분위수 값(최대값)

    데이터 유형: 숫자

    단위: 밀리초
    <배열>.performanceStats.stdDeviation 경로 기간 평균 값의 변형입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <Array>.performanceStats.sum 경로를 따르는 모든 기록에 대한 첫 번째 이벤트부터 마지막 이벤트까지의 모든 기간 시간의 합계입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <Array>.performanceStats.total 경로를 따르는 모든 기록에 대한 첫 번째 이벤트부터 마지막 이벤트까지의 모든 기간 시간의 합계입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <Array>.performanceStats.trimmedAverage 기록이 경로를 완료하는 데 걸린 평균 시간으로, 가장 작은 값과 가장 큰 값의 백분율을 제거한 후 계산됩니다.

    데이터 유형: 숫자

    단위: 밀리초
    <Array>.performanceStats.trimmedPercentage 값을 계산하는 데 사용되는 백분율입니다 trimmedAverage .

    데이터 유형: 숫자
    <배열>.tableName 세부 항목에 사용되는 테이블입니다.

    데이터 유형: 문자열
    <배열>.variantCount 이 세부 항목에 해당하는 변형(프로세스에서 수행되는 고유한 활동 시퀀스) 수입니다.

    데이터 유형: 숫자

    이 예시에서는 프로젝트에 대한 세부 항목 통계를 가져옵니다.

    SNC.ProcessMiningIntegrationAPI.getBreakDownStats("a4286c4f4f831210c98b8a4a91ce0bf5");

    출력:

    [
   {
      "fieldValue":"1",
      "field":"priority",
      "tableName":"incident",
      "variantCount":21,
      "caseCount":33,
      "performanceStats":{
         "sum":6.4945381E7,
         "min":0.0,
         "max":5.2334704E7,
         "n":33,
         "median":0.0,
         "mean":0.0,
         "total":64945381,
         "stdDeviation":9144841.0,
         "trimmedAverage":165594.0,
         "trimmedPercentage":-1.0,
         "q1":0.0,
         "q3":313333.0,
         "q4":5.2334704E7
      }
   }
]

    ProcessMiningIntegrationAPI - getFindings(문자열 projectId)

    프로세스 마이닝 프로젝트에 대한 결과를 가져옵니다.

    표 7. 매개변수
    이름 유형 설명
    projectId 문자열 프로젝트의 Sys_id입니다.

    테이블: 프로젝트 정의 [promin_project]
    표 8. 반환
    유형 설명
    배열 찾기 객체의 배열입니다.
    [
   {
      "caseIds":[],  
      "category": "String",
      "categoryDescription": "String",
      "categoryLabel": "String",
      "createdOn": Number, 
      "findingDefId": "String", 
      "id": "String",
      "impactedKpis": [],
      "matchingRecords": Number,
      "message": "String",
      "performanceStats": {},
      "shortMessage": "String",
      "tableName": "String",
      "totalRecords": Number,
      "type": "String",
      "typeLabel": "String",    
      "versionId": "String"  
   }
]
    <배열>.caseIds 찾기 패턴과 일치하는 케이스의 ID 목록입니다. 케이스 기록 [promin_case_record] 테이블의 케이스 ID 열에 있습니다.

    데이터 유형: 배열
    <배열>.category 찾은 결과의 범주입니다.
    가능한 값:
    • 자동화
    • COMPLIANCE
    • 규칙
    • 비용
    • 공연
    • 질
    • 속도

    데이터 유형: 문자열
    <배열>.categoryDescription 찾기 범주에 대한 설명입니다.

    데이터 유형: 문자열
    <배열>.categoryLabel 찾기 범주의 레이블입니다.

    데이터 유형: 문자열
    <배열>.createdOn 찾기의 생성 날짜입니다.

    데이터 유형: 숫자
    <배열>.findingDefId 찾기 정의의 Sys_id입니다.

    찾기 정의는 찾기 정의[promin_finding_def] 및 자동화된 찾기 정의[promin_automated_finding] 테이블에 있습니다.

    데이터 유형: 문자열
    <배열>.id 결과의 Sys_id입니다. 찾기 [promin_finding] 테이블에 있습니다.

    데이터 유형: 문자열
    <배열>.impactedKpis 결과의 영향을 받는 KPI sys_ids 목록입니다. 표시기 [pa_indicators] 테이블에 있습니다.

    데이터 유형: 배열
    <배열>.matchingRecords 찾기 패턴과 일치하는 케이스 기록 [promin_case_record] 테이블의 케이스 ID 수입니다.

    데이터 유형: 숫자
    <배열>.메시지 찾기 정의의 메시지입니다.

    데이터 유형: 문자열
    <배열>.performanceStats 찾은 결과에 대한 성과 통계입니다.
    {
   "max": Number,
   "mean": Number,
   "median": Number, 
   "min": Number,  
   "n": Number, 
   "q1": Number, 
   "q3": Number, 
   "q4": Number, 
   "stdDeviation": Number, 
   "sum": Number, 
   "total": Number, 
   "trimmedAverage": Number, 
   "trimmedPercentage": Number
}

    데이터 유형: 객체
    <배열>.performanceStats.max 기록이 경로를 완료하는 데 걸린 가장 긴 시간입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <배열>.performanceStats.mean 기록이 열린 시간부터 종결된 시간까지 기록이 경로를 완료하는 데 걸린 평균 시간입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <Array>.performanceStats.median 지속 시간 중간 값 또는 두 중간 값의 평균입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <배열>.performanceStats.min 기록이 경로를 완료하는 데 걸린 최단 시간입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <Array>.performanceStats.n 이 결과의 일부인 기록 수입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <배열>.performanceStats.q1 기간 첫 번째 사분위수 값입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <배열>.performanceStats.q3 기간 세 번째 사분위수 값입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <배열>.performanceStats.q4 기간 4사분위수 값(최대값)

    데이터 유형: 숫자

    단위: 밀리초
    <배열>.performanceStats.stdDeviation 경로 기간 평균 값의 변형입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <Array>.performanceStats.sum 경로를 따르는 모든 기록에 대한 첫 번째 이벤트부터 마지막 이벤트까지의 모든 기간 시간의 합계입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <Array>.performanceStats.total 경로를 따르는 모든 기록에 대한 첫 번째 이벤트부터 마지막 이벤트까지의 모든 기간 시간의 합계입니다.

    데이터 유형: 숫자

    단위: 밀리초
    <Array>.performanceStats.trimmedAverage 기록이 경로를 완료하는 데 걸린 평균 시간으로, 가장 작은 값과 가장 큰 값의 백분율을 제거한 후 계산됩니다.

    데이터 유형: 숫자

    단위: 밀리초
    <Array>.performanceStats.trimmedPercentage 값을 계산하는 데 사용되는 백분율입니다 trimmedAverage .

    데이터 유형: 숫자
    <배열>.shortMessage 찾기 정의의 짧은 메시지입니다.

    데이터 유형: 문자열
    <배열>.tableName 찾은 결과에 사용되는 테이블의 이름입니다.

    데이터 유형: 문자열
    <배열>.totalRecords 마이닝에서 분석된 총 기록 수입니다.

    데이터 유형: 숫자
    <배열>.type 찾기 정의의 유형입니다.
    가능한 값:
    • EXTRA_STEP
    • EXTREME_DURATION
    • EXTREME_REPETITION
    • 기타
    • 무늬
    • PERFORMANCE_OUTLIER
    • 핑퐁
    • 재작업

    자세한 내용은 Automated improvement opportunities 문서를 참조하십시오.
    <배열>.typeLabel 찾기 정의 유형의 레이블입니다.

    데이터 유형: 문자열
    <배열>.versionId 프로젝트 버전의 Sys_id입니다. 프로젝트 정의 버전 [promin_model_def_version] 테이블에 있습니다.

    데이터 유형: 문자열

    이 예제에서는 프로젝트에 대한 결과를 가져옵니다.

    SNC.ProcessMiningIntegrationAPI.getFindings("a4286c4f4f831210c98b8a4a91ce0bf5");

    출력:

    [
   {
      "message":"Rework on Closed",
      "id":"0ef09b2e1c6cf0d98045e6ba1c3c9edb",
      "type":"REWORK",
      "createdOn":1727036052.000000000,
      "category":"AUTOMATION",
      "tableName":"incident",
      "categoryLabel":"Automation",
      "matchingRecords":111,
      "versionId":"9a2f187177b412102f7a1b56ba5a99e2",
      "totalRecords":19758,
      "findingDefId":"791f587177b412102f7a1b56ba5a99eb",
      "categoryDescription":"Category that groups all opportunities that are subject to automation.",
      "impactedKpis":[
         
      ],
      "performanceStats":{
         "sum":2.09532828E8,
         "min":1.0,
         "max":6563078.0,
         "n":111,
         "median":1036715.0,
         "mean":1.0,
         "total":209532828,
         "stdDeviation":1855944.0,
         "trimmedAverage":1716904.0,
         "trimmedPercentage":-1.0,
         "q1":776859.0,
         "q3":2246368.0,
         "q4":6563078.0
      },
      "typeLabel":"Automation",
      "shortMessage":"Closed",
      "caseIds":[
         "119e4a569397fd14849bbcd74dba1018",
         "b16b355f47197190498cc044846d43b0",
         "cf9bca7597fe7d90ef889504a253af9e",
      ]
   }
]

    ProcessMiningIntegrationAPI - getMiningStatus(문자열 projectId)

    프로세스 마이닝 프로젝트의 마이닝 상태를 가져옵니다.

    표 9. 매개변수
    이름 유형 설명
    projectId 문자열 프로젝트의 Sys_id입니다.

    테이블: 프로젝트 정의 [promin_project]
    표 10. 반환
    유형 설명
    객체 프로젝트 sys_id 및 추적기를 포함하는 객체입니다. 
    {
   "projectId":"String",
   "trackerId":"String"  
}
    <Object>.projectId 프로젝트의 Sys_id입니다.

    테이블: 프로젝트 정의 [promin_project]

    데이터 유형: 문자열
    <Object>.trackerId 프로젝트의 마이닝 진행률을 모니터링하는 추적기의 Sys_id입니다.

    테이블: 실행 추적기 [sys_execution_tracker]

    데이터 유형: 문자열

    이 예시에서는 프로젝트의 마이닝 상태를 가져옵니다.

    SNC.ProcessMiningIntegrationAPI.getMiningStatus("c0b91f0cff01121047cae835f2cb14bc");

    출력:

    {
   "trackerId":"aec9530cff01121047cae835f2cb147e",
   "projectId":"c0b91f0cff01121047cae835f2cb14bc"
}

    ProcessMiningIntegrationAPI - getProject(문자열 projectId)

    프로세스 마이닝 프로젝트를 조회합니다.

    표 11. 매개변수
    이름 유형 설명
    projectId 문자열 프로젝트의 Sys_id입니다.

    테이블: 프로젝트 정의 [promin_project]
    표 12. 반환
    유형 설명
    객체 프로젝트에 대한 정보를 포함하는 객체입니다.
    {
   "entity": {Object},
   "findingDefinitionKPIMap": {Object},
   "id": "String",
   "lastMined": String",
   "miningState": "String",
   "name": "String",
   "permissions": [Array],
   "retiredDate": "String"
}
    <Object>.실체 프로젝트에서 분석된 데이터에 대한 정보를 포함하는 객체입니다.

    데이터 유형: 객체

    {
   "activityDefinitions": [Array],
   "breakdownDefinitions": [Array],
   "condition": "String,"
   "table": "String"
}
    <Object>.entity.activityDefinitions 프로젝트에 대한 활동 정의입니다.

    데이터 유형: 배열

    [
   {
      "activityOfInterest":Boolean,
      "field":"String",
      "type":"String"      
   }
]
    <Object>.entity.activityDefinitions.activityOfInterest

    분석가 워크벤치에 필드 변경 내용이 표시되는지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 분석가 워크벤치에 필드 변경 내용이 나타납니다.
    • false: 필드 변경 내용이 분석가 워크벤치에 표시되지 않지만 전환 또는 결과의 상황별 조건에서 계속 사용할 수 있습니다.
    <Object>.entity.activityDefinitions.field 분석할 데이터가 포함된 필드입니다. 필드는 매개변수에 지정된 테이블에서 가져와야 합니다 table .
    <Object>.entity.activityDefinitions.type 마이닝할 값의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 필드 값(기본값): 기본 선택 사항입니다. 이 옵션은 활동 정의를 생성할 때마다 사용할 수 있습니다.
    • 날짜 시간: 감사 이력이 아닌 실제 기록의 날짜 시간 값을 사용하며 프로세스 맵에 그룹화된 노드로 표시됩니다.
    • 복합: 감사 이력이 아닌 실제 기록에서 여러 필드 값의 변화를 나타내는 하나의 노드 또는 프로세스 그래프입니다.
    • 하위 첨부: 이 옵션은 테이블 구성을 위해 두 개의 테이블을 선택하고 하위-상위 관계를 설정한 경우에 사용할 수 있습니다. 이 옵션은 상위 테이블 구성에만 사용할 수 있습니다. 시각화에서는 하위 항목이 프로세스에서 연결된 시기를 확인할 수 있습니다.
    • 상위 첨부됨: 이 옵션은 상위 기록이 하위에 첨부된 시기를 나타내는 하위 프로세스에 노드를 생성합니다.
    <Object>.entity.breakdownDefinitions 프로젝트에 대한 세부 항목 정의입니다.

    데이터 유형: 배열

    [
 {
   "field":"String",
   "fieldLabel":"String"
 }
]
    <Object>.entity.breakdownDefinitions.field 세부 항목에 사용되는 필드의 이름입니다.

    데이터 유형: 문자열
    <Object>.entity.breakdownDefinitions.fieldLabel 세부 항목에 사용되는 필드의 레이블입니다.

    데이터 유형: 문자열
    <Object>.entity.condition 분석할 데이터를 선택하는 인코딩된 쿼리입니다.

    데이터 유형: 문자열
    <Object>.entity.table 분석할 데이터가 포함된 테이블의 이름입니다.

    데이터 유형: 문자열
    <Object>.findingDefinitionKPIMap 찾기 정의 및 KPI(핵심성과지표)의 맵으로, 여기서 키는 찾기 정의 sys_id이고 값은 찾기 정의의 영향을 받는 KPI sys_ids 배열입니다.

    찾기 정의는 찾기 정의[promin_finding_def] 및 자동화된 찾기 정의[promin_automated_finding] 테이블에 있습니다. KPI는 지표 [pa_indicators] 테이블에 있습니다.

    정의 및 KPI 찾기에 대한 자세한 내용은 해당 Viewing business insights문서를 Working with finding definitions 참조하십시오.

    데이터 유형: 객체

    {
   "<finding_def_sys_id":[
      "<kpi_sys_id>"
   ]
}
    <Object>.아이디 프로젝트의 Sys_id입니다.

    테이블: 프로젝트 정의 [promin_project]

    데이터 유형: 문자열
    <Object>.lastMined 프로젝트가 마지막으로 마이닝된 날짜입니다.

    데이터 유형: 문자열
    <Object>.miningState 프로젝트의 마이닝 상태입니다.

    마이닝 상태에 대한 설명은 문서를 참조하십시오 Mine states.

    데이터 유형: 문자열
    <Object>.이름 프로젝트의 이름입니다.

    데이터 유형: 문자열
    <Object>.권한을 프로젝트에 대한 그룹, 역할 및 사용자 권한입니다.

    데이터 유형: 객체

    [
   {
      "type":"String",
      "value":"String"      
   }
]
    <Object>.permissions.type 권한의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 그룹
    • role
    • 사용자

    데이터 유형: 문자열
    <Object>.permissions.value 권한을 부여할 그룹, 역할 또는 사용자의 Sys_id입니다.

    데이터 유형: 문자열
    <Object>.폐기날짜 프로젝트가 폐기되는 날짜입니다.

    데이터 유형: 문자열

    이 예에서는 프로세스 마이닝 프로젝트를 조회합니다.

    SNC.ProcessMiningIntegrationAPI.getProject("fa465748ff01121047cae835f2cb1473");

    출력:

    {
   "entity":{
      "table":"incident",
      "activityDefinitions":[
         {
            "field":"assignment_group",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"business_service",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"state",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"category",
            "type":"DEFAULT",
            "activityOfInterest":false
         },
         {
            "field":"priority",
            "type":"DEFAULT",
            "activityOfInterest":false
         }
      ],
      "condition":"",
      "breakdownDefinitions":[
         {
            "field":"contact_type",
            "fieldLabel":"Channel"
         },
         {
            "field":"close_code",
            "fieldLabel":"Resolution code"
         },
         {
            "field":"assignment_group",
            "fieldLabel":"Assignment group"
         },
         {
            "field":"location",
            "fieldLabel":"Location"
         },
         {
            "field":"priority",
            "fieldLabel":"Priority"
         },
         {
            "field":"category",
            "fieldLabel":"Category"
         }
      ]
   },
   "name":"Incident Process",
   "permissions":[
      {
         "value":"some_group_sys_id",
         "type":"group"
      },
      {
         "value":"some_role_sys_id",
         "type":"role"
      },
      {
         "value":"some_user_sys_id",
         "type":"user"
      }
   ],
   "id":"fa465748ff01121047cae835f2cb1473",
   "miningState":"NEW",
   "findingDefinitionKPIMap":{
      
   },
   "retiredDate":1728292672.622894000,
   "lastMined":null
}

    ProcessMiningIntegrationAPI - scheduleMining(String projectId)

    마이닝을 위한 프로세스 마이닝 프로젝트를 제출합니다.

    표 13. 매개변수
    이름 유형 설명
    projectId 문자열 프로젝트의 Sys_id입니다.

    테이블: 프로젝트 정의 [promin_project]
    표 14. 반환
    유형 설명
    객체 프로젝트 sys_id 및 추적기를 포함하는 객체입니다. 
    {
   "projectId":"String",
   "trackerId":"String"  
}
    <Object>.projectId 프로젝트의 Sys_id입니다.

    테이블: 프로젝트 정의 [promin_project]

    데이터 유형: 문자열
    <Object>.trackerId 프로젝트의 마이닝 진행률을 모니터링하는 추적기의 Sys_id입니다.

    테이블: 실행 추적기 [sys_execution_tracker]

    데이터 유형: 문자열

    이 예에서는 마이닝을 위한 프로젝트를 제출합니다.

    SNC.ProcessMiningIntegrationAPI.scheduleMining("c0b91f0cff01121047cae835f2cb14bc");

    출력:

    {
   "trackerId":"aec9530cff01121047cae835f2cb147e",
   "projectId":"c0b91f0cff01121047cae835f2cb14bc"
}