---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ProcessMiningIntegrationAPI - 범위 지정됨

# ProcessMiningIntegrationAPI - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 33분

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

이 스크립트 포함에는 프로세스 마이닝 플러그인(sn_po)이 필요합니다. 자세한 내용은 [Process Mining](https://www.servicenow.com/docs/access?context=process-mining&version=australia&pubname=australia-now-intelligence&ft:locale=en-US) 문서를 참조하십시오.

호출 사용자에게 sn_process_mining_analyst 또는 sn_process_mining_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_mining_analyst 역할 없이 사용자가 프로젝트를 마이닝할 수 있도록 허용합니다.기본값: false.

promin.api.auto_share_project_with_creator

:   프로젝트를 프로젝트 작성자와 자동으로 공유합니다.기본값: false.

## ProcessMiningIntegrationAPI - createProject(문자열 테이블, 배열 활동, 배열 세부 항목, 문자열 encodedQuery, 문자열 templateType, 객체 권한, 부울 autoRetire) {#ariaid-title2}

프로세스 마이닝 프로젝트를 작성합니다.
프로젝트는 프로세스 마이닝 작업의 청사진 역할을 합니다. 마이닝이 수행되는 프로세스와 마이닝하는 동안 고려되는 프로세스의 속성을 선택합니다.
{#ProcMinInt-createProj_S_O_O_S_S_O_B__table_xs3_lqs_kdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 테이블 | 문자열 | 분석할 데이터가 포함된 테이블의 이름입니다. |
| 활동 | 배열 | 프로젝트에 대한 활동 정의입니다. 활동 정의는 마이닝하는 동안 고려해야 할 프로세스의 속성입니다(예: 상태 또는 할당 그룹). 매개변수에 지정된 table 테이블의 열이어야 합니다. 프로젝트를 마이닝하려면 하나 이상의 활동 정의가 필요합니다. 활동 정의에 대한 자세한 내용은 다음 문서를 참조하십시오 [Set activity definitions](https://www.servicenow.com/docs/access?context=set-activity-def&version=australia&pubname=australia-now-intelligence&ft:locale=en-US). 주: 활동 정의는 매개변수에 templateType 지정된 프로젝트 템플릿에도 포함됩니다. 이 매개변수를 activities 사용하여 템플릿에 포함되지 않은 추가 활동을 지정합니다. ["<column_name>"] |
| 세부 항목 | 배열 | 프로젝트에 대한 세부 항목 정의입니다. 세부 항목 정의를 사용하면 기록을 필터링하고 우선순위 또는 비즈니스 범주와 같은 범주별로 프로세스 맵을 분석할 수 있습니다. 매개변수에 지정된 table 테이블의 열이어야 합니다. 프로젝트를 마이닝하는 데 세부 항목 정의가 필요하지 않습니다. 세부 항목 정의에 대한 자세한 내용은 다음 문서를 참조하십시오 [Set breakdown definitions](https://www.servicenow.com/docs/access?context=breakdown&version=australia&pubname=australia-now-intelligence&ft:locale=en-US). 주: 세부 항목 정의는 매개변수에 templateType 지정된 프로젝트 템플릿에도 포함됩니다. 이 매개변수를 breakdowns 사용하여 템플릿에 포함되지 않은 추가 세부 항목을 지정합니다. ["<column_name>"] |
| encodedQuery | 문자열 | 분석할 데이터를 선택하기 위한 인코딩된 쿼리입니다. 이렇게 하면 지정된 기간의 데이터만 선택하는 등의 방식으로 분석되는 데이터를 제한할 수 있습니다. 테이블의 모든 데이터를 포함하려면 빈 문자열을 전달할 수 있습니다. |
| templateType | 문자열 | 프로젝트에 사용할 템플릿의 유형입니다. 유효한 값은 다음과 같습니다. * 기본값 * 디지털 포트폴리오 관리 * 벤더 관리 * WFO {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_xgh_dzh_xdc} (WFO), 벤더 관리 또는 디지털 포트폴리오 관리의 일부 워크포스 최적화 가 아닌 프로젝트의 경우 기본값을 선택합니다. 예를 들어 퍼포먼스 분석 프로젝트를 생성하려면 기본값을 선택합니다. |
| 권한 | 객체 | 프로젝트를 공유할 그룹, 역할 및 사용자의 맵으로, 키가 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: 프로젝트가 자동으로 폐기되지 않습니다. {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_kq1_jck_xdc} 기본값: false |
[표 1. 매개변수]

{#ProcMinInt-createProj_S_O_O_S_S_O_B__table_xs3_lqs_kdc} {#ProcMinInt-createProj_S_O_O_S_S_O_B__id_x1l_krq_c2c__entry__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: 필드 변경 사항은 분석가 워크벤치에 나타나지 않지만 전환 또는 결과의 상황별 조건에서 계속 사용할 수 있습니다. {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_hds_v2k_xdc} |
| \<Object\>.entity.activityDefinitions.field | 분석할 데이터가 포함된 필드입니다. 필드는 매개변수에 table 지정된 테이블에서 가져와야 합니다. |
| \<Object\>.entity.activityDefinitions.type | 마이닝할 값의 유형입니다. 유효한 값은 다음과 같습니다. * 필드 값(기본값): 기본 선택 사항입니다. 이 옵션은 활동 정의를 생성할 때마다 사용할 수 있습니다. * 날짜/시간: 감사 이력이 아닌 실제 기록의 날짜 시간 값을 사용하며 프로세스 맵에 그룹화된 노드로 표시됩니다. * 복합: 감사 이력이 아닌 실제 기록에서 여러 필드 값의 변경을 나타내는 하나의 노드 또는 프로세스 그래프입니다. * 하위 첨부됨: 이 옵션은 테이블 구성에 대해 두 개의 테이블을 선택하고 하위-상위 관계를 설정한 경우에 사용할 수 있습니다. 이 옵션은 상위 테이블 구성에만 사용할 수 있습니다. 시각화에서 하위 항목이 프로세스에 첨부된 시기를 볼 수 있습니다. * 상위 첨부됨: 이 옵션은 상위 기록이 하위에 첨부된 시기를 나타내는 하위 프로세스에 노드를 생성합니다. {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_bjc_ffk_xdc} |
| \<Object\>.entity.breakdownDefinitions | 프로젝트에 대한 세부 항목 정의입니다. 데이터 유형: 배열 [ { "field":"String", "fieldLabel":"String" } ] |
| \<Object\>.entity.breakdownDefinitions.field | 세부 항목에 사용되는 필드의 이름입니다. 데이터 유형: 문자열 |
| \<Object\>.entity.breakdownDefinitions.fieldLabel | 세부 항목에 사용되는 필드의 레이블입니다. 데이터 유형: 문자열 |
| \<Object\>.엔터티.조건 | 분석할 데이터를 선택하기 위한 인코딩된 쿼리입니다. 데이터 유형: 문자열 |
| \<Object\>.엔터티.테이블 | 분석할 데이터가 포함된 테이블의 이름입니다. 데이터 유형: 문자열 |
| \<Object\>.findingDefinitionKPIMap | 개선 기회 및 KPI(핵심성과지표)의 맵입니다. 여기서 맵 키는 개선 기회 sys_id이고 값은 개선 기회의 영향을 받는 KPI sys_ids의 배열입니다. 개선 기회는 찾기 정의\[promin_finding_def\] 및 자동화된 찾기 정의\[promin_automated_finding\] 테이블에 있습니다. KPI는 표시기 \[pa_indicators\] 테이블에 있습니다. 개선 기회 및 KPI에 대한 자세한 내용은 해당 문서를 참조하십시오 [Setting improvement opportunities](https://www.servicenow.com/docs/access?context=working-with-imp-opp&version=australia&pubname=australia-now-intelligence&ft:locale=en-US)[Viewing business insights](https://www.servicenow.com/docs/access?context=view-business-findings&version=australia&pubname=australia-now-intelligence&ft:locale=en-US). 데이터 유형: 객체 { "<finding_def_sys_id":[ "<kpi_sys_id>" ] } |
| \<Object\>.id | 프로젝트의 Sys_id입니다. 테이블: 프로젝트 정의 \[promin_project\] 데이터 유형: 문자열 |
| \<Object\>.lastMined | 프로젝트가 마지막으로 마이닝된 날짜입니다. 데이터 유형: 문자열 |
| \<Object\>.miningState | 프로젝트의 마이닝 상태입니다. 마이닝 상태에 대한 설명은 다음 문서를 참조하십시오 [Mining states](https://www.servicenow.com/docs/access?context=generate-process-map&version=australia&pubname=australia-now-intelligence&section=extraction-states&ft:locale=en-US). 데이터 유형: 문자열 |
| \<Object\>.name | 프로젝트의 이름입니다. 데이터 유형: 문자열 |
| \<Object\>.권한 | 프로젝트에 대한 그룹, 역할 및 사용자 권한입니다. 데이터 유형: 객체 [ { "type":"String", "value":"String" } ] |
| \<Object\>.permissions.type | 권한의 유형입니다. 유효한 값은 다음과 같습니다. * 그룹 * role * 사용자 {#ProcMinInt-createProj_S_O_O_S_S_O_B__ul_unx_q1l_ydc} 데이터 유형: 문자열 |
| \<Object\>.권한.값 | 권한을 부여할 그룹, 역할 또는 사용자의 Sys_id입니다. 데이터 유형: 문자열 |
| \<Object\>.retiredDate | 프로젝트가 폐기될 날짜입니다. 데이터 유형: 문자열 |
[표 2. 반환]

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

    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(문자열 projectId) {#ariaid-title3}

프로세스 마이닝 프로젝트를 삭제합니다.
{#ProcMinInt-deleteProject_S__table_cfn_f5t_kdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| projectId | 문자열 | 프로젝트의 Sys_id입니다. 테이블: 프로젝트 정의 \[promin_project\] |
[표 3. 매개변수]

{#ProcMinInt-deleteProject_S__table_cfn_f5t_kdc} {#ProcMinInt-deleteProject_S__table_dfn_f5t_kdc__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 4. 반환]

{#ProcMinInt-deleteProject_S__table_dfn_f5t_kdc}  
이 예에서는 프로세스 마이닝 프로젝트를 삭제합니다.

    SNC.ProcessMiningIntegrationAPI.deleteProject("a4286c4f4f831210c98b8a4a91ce0bf5");

## ProcessMiningIntegrationAPI - getBreakDownStats(문자열 projectId) {#ariaid-title4}

프로세스 마이닝 프로젝트에 대한 세부 항목 통계를 가져옵니다.
세부 항목을 통해 기록을 필터링하고 우선순위 또는 비즈니스 범주와 같은 범주별로 프로세스를 분석할 수 있습니다.
{#ProcMinInt-getBreakDownStats_S__table_qqp_l5t_kdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| projectId | 문자열 | 프로젝트의 Sys_id입니다. 테이블: 프로젝트 정의 \[promin_project\] |
[표 5. 매개변수]

{#ProcMinInt-getBreakDownStats_S__table_qqp_l5t_kdc} {#ProcMinInt-getBreakDownStats_S__table_rqp_l5t_kdc__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | 세부 항목 객체의 배열입니다. 각 객체에는 세부 항목에 대한 통계가 포함되어 있습니다. [ { "caseCount": Number, "field": "String", "fieldValue": "String", "performanceStats": {Object}, "tableName": "String", "variantCount": Number } ] |
| \<배열\>.caseCount | 이 세부 항목의 일부인 케이스 기록 \[promin_case_record\] 테이블의 케이스 수입니다. 데이터 유형: 숫자 |
| \<배열\>.field | 세부 항목에 사용되는 필드입니다. 데이터 유형: 문자열 |
| \<배열\>.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 | 기록이 경로를 완료하는 데 걸린 최단 시간입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.n | 이 세부 항목의 일부인 기록 수입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.q1 | 기간 첫 번째 사분위수 값입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.q3 | 기간 3사분위수 값입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.q4 | 기간 4사분위수 값(최대값) 데이터 유형: 숫자 단위: 밀리초 |
| \<Array\>.performanceStats.stdDeviation | 경로 기간 평균 값의 차이입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.sum | 경로를 따르는 모든 기록에 대해 첫 번째부터 마지막 이벤트까지의 모든 기간 시간의 합계입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.total | 경로를 따르는 모든 기록에 대해 첫 번째부터 마지막 이벤트까지의 모든 기간 시간의 합계입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.trimmedAverage | 기록에서 경로를 완료하는 데 걸린 평균 시간으로, 가장 작은 값과 가장 큰 값의 백분율을 제거한 후 계산됩니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<Array\>.performanceStats.trimmedPercentage | 값을 계산하는 데 사용되는 백분율입니다.trimmedAverage 데이터 유형: 숫자 |
| \<배열\>.tableName | 세부 항목에 사용되는 테이블입니다. 데이터 유형: 문자열 |
| \<배열\>.variantCount | 이 세부 항목에 해당하는 변형(프로세스에서 수행되는 고유한 활동 시퀀스) 수입니다. 데이터 유형: 숫자 |
[표 6. 반환]

{#ProcMinInt-getBreakDownStats_S__table_rqp_l5t_kdc}  
이 예에서는 프로젝트에 대한 세부 항목 통계를 가져옵니다.

    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) {#ariaid-title5}

프로세스 마이닝 프로젝트에 대한 결과를 가져옵니다.
{#ProcMinInt-getFindings_S__table_syh_k5t_kdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| projectId | 문자열 | 프로젝트의 Sys_id입니다. 테이블: 프로젝트 정의 \[promin_project\] |
[표 7. 매개변수]

{#ProcMinInt-getFindings_S__table_syh_k5t_kdc} {#ProcMinInt-getFindings_S__table_tyh_k5t_kdc__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | 찾기 객체의 배열입니다. [ { "caseIds":[Array], "category": "String", "categoryDescription": "String", "categoryLabel": "String", "createdOn": Number, "findingDefId": "String", "id": "String", "impactedKpis": [Array], "matchingRecords": Number, "message": "String", "performanceStats": {Object}, "shortMessage": "String", "tableName": "String", "totalRecords": Number, "type": "String", "typeLabel": "String", "versionId": "String" } ] |
| \<배열\>.caseIds | 찾기 패턴과 일치하는 케이스의 ID 목록입니다. 케이스 기록 \[promin_case_record\] 테이블의 케이스 ID 열에 있습니다. 데이터 유형: 배열 |
| \<배열\>.범주 | 찾기의 범주입니다. 가능한 값: * 자동화 * COMPLIANCE * 적합성 * 비용 * 성능 * 품질 * 속도 {#ProcMinInt-getFindings_S__ul_u2f_1kq_c2c} 데이터 유형: 문자열 |
| \<배열\>.categoryDescription | 찾기 범주에 대한 설명입니다. 데이터 유형: 문자열 |
| \<배열\>.categoryLabel | 찾기 범주의 레이블입니다. 데이터 유형: 문자열 |
| \<Array\>.createdOn | 찾은 결과의 생성 날짜입니다. 데이터 유형: 숫자 |
| \<배열\>.findingDefId | 개선 기회의 Sys_id입니다. 개선 기회는 찾기 정의\[promin_finding_def\] 및 자동화된 찾기 정의\[promin_automated_finding\] 테이블에 있습니다. 데이터 유형: 문자열 |
| \<배열\>.id | 찾은 결과의 Sys_id입니다. 찾기 \[promin_finding\] 테이블에 있습니다. 데이터 유형: 문자열 |
| \<Array\>.impactedKpis | 결과의 영향을 받는 KPI sys_ids 목록입니다. 표시기 \[pa_indicators\] 테이블에 있습니다. 데이터 유형: 배열 |
| \<배열\>.matchingRecords | 찾기 패턴과 일치하는 케이스 기록 \[promin_case_record\] 테이블의 케이스 ID 수입니다. 데이터 유형: 숫자 |
| \<배열\>.message | 개선 기회의 메시지입니다. 데이터 유형: 문자열 |
| \<배열\>.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 | 기록이 경로를 완료하는 데 걸린 최단 시간입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.n | 이 결과의 일부인 기록 수입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.q1 | 기간 첫 번째 사분위수 값입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.q3 | 기간 3사분위수 값입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.q4 | 기간 4사분위수 값(최대값) 데이터 유형: 숫자 단위: 밀리초 |
| \<Array\>.performanceStats.stdDeviation | 경로 기간 평균 값의 차이입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.sum | 경로를 따르는 모든 기록에 대해 첫 번째부터 마지막 이벤트까지의 모든 기간 시간의 합계입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.total | 경로를 따르는 모든 기록에 대해 첫 번째부터 마지막 이벤트까지의 모든 기간 시간의 합계입니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<배열\>.performanceStats.trimmedAverage | 기록에서 경로를 완료하는 데 걸린 평균 시간으로, 가장 작은 값과 가장 큰 값의 백분율을 제거한 후 계산됩니다. 데이터 유형: 숫자 단위: 밀리초 |
| \<Array\>.performanceStats.trimmedPercentage | 값을 계산하는 데 사용되는 백분율입니다.trimmedAverage 데이터 유형: 숫자 |
| \<배열\>.shortMessage | 개선 기회의 짧은 메시지입니다. 데이터 유형: 문자열 |
| \<배열\>.tableName | 찾기에 사용되는 테이블의 이름입니다. 데이터 유형: 문자열 |
| \<배열\>.totalRecords | 마이닝에서 분석된 총 기록 수입니다. 데이터 유형: 숫자 |
| \<배열\>.type | 개선 기회의 유형입니다. 가능한 값: * EXTRA_STEP * EXTREME_DURATION * EXTREME_REPETITION * 기타 * 무늬 * PERFORMANCE_OUTLIER * 핑퐁 * 재작업 {#ProcMinInt-getFindings_S__ul_jzp_smq_c2c} 자세한 내용은 [Setting Automated improvement opportunities](https://www.servicenow.com/docs/access?context=automated-findings&version=australia&pubname=australia-now-intelligence&ft:locale=en-US) 문서를 참조하십시오. |
| \<배열\>.typeLabel | 개선 기회 유형의 레이블입니다. 데이터 유형: 문자열 |
| \<배열\>.versionId | 프로젝트 버전의 Sys_id입니다. 프로젝트 정의 버전 \[promin_model_def_version\] 테이블에 있습니다. 데이터 유형: 문자열 |
[표 8. 반환]

{#ProcMinInt-getFindings_S__table_tyh_k5t_kdc}  
이 예에서는 프로젝트에 대한 결과를 가져옵니다.

    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) {#ariaid-title6}

프로세스 마이닝 프로젝트의 마이닝 상태를 가져옵니다.
{#ProcMinInt-getMiningStatus_S__table_r12_j5t_kdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| projectId | 문자열 | 프로젝트의 Sys_id입니다. 테이블: 프로젝트 정의 \[promin_project\] |
[표 9. 매개변수]

{#ProcMinInt-getMiningStatus_S__table_r12_j5t_kdc} {#ProcMinInt-getMiningStatus_S__table_s12_j5t_kdc__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 프로젝트 sys_id와 추적기를 포함하는 객체입니다. { "projectId":"String", "trackerId":"String" } |
| \<Object\>.projectId | 프로젝트의 Sys_id입니다. 테이블: 프로젝트 정의 \[promin_project\] 데이터 유형: 문자열 |
| \<Object\>.trackerId | 프로젝트의 마이닝 진행률을 모니터링하는 추적기의 Sys_id입니다. 테이블: 실행 추적기 \[sys_execution_tracker\] 데이터 유형: 문자열 |
[표 10. 반환]

{#ProcMinInt-getMiningStatus_S__table_s12_j5t_kdc}  
이 예에서는 프로젝트의 마이닝 상태를 가져옵니다.

    SNC.ProcessMiningIntegrationAPI.getMiningStatus("c0b91f0cff01121047cae835f2cb14bc");

출력:

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

## ProcessMiningIntegrationAPI - getProject(문자열 projectId) {#ariaid-title7}

프로세스 마이닝 프로젝트를 검색합니다.
{#ProcMinInt-getProject_S__table_ik3_d5t_kdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| projectId | 문자열 | 프로젝트의 Sys_id입니다. 테이블: 프로젝트 정의 \[promin_project\] |
[표 11. 매개변수]

{#ProcMinInt-getProject_S__table_ik3_d5t_kdc} {#ProcMinInt-getProject_S__id_x1l_krq_c2c__entry__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: 필드 변경 사항은 분석가 워크벤치에 나타나지 않지만 전환 또는 결과의 상황별 조건에서 계속 사용할 수 있습니다. {#ProcMinInt-getProject_S__ul_hds_v2k_xdc} |
| \<Object\>.entity.activityDefinitions.field | 분석할 데이터가 포함된 필드입니다. 필드는 매개변수에 table 지정된 테이블에서 가져와야 합니다. |
| \<Object\>.entity.activityDefinitions.type | 마이닝할 값의 유형입니다. 유효한 값은 다음과 같습니다. * 필드 값(기본값): 기본 선택 사항입니다. 이 옵션은 활동 정의를 생성할 때마다 사용할 수 있습니다. * 날짜/시간: 감사 이력이 아닌 실제 기록의 날짜 시간 값을 사용하며 프로세스 맵에 그룹화된 노드로 표시됩니다. * 복합: 감사 이력이 아닌 실제 기록에서 여러 필드 값의 변경을 나타내는 하나의 노드 또는 프로세스 그래프입니다. * 하위 첨부됨: 이 옵션은 테이블 구성에 대해 두 개의 테이블을 선택하고 하위-상위 관계를 설정한 경우에 사용할 수 있습니다. 이 옵션은 상위 테이블 구성에만 사용할 수 있습니다. 시각화에서 하위 항목이 프로세스에 첨부된 시기를 볼 수 있습니다. * 상위 첨부됨: 이 옵션은 상위 기록이 하위에 첨부된 시기를 나타내는 하위 프로세스에 노드를 생성합니다. {#ProcMinInt-getProject_S__ul_bjc_ffk_xdc} |
| \<Object\>.entity.breakdownDefinitions | 프로젝트에 대한 세부 항목 정의입니다. 데이터 유형: 배열 [ { "field":"String", "fieldLabel":"String" } ] |
| \<Object\>.entity.breakdownDefinitions.field | 세부 항목에 사용되는 필드의 이름입니다. 데이터 유형: 문자열 |
| \<Object\>.entity.breakdownDefinitions.fieldLabel | 세부 항목에 사용되는 필드의 레이블입니다. 데이터 유형: 문자열 |
| \<Object\>.엔터티.조건 | 분석할 데이터를 선택하기 위한 인코딩된 쿼리입니다. 데이터 유형: 문자열 |
| \<Object\>.엔터티.테이블 | 분석할 데이터가 포함된 테이블의 이름입니다. 데이터 유형: 문자열 |
| \<Object\>.findingDefinitionKPIMap | 개선 기회 및 KPI(핵심성과지표)의 맵입니다. 여기서 맵 키는 개선 기회 sys_id이고 값은 개선 기회의 영향을 받는 KPI sys_ids의 배열입니다. 개선 기회는 찾기 정의\[promin_finding_def\] 및 자동화된 찾기 정의\[promin_automated_finding\] 테이블에 있습니다. KPI는 표시기 \[pa_indicators\] 테이블에 있습니다. 개선 기회 및 KPI에 대한 자세한 내용은 해당 문서를 참조하십시오 [Setting improvement opportunities](https://www.servicenow.com/docs/access?context=working-with-imp-opp&version=australia&pubname=australia-now-intelligence&ft:locale=en-US)[Viewing business insights](https://www.servicenow.com/docs/access?context=view-business-findings&version=australia&pubname=australia-now-intelligence&ft:locale=en-US). 데이터 유형: 객체 { "<finding_def_sys_id":[ "<kpi_sys_id>" ] } |
| \<Object\>.id | 프로젝트의 Sys_id입니다. 테이블: 프로젝트 정의 \[promin_project\] 데이터 유형: 문자열 |
| \<Object\>.lastMined | 프로젝트가 마지막으로 마이닝된 날짜입니다. 데이터 유형: 문자열 |
| \<Object\>.miningState | 프로젝트의 마이닝 상태입니다. 마이닝 상태에 대한 설명은 다음 문서를 참조하십시오 [Mining states](https://www.servicenow.com/docs/access?context=generate-process-map&version=australia&pubname=australia-now-intelligence&section=extraction-states&ft:locale=en-US). 데이터 유형: 문자열 |
| \<Object\>.name | 프로젝트의 이름입니다. 데이터 유형: 문자열 |
| \<Object\>.권한 | 프로젝트에 대한 그룹, 역할 및 사용자 권한입니다. 데이터 유형: 객체 [ { "type":"String", "value":"String" } ] |
| \<Object\>.permissions.type | 권한의 유형입니다. 유효한 값은 다음과 같습니다. * 그룹 * role * 사용자 {#ProcMinInt-getProject_S__ul_unx_q1l_ydc} 데이터 유형: 문자열 |
| \<Object\>.권한.값 | 권한을 부여할 그룹, 역할 또는 사용자의 Sys_id입니다. 데이터 유형: 문자열 |
| \<Object\>.retiredDate | 프로젝트가 폐기될 날짜입니다. 데이터 유형: 문자열 |
[표 12. 반환]

{#ProcMinInt-getProject_S__id_x1l_krq_c2c}  
이 예제에서는 프로세스 마이닝 프로젝트를 검색합니다.

    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(문자열 projectId) {#ariaid-title8}

마이닝을 위한 프로세스 마이닝 프로젝트를 제출합니다.
{#ProcMinInt-scheduleMining_S__table_yyx_h5t_kdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| projectId | 문자열 | 프로젝트의 Sys_id입니다. 테이블: 프로젝트 정의 \[promin_project\] |
[표 13. 매개변수]

{#ProcMinInt-scheduleMining_S__table_yyx_h5t_kdc} {#ProcMinInt-scheduleMining_S__table_s12_j5t_kdc__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 프로젝트 sys_id와 추적기를 포함하는 객체입니다. { "projectId":"String", "trackerId":"String" } |
| \<Object\>.projectId | 프로젝트의 Sys_id입니다. 테이블: 프로젝트 정의 \[promin_project\] 데이터 유형: 문자열 |
| \<Object\>.trackerId | 프로젝트의 마이닝 진행률을 모니터링하는 추적기의 Sys_id입니다. 테이블: 실행 추적기 \[sys_execution_tracker\] 데이터 유형: 문자열 |
[표 14. 반환]

{#ProcMinInt-scheduleMining_S__table_s12_j5t_kdc}  
이 예제에서는 마이닝을 위해 프로젝트를 제출합니다.

    SNC.ProcessMiningIntegrationAPI.scheduleMining("c0b91f0cff01121047cae835f2cb14bc");

출력:

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