BMC Helix Remedyforce

통합 버전: 11.0

사용 사례

  1. 인시던트 수집 실행
  2. 트리아지 작업 실행 (레코드 업데이트/생성/삭제)

OAuth 인증을 구성하는 방법

사용자 이름 + 비밀번호를 사용하는 기본 인증 방법이 작동하지 않는 경우가 있습니다. 계정에 MFA가 사용 설정된 경우 이러한 문제가 발생할 수 있습니다. 이러한 상황에서는 OAuth 인증을 구성해야 합니다.

단계:

  1. 설정 -> 앱 관리자로 이동합니다.
  2. 'New Connected App'(새 연결된 앱) 버튼을 누릅니다.
  3. '연결된 앱 이름', 'API 이름', '연락처 이메일'을 입력합니다.
  4. 'OAuth 설정 사용'이 true로 설정되어야 합니다.
  5. '콜백 URL'을 'https://localhost'로 설정합니다.
  6. 'full' 및 'refresh_token' 범위 추가 API에 액세스하려면 두 가지 모두 필요합니다.
  7. 앱을 저장합니다.
  8. 앱 구성을 열고 '고객 키'와 '고객 보안 비밀'을 복사합니다. 통합 구성에서 '고객 키'는 '클라이언트 ID'이고 '고객 보안 비밀'은 클라이언트 보안 비밀입니다.
  9. 'OAuth 승인 코드 가져오기' 작업으로 이동합니다. '리디렉션 URL'이 '콜백 URL'입니다.
  10. 작업을 실행합니다. JSON 결과에 승인 URL이 표시됩니다. 브라우저에 복사하여 붙여넣어야 합니다. 결국 리디렉션되고 URL은 다음과 같이 표시됩니다. 'https://localhost/?code=aPrxyeILZDvX2Hhmz2gymvtuE4aow6hMnAKw_98FyXJvaN7l69bJZFr1z.ylZ3qXd0KZlXjn0g%3D%3D' 'code=' 뒤에 있는 모든 항목을 복사하고 URL 디코딩을 실행해야 합니다. %3D는 '=' 문자입니다.
  11. 'OAuth 갱신 토큰 가져오기' 작업으로 이동합니다. '리디렉션 URL'은 '콜백 URL'이고 '승인 코드'는 이전 요청의 '코드'입니다.
  12. 모든 작업을 올바르게 완료했다면 JSON 결과에 'refresh_token'이 표시됩니다.
  13. 이 갱신 토큰을 통합 구성에 복사하고 테스트 실행을 실행합니다.

Google Security Operations에서 BMC Helix Remedyforce 통합 구성

Google SecOps에서 통합을 구성하는 방법에 대한 자세한 내용은 통합 구성을 참고하세요.

통합 매개변수

다음 매개변수를 사용하여 통합을 구성합니다.

매개변수 표시 이름 유형 기본값 필수 항목 설명
API 루트 문자열 https://.my.salesforce.com 예 BMC Helix Remedyforce 인스턴스의 API 루트입니다.
사용자 이름 문자열 해당 사항 없음 아니요 BMC Helix Remedyforce 사용자 이름입니다.
비밀번호 비밀번호 해당 사항 없음 아니요 BMC Helix Remedyforce 비밀번호입니다.
클라이언트 ID 문자열 해당 사항 없음 아니요 연결된 앱의 BMC Helix Remedyforce 클라이언트 ID입니다. 이 매개변수는 OAuth 인증에 필요합니다. 참고: 이 매개변수는 사용자 이름 + 비밀번호 인증보다 우선합니다.
클라이언트 보안 비밀번호 비밀번호 해당 사항 없음 아니요 연결된 앱의 BMC Helix Remedyforce 클라이언트 보안 비밀번호입니다. 이 매개변수는 OAuth 인증에 필요합니다. 참고: 이 매개변수는 사용자 이름 + 비밀번호 인증보다 우선합니다.
갱신 토큰 비밀번호 해당 사항 없음 아니요 OAuth 승인의 갱신 토큰입니다.
SSL 확인 체크박스 선택 예 사용 설정하면 BMC Helix Remedyforce 서버 연결에 사용되는 SSL 인증서가 유효한지 확인합니다.
로그인 API 루트 문자열 https://login.salesforce.com 예 BMC Helix Remedyforce에서 인증하는 데 사용되는 API 루트입니다.

작업

Create Record

설명

BMC Helix Remedyforce에서 레코드를 만듭니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
레코드 유형 문자열 해당 사항 없음 예 만들어야 하는 레코드의 유형을 지정합니다. 사용 가능한 레코드 유형을 모르는 경우 '레코드 유형 나열' 작업을 실행하세요.
레코드 페이로드 JSON

{

"field":"value"

}

 예 필요한 모든 필드와 값이 포함된 JSON 객체를 지정합니다.

실행

작업이 항목에서 실행되지 않거나 필수 입력 매개변수가 없습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
JSON 결과
{
    "id": "0015e000005dVbKAAU",
    "success": true,
    "errors": []
}
케이스 월
결과 유형 값/설명 유형(항목 \ 일반)
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.
201인 경우 (is_success = true): 'BMC Helix Remedyforce에서 {레코드 유형} 레코드를 만들었습니다.'

작업이 실패하고 플레이북 실행을 중지해야 합니다.
잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 발생한 경우: '레코드 만들기' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

400인 경우: ''레코드 만들기' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {message}

레코드 유형을 찾을 수 없는 경우: '레코드 만들기' 작업을 실행하는 동안 오류가 발생했습니다. 이유: BMC Helix Remedyforce에 {레코드 유형}이 없습니다. 사용 가능한 레코드 유형 목록을 가져오려면 '레코드 유형 나열' 작업을 사용하세요.

잘못된 JSON 페이로드인 경우: "Error executing action "Create Record". 이유: '레코드 페이로드' 매개변수에 잘못된 JSON 페이로드가 제공되었습니다. 구조를 확인하세요.

 일반

기록 삭제

설명

BMC Helix Remedyforce에서 레코드를 삭제합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
레코드 유형 문자열 해당 사항 없음 예 삭제해야 하는 레코드 유형을 지정합니다. 사용 가능한 레코드 유형을 모르는 경우 '레코드 유형 나열' 작업을 실행하세요.
레코드 ID 문자열 해당 사항 없음 예 삭제해야 하는 레코드의 ID를 지정합니다.

실행

작업이 항목에서 실행되지 않거나 필수 입력 매개변수가 없습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
케이스 월
결과 유형 값/설명 유형(항목 \ 일반)
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.
204인 경우 (is_success = true): 'BMC Helix Remedyforce에서 ID가 {record id}인 {Record Type} 레코드를 삭제했습니다.

404인 경우 (is_success=true): 'ID가 {record id}인 {Record Type} 레코드가 BMC Helix Remedyforce에 없습니다.

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류의 경우: ''레코드 삭제' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

레코드 유형을 찾을 수 없는 경우: '레코드 삭제' 작업을 실행하는 동안 오류가 발생했습니다. 이유: BMC Helix Remedyforce에 {레코드 유형}이 없습니다. 사용 가능한 레코드 유형 목록을 가져오려면 '레코드 유형 나열' 작업을 사용하세요.

 일반

맞춤 쿼리 실행

설명

BMC Helix Remedyforce에서 맞춤 SOQL 쿼리를 실행합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
SOQL 쿼리 문자열 해당 사항 없음 예 실행할 쿼리를 지정합니다.

실행

작업이 항목에서 실행되지 않거나 필수 입력 매개변수가 없습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
JSON 결과
{
    "attributes": {
        "type": "BMCServiceDesk__Incident__c",
        "url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
    },
    "Id": "a2U5e000000kl6NEAQ",
    "OwnerId": "00G5e000001mqf7EAA",
    "IsDeleted": false,
    "Name": "00000002",
    "CreatedDate": "2021-05-10T19:00:26.000+0000",
    "CreatedById": "0055e000001zFloAAE",
    "LastModifiedDate": "2021-05-10T19:00:26.000+0000",
    "LastModifiedById": "0055e000001zFloAAE",
    "SystemModstamp": "2021-05-10T19:00:26.000+0000",
    "LastActivityDate": null,
    "LastViewedDate": "2021-05-14T10:26:38.000+0000",
    "LastReferencedDate": "2021-05-14T10:26:38.000+0000",
    "BMCServiceDesk__ACApprovalStatus__c": null,
    "BMCServiceDesk__ACSeverity__c": null,
    "BMCServiceDesk__Actual_Outage_Time_Hours__c": 0.0,
    "BMCServiceDesk__Additional_email_information__c": null,
    "BMCServiceDesk__AllTaskCloseController__c": false,
    "BMCServiceDesk__Approved__c": false,
    "BMCServiceDesk__BLANK__c": null,
    "BMCServiceDesk__Category_ID__c": "Hardware",
    "BMCServiceDesk__RecurringParentRecordId__c": null,
    "BMCServiceDesk__RequestDetailCloneId__c": null,
    "BMCServiceDesk__VIP_Client__c": "-",
    "BMCServiceDesk__WorkflowController__c": null,
    "BMCServiceDesk__actualDuration__c": null,
    "BMCServiceDesk__actualOutageDuration__c": null,
    "BMCServiceDesk__call__c": 1.0,
    "BMCServiceDesk__clientEmail__c": "bmcremedyforcetrial@example.com",
    "BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
    "BMCServiceDesk__RF_TimeToClose__c": null,
    "BMCServiceDesk__RF_FKLayout__c": null,
    "BMCServiceDesk__RF_LTEC__c": null,
    "BMCServiceDesk__RF_SkipTriggerExecution__c": false,
    "BMCServiceDesk__Categorization_Mode__c": null,
    "BMCServiceDesk__RF_Attachments__c": null,
    "BMCServiceDesk__RF_HasAttachments__c": null,
    "BMCServiceDesk__RF_IntegrationData__c": null
}
케이스 월
결과 유형 값/설명 유형(항목 \ 일반)
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.
하나 이상 발견된 경우 (is_success = true): 'BMC Helix Remedyforce에서 '{query}' 쿼리의 결과를 반환했습니다.

검색된 항목이 없는 경우(is_success=true): 'BMC Helix Remedyforce에서 '{query}' 쿼리에 대한 결과를 찾을 수 없습니다.'

작업이 실패하고 플레이북 실행을 중지해야 합니다.
잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 발생한 경우: '맞춤 쿼리 실행' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

 일반
케이스 월 이름: 결과 일반

간단한 쿼리 실행

설명

BMC Helix Remedyforce의 매개변수를 기반으로 SOQL 쿼리를 실행합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
레코드 유형 문자열 해당 사항 없음 예 쿼리할 레코드 유형을 지정합니다.
Where 필터 문자열 해당 사항 없음 아니요 실행해야 하는 쿼리의 WHERE 필터를 지정합니다. 참고: 시간 필터, 제한, 정렬을 제공할 필요가 없습니다. 또한 페이로드에 WHERE 문자열을 제공할 필요가 없습니다.
기간 DDL

지난 1시간

가능한 값은 다음과 같습니다.

지난 1시간

지난 6시간

지난 24시간

지난주

지난달

커스텀

 No 결과 기간을 지정합니다. '맞춤'을 선택한 경우 '시작 시간'도 제공해야 합니다.
시작 시간 문자열 해당 사항 없음 No 결과 시작 시간을 지정합니다. '기간' 매개변수에 '커스텀'을 선택한 경우 이 매개변수는 필수 항목입니다. 형식: ISO 8601
종료 시간 문자열 해당 사항 없음 No 결과 종료 시간을 지정합니다. 형식: ISO 8601. 아무것도 제공하지 않고 '기간' 매개변수에 '커스텀'을 선택하면 이 매개변수는 현재 시간을 사용합니다.
반환할 필드 CSV 해당 사항 없음 아니요 반환할 필드를 지정합니다. 아무것도 제공되지 않으면 작업에서 모든 필드를 반환합니다.
필드 정렬 문자열 CreatedDate 아니요 정렬에 사용해야 하는 매개변수를 지정합니다.
정렬 순서 DDL

ASC

가능한 값은 다음과 같습니다.

ASC

DESC

 No 정렬 순서를 지정합니다.
반환할 최대 결과 수 정수 50 아니요 반환할 결과 수를 지정합니다. 기본값: 50 최댓값은 200입니다.

실행

작업이 항목에서 실행되지 않거나 필수 입력 매개변수가 없습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
JSON 결과
{
    "attributes": {
        "type": "BMCServiceDesk__Incident__c",
        "url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
    },
    "Id": "a2U5e000000kl6NEAQ",
    "OwnerId": "00G5e000001mqf7EAA",
    "IsDeleted": false,
    "Name": "00000002",
    "CreatedDate": "2021-05-10T19:00:26.000+0000",
    "CreatedById": "0055e000001zFloAAE",
    "LastModifiedDate": "2021-05-10T19:00:26.000+0000",
    "LastModifiedById": "0055e000001zFloAAE",
    "SystemModstamp": "2021-05-10T19:00:26.000+0000",
    "LastActivityDate": null,
    "LastViewedDate": "2021-05-14T10:26:38.000+0000",
    "LastReferencedDate": "2021-05-14T10:26:38.000+0000",
    "BMCServiceDesk__ACApprovalStatus__c": null,
    "BMCServiceDesk__ACSeverity__c": null,
    "BMCServiceDesk__Actual_Outage_Time_Hours__c": 0.0,
    "BMCServiceDesk__Additional_email_information__c": null,
    "BMCServiceDesk__AllTaskCloseController__c": false,
    "BMCServiceDesk__Approved__c": false,
    "BMCServiceDesk__BLANK__c": null,
    "BMCServiceDesk__Category_ID__c": "Hardware",
    "BMCServiceDesk__RecurringParentRecordId__c": null,
    "BMCServiceDesk__RequestDetailCloneId__c": null,
    "BMCServiceDesk__VIP_Client__c": "-",
    "BMCServiceDesk__WorkflowController__c": null,
    "BMCServiceDesk__actualDuration__c": null,
    "BMCServiceDesk__actualOutageDuration__c": null,
    "BMCServiceDesk__call__c": 1.0,
    "BMCServiceDesk__clientEmail__c": "bmcremedyforcetrial@example.com",
    "BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
    "BMCServiceDesk__RF_TimeToClose__c": null,
    "BMCServiceDesk__RF_FKLayout__c": null,
    "BMCServiceDesk__RF_LTEC__c": null,
    "BMCServiceDesk__RF_SkipTriggerExecution__c": false,
    "BMCServiceDesk__Categorization_Mode__c": null,
    "BMCServiceDesk__RF_Attachments__c": null,
    "BMCServiceDesk__RF_HasAttachments__c": null,
    "BMCServiceDesk__RF_IntegrationData__c": null
}
케이스 월
결과 유형 값/설명 유형(항목 \ 일반)
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.
하나 이상 발견된 경우 (is_success = true): 'BMC Helix Remedyforce에서 '{query}' 쿼리의 결과를 반환했습니다.

검색된 항목이 없는 경우(is_success=true): 'BMC Helix Remedyforce에서 '{query}' 쿼리에 대한 결과를 찾을 수 없습니다.'

작업이 실패하고 플레이북 실행을 중지해야 합니다.
잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 발생한 경우: '간단한 쿼리 실행' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

 일반
케이스 월 이름: 결과 일반

레코드 세부정보 가져오기

설명

BMC Helix Remedyforce에서 레코드에 관한 자세한 정보를 가져옵니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
레코드 유형 문자열 해당 사항 없음 예 세부정보를 가져올 레코드 유형을 지정합니다. 사용 가능한 레코드 유형을 모르는 경우 '레코드 유형 나열' 작업을 실행하세요.
레코드 ID CSV 해당 사항 없음 예 세부정보를 반환할 레코드의 ID를 지정합니다.
반환할 필드 CSV 해당 사항 없음 아니요 반환할 필드를 지정합니다. 제공된 필드가 하나도 없으면 작업이 실패합니다. 아무것도 제공되지 않으면 작업에서 모든 필드를 반환합니다.

실행

작업이 항목에서 실행되지 않거나 필수 입력 매개변수가 없습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
JSON 결과
{
    "attributes": {
        "type": "BMCServiceDesk__Incident__c",
        "url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
    },
    "Id": "a2U5e000000kl6NEAQ",
    "OwnerId": "00G5e000001mqf7EAA",
    "IsDeleted": false,
    "Name": "00000002",
    "CreatedDate": "2021-05-10T19:00:26.000+0000",
    "CreatedById": "0055e000001zFloAAE",
    "LastModifiedDate": "2021-05-10T19:00:26.000+0000",
    "LastModifiedById": "0055e000001zFloAAE",
    "BMCServiceDesk__Total_Duration__c": 0.0,
    "BMCServiceDesk__Incorrect_category__c": false,
    "Client_VIP__c": false,
    "BMCServiceDesk__Incorrect_owner__c": false,
    "BMCServiceDesk__LockedRecordTimestamp__c": null,
    "BMCServiceDesk__Queue__c": "Incident Queue",
    "BMCServiceDesk__Reassigned_Count__c": null,
    "BMCServiceDesk__isServiceRequest__c": false,
    "BMCServiceDesk__Approval_Status__c": null,
    "Alternate_Contact_Name__c": null,
    "Alternate_Contact_Number__c": null,
    "Client_Phone__c": null,
    "External_Ticket_Ref__c": null,
    "Affected_Application__c": null,
    "Affected_Hardware__c": null,
    "BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
    "BMCServiceDesk__RF_TimeToClose__c": null,
    "BMCServiceDesk__RF_FKLayout__c": null,
    "BMCServiceDesk__RF_LTEC__c": null,
    "BMCServiceDesk__RF_SkipTriggerExecution__c": false,
    "BMCServiceDesk__Categorization_Mode__c": null,
    "BMCServiceDesk__RF_Attachments__c": null,
    "BMCServiceDesk__RF_HasAttachments__c": null,
    "BMCServiceDesk__RF_IntegrationData__c": null
}
케이스 월
결과 유형 값/설명 유형(항목 \ 일반)
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.
하나 이상의 ID에 데이터를 사용할 수 있는 경우(is_success = true): '다음 ID의 레코드 유형 {Record Type}에 관한 세부정보를 가져왔습니다: {record ids}'.

하나 이상의 ID에 데이터를 사용할 수 없는 경우 (is_success=true): '작업이 다음 ID에 대한 레코드 유형 {Record Type}의 세부정보를 찾을 수 없습니다: {record ids}'

모두에 대해 데이터를 사용할 수 없는 경우 (is_success=false): 레코드를 찾을 수 없습니다.

작업이 실패하고 플레이북 실행을 중지해야 합니다.
잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 발생한 경우: '레코드 세부정보 가져오기' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

레코드 유형을 찾을 수 없는 경우: '레코드 세부정보 가져오기' 작업을 실행하는 동안 오류가 발생했습니다. 이유: BMC Helix Remedyforce에 {레코드 유형}이 없습니다. 사용 가능한 레코드 유형 목록을 가져오려면 '레코드 유형 나열' 작업을 사용하세요.

'반환할 필드'에 제공된 필드가 없는 경우: ''레코드 세부정보 가져오기' 작업을 실행하는 중에 오류가 발생했습니다. 이유: 제공된 필드를 찾을 수 없습니다. 맞춤법을 확인하세요.''

 일반
케이스 월 테이블

이름: Record {record Id}Details

열:

키

값

 일반

OAuth 승인 코드 가져오기

설명

BMC Helix Remedyforce에서 OAuth 승인 코드를 생성합니다. 자세한 내용은 문서 포털을 참조하세요.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
리디렉션 URL 문자열 https://localhost 예 '커넥터 앱'을 만들 때 사용한 리디렉션 URL을 지정합니다.

실행

작업이 항목에서 실행되지 않거나 필수 입력 매개변수가 없습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
케이스 월
결과 유형 값/설명 유형(항목 \ 일반)
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

'BMC Helix Remedyforce에서 승인 코드 URL이 생성되었습니다. 복사하여 브라우저에 붙여넣으세요. 그런 다음 URL에서 '코드' 부분을 복사합니다. 이 승인 코드는 'OAuth 갱신 토큰 가져오기' 작업에 사용됩니다.

 일반
링크

이름: 승인 코드 링크
URL: {generated link}

OAuth 갱신 토큰 가져오기

설명

통합 구성에 필요한 갱신 토큰을 생성합니다. 'OAuth 승인 코드 가져오기'를 사용하여 승인 코드를 생성할 수 있습니다. 자세한 내용은 문서 포털을 참고하세요.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
리디렉션 URL 문자열 https://localhost 예 '커넥터 앱'을 만들 때 사용한 리디렉션 URL을 지정합니다.
승인 코드 문자열 해당 사항 없음 예 'OAuth 승인 코드 가져오기' 작업의 승인 코드를 지정합니다.

실행

작업이 항목에서 실행되지 않거나 필수 입력 매개변수가 없습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
JSON 결과
{
    "access_token": "00D090000083B1p!ARkAQHJhzO.oDwNuldyoWlNDlLV9805VyWlZmcBvMF7qetVGpQWXi6pND0riSCiFs4fnrxmuVjBv.Io..ooN_JAIlGdGT_Gk",
    "signature": "6+xAwCccuYI0ivDbXtZzlguynNuKGRHaj+HpyZXM6ms=",
    "scope": "refresh_token api full",
    "instance_url": "https://202107220535170700.my.salesforce.com",
    "id": "https://login.salesforce.com/id/00D090000083B1pEAE/00509000007hMVJAA2",
    "token_type": "Bearer",
    "issued_at": "1626958668640"
}
케이스 월
결과 유형 값/설명 유형(항목 \ 일반)
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않아야 합니다.
200인 경우 (is_success = true): 'BMC Helix Remedyforce에서 갱신 토큰을 생성했습니다.'

작업이 실패하고 플레이북 실행을 중지해야 합니다.
잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 발생한 경우: ''OAuth 갱신 토큰 가져오기' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

상태 코드가 200이 아닌 경우: ''OAuth 갱신 토큰 가져오기' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error_description)

 일반

레코드 유형 나열

설명

BMC Helix Remedyforce에서 사용 가능한 레코드 유형을 나열합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
필터 로직 DDL

같음

DDL

같음

포함

 아니요 적용할 필터 로직을 지정합니다.
필터 값 문자열 해당 사항 없음 아니요 필터에 사용할 값을 지정합니다. '같음'을 선택하면 작업에서 레코드 유형 중에서 정확히 일치하는 항목을 찾으려고 시도하고 '포함'을 선택하면 해당 하위 문자열을 포함하는 레코드 유형을 찾으려고 시도합니다. 이 매개변수에 아무것도 제공되지 않으면 필터가 적용되지 않습니다.
반환할 최대 레코드 유형 수 정수 50 아니요 반환할 레코드 유형 수를 지정합니다.

실행

작업이 항목에서 실행되지 않거나 필수 입력 매개변수가 없습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
케이스 월
결과 유형 값/설명 유형(항목 \ 일반)
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.
하나 이상 찾은 경우 (is_success = true): 'BMC Helix Remedyforce에서 제공된 기준에 따라 사용 가능한 레코드 유형을 나열했습니다.

아무것도 찾을 수 없는 경우(is_success=true): 'BMC Helix Remedyforce에서 제공된 기준에 따라 레코드 유형을 찾을 수 없습니다.'

작업이 실패하고 플레이북 실행을 중지해야 합니다.
잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 발생한 경우: ''레코드 유형 나열' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

 일반
케이스 월

이름: 사용 가능한 레코드 유형

열:

이름

라벨

커스텀

일반

핑

설명

Google Security Operations Marketplace 탭의 통합 구성 페이지에서 제공된 매개변수를 사용하여 BMC Helix Remedyforce에 대한 연결을 테스트합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
케이스 월
결과 유형 값/설명 유형(항목 \ 일반)
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않아야 합니다.
성공한 경우: '제공된 연결 매개변수를 사용하여 BMC Helix Remedyforce 서버에 연결되었습니다.'

작업이 실패하고 플레이북 실행이 중지되어야 합니다.
실패한 경우: 'BMC Helix Remedyforce 서버에 연결할 수 없습니다. 오류: {0}".format(exception.stacktrace)

 일반

레코드 업데이트

설명

BMC Helix Remedyforce에서 레코드를 업데이트합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
레코드 유형 문자열 해당 사항 없음 예 업데이트해야 하는 레코드의 유형을 지정합니다. 사용 가능한 레코드 유형을 모르는 경우 '레코드 유형 나열' 작업을 실행하세요.
레코드 ID 문자열 해당 사항 없음 예 업데이트해야 하는 레코드의 ID를 지정합니다.
업데이트할 필드 JSON

{

"field":"value"

}

 예 업데이트해야 하는 모든 필수 필드와 값이 포함된 JSON 객체를 지정합니다.

실행

작업이 항목에서 실행되지 않거나 필수 입력 매개변수가 없습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
케이스 월
결과 유형 값/설명 유형(항목 \ 일반)
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않아야 합니다.
204인 경우 (is_success = true): 'BMC Helix Remedyforce에서 {record id}로 {record type} 레코드를 업데이트했습니다.'

작업이 실패하고 플레이북 실행을 중지해야 합니다.
잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 발생한 경우: ''레코드 업데이트' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

404 또는 400인 경우: "Error executing action "Update Record". 이유: {message}

레코드 유형을 찾을 수 없는 경우: '레코드 업데이트' 작업을 실행하는 동안 오류가 발생했습니다. 이유: BMC Helix Remedyforce에 {레코드 유형}이 없습니다. 사용 가능한 레코드 유형 목록을 가져오려면 '레코드 유형 나열' 작업을 사용하세요.

잘못된 JSON 페이로드인 경우: "Error executing action "Update Record". 이유: '업데이트할 필드' 매개변수에 잘못된 JSON 페이로드가 제공되었습니다. 구조를 확인하세요.

 일반

필드 업데이트 대기

설명

BMC Helix Remedyforce에서 필드가 업데이트될 때까지 기다립니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
레코드 유형 문자열 해당 사항 없음 예 업데이트를 기다리는 레코드의 유형을 지정합니다. 사용 가능한 레코드 유형을 모르는 경우 '레코드 유형 나열' 작업을 실행하세요.
레코드 ID 문자열 해당 사항 없음 예 업데이트해야 하는 레코드의 ID를 지정합니다.
확인할 필드 JSON

{

"field":"value"

}

 예 필요한 모든 필드와 값이 포함된 JSON 객체를 지정합니다.
시간 초과 시 실패 체크박스 선택 예 사용 설정된 경우 일부 필드가 업데이트되지 않으면 작업이 실패합니다.

실행

작업이 항목에서 실행되지 않거나 필수 입력 매개변수가 없습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
JSON 결과
{
    "attributes": {
        "type": "BMCServiceDesk__Incident__c",
        "url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
    },
    "Id": "a2U5e000000kl6NEAQ",
    "BMCServiceDesk__FKImpact__c": "a2M5e000000l1HxEAI",
    "BMCServiceDesk__FKIncident__c": null,
    "BMCServiceDesk__FKLead__c": null,
    "BMCServiceDesk__FKOpenBy__c": "0055e000001zFloAAE",
    "BMCServiceDesk__FKPriority__c": "a2h5e000000nHTnAAM",
    "BMCServiceDesk__FKRequestDefinition__c": null,
    "BMCServiceDesk__FKRequestDetail__c": null,
    "BMCServiceDesk__FKServiceOffering__c": null,
    "BMCServiceDesk__FKStatus__c": "a3w5e000000U1xcAAC",
    "BMCServiceDesk__FKTemplate__c": null,
    "BMCServiceDesk__actualOutageDuration__c": null,
    "BMCServiceDesk__call__c": 1.0,
    "Client_VIP__c": false,
    "BMCServiceDesk__Incorrect_owner__c": false,
    "BMCServiceDesk__LockedRecordTimestamp__c": null,
    "BMCServiceDesk__Queue__c": "Incident Queue",
    "BMCServiceDesk__Reassigned_Count__c": null,
    "BMCServiceDesk__isServiceRequest__c": false,
    "BMCServiceDesk__Approval_Status__c": null,
    "Alternate_Contact_Name__c": null,
    "Alternate_Contact_Number__c": null,
    "Client_Phone__c": null,
    "External_Ticket_Ref__c": null,
    "Affected_Application__c": null,
    "Affected_Hardware__c": null,
    "BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
    "BMCServiceDesk__RF_TimeToClose__c": null,
    "BMCServiceDesk__RF_FKLayout__c": null,
    "BMCServiceDesk__RF_LTEC__c": null,
    "BMCServiceDesk__RF_SkipTriggerExecution__c": false,
    "BMCServiceDesk__Categorization_Mode__c": null,
    "BMCServiceDesk__RF_Attachments__c": null,
    "BMCServiceDesk__RF_HasAttachments__c": null,
    "BMCServiceDesk__RF_IntegrationData__c": null
}
케이스 월
결과 유형 값/설명 유형(항목 \ 일반)
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.
201인 경우 (is_success = true): 'BMC Helix Remedyforce에서 ID가 {record id}인 {record type} 레코드가 업데이트되었습니다.'

필드 중 하나가 업데이트되지 않았고 제한 시간이 사용 설정되지 않은 경우 실패 (is_success=false): 'BMC Helix Remedyforce에서 ID가 {record id}인 {record type} 레코드의 다음 필드가 업데이트되지 않았습니다. {fields that were not updated}'

비동기 메시지: BMC Helix Remedyforce에서 ID가 {record id}인 {record type} 레코드의 다음 필드가 업데이트되기를 기다리는 중: {fields that were not updated}

작업이 실패하고 플레이북 실행을 중지해야 합니다.
잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 발생한 경우: ''필드 업데이트 대기' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

일부 필드를 찾을 수 없는 경우: ''필드 업데이트 대기' 작업을 실행하는 동안 오류가 발생했습니다. 이유: 레코드 구조에서 다음 필드를 찾을 수 없습니다. {찾을 수 없는 필드}

레코드 유형을 찾을 수 없는 경우: '필드 업데이트 대기' 작업을 실행하는 동안 오류가 발생했습니다. 이유: BMC Helix Remedyforce에 {레코드 유형}이 없습니다. 사용 가능한 레코드 유형 목록을 가져오려면 '레코드 유형 나열' 작업을 사용하세요.

필드 중 하나가 업데이트되지 않고 제한 시간이 사용 설정된 경우 실패 (is_success=false): ''필드 업데이트 대기' 작업을 실행하는 중에 오류가 발생했습니다. 이유: BMC Helix Remedyforce에서 ID가 {record id}인 {record type} 레코드의 다음 필드가 업데이트되지 않았습니다. {fields that were not updated}"

JSON 페이로드가 잘못된 경우: ''필드 업데이트 대기' 작업을 실행하는 동안 오류가 발생했습니다. 이유: '확인할 필드' 매개변수에 잘못된 JSON 페이로드가 제공되었습니다. 구조를 확인하세요.

 일반

커넥터

BMC Helix Remedyforce - Incidents Connector

설명

BMC Helix Remedyforce에서 인시던트에 관한 정보를 가져옵니다.

Google SecOps에서 BMC Helix Remedyforce - Incidents Connector 구성

Google SecOps에서 커넥터를 구성하는 방법에 대한 자세한 내용은 커넥터 구성을 참고하세요.

커넥터 매개변수

다음 매개변수를 사용하여 커넥터를 구성합니다.

매개변수 표시 이름 유형 기본값 필수 항목 설명
제품 필드 이름 문자열 제품 이름 예 제품 필드 이름을 가져오려면 소스 필드 이름을 입력합니다.
이벤트 필드 이름 문자열 BMCServiceDesk__Type__c 예 이벤트 필드 이름을 가져오려면 소스 필드 이름을 입력합니다.
환경 필드 이름 문자열 "" 아니요

환경 이름이 저장된 필드의 이름을 설명합니다.

환경 필드를 찾을 수 없으면 환경이 기본 환경입니다.
환경 정규식 패턴 문자열 .* 아니요

'환경 필드 이름' 필드에 있는 값에서 실행할 정규식 패턴입니다.

기본값은 .*로서 모두 포착하고 변경되지 않은 값을 반환합니다.

사용자가 정규식 로직을 통해 환경 필드를 조작할 수 있도록 허용하는 데 사용됩니다.

정규식 패턴이 null이거나 비어 있거나 환경 값이 null인 경우 최종 환경 결과는 기본 환경입니다.
스크립트 제한 시간(초) 정수 180 예 현재 스크립트를 실행하는 Python 프로세스의 제한 시간 한도입니다.
API 루트 문자열 https://.my.salesforce.com 예 BMC Helix Remedyforce 인스턴스의 API 루트입니다.
사용자 이름 문자열 해당 사항 없음 예 BMC Helix Remedyforce 사용자 이름입니다.
비밀번호 비밀번호 해당 사항 없음 예 BMC Helix Remedyforce 비밀번호입니다.
가져올 가장 낮은 우선순위 정수 5 아니요 인시던트를 가져오는 데 사용할 가장 낮은 우선순위입니다. 최대: 5개 최소: 1 아무것도 제공하지 않으면 커넥터가 모든 인시던트를 수집합니다.
빈 우선순위 침해 사고 수집 체크박스 선택 아니요 사용 설정된 경우 커넥터는 우선순위가 없는 인시던트를 가져옵니다. 이러한 방식으로 생성된 Google SecOps 알림의 우선순위는 '정보'로 설정됩니다.
유형 필터 CSV Incident,Service Request(인시던트, 서비스 요청) 아니요 인시던트의 유형 필터입니다. 아무것도 제공하지 않으면 커넥터가 모든 인시던트를 수집합니다. 예: 인시던트, 서비스 요청
최대 이전 시간 정수 1 아니요 인시던트를 가져올 위치의 시간입니다.
가져올 최대 인시던트 수 정수 10 아니요 커넥터 반복당 처리할 인시던트 수입니다. 최댓값은 200입니다.
허용 목록을 차단 목록으로 사용 체크박스 선택 예 사용 설정하면 허용 목록이 차단 목록으로 사용됩니다.
SSL 확인 체크박스 선택 예 사용 설정하면 BMC Helix Remedyforce 서버 연결에 대한 SSL 인증서가 유효한지 확인합니다.
프록시 서버 주소 문자열 해당 사항 없음 아니요 사용할 프록시 서버의 주소입니다.
프록시 사용자 이름 문자열 해당 사항 없음 아니요 인증할 프록시 사용자 이름입니다.
프록시 비밀번호 비밀번호 해당 사항 없음 아니요 인증할 프록시 비밀번호입니다.
클라이언트 ID 문자열 해당 사항 없음 아니요 연결된 앱의 BMC Helix Remedyforce 클라이언트 ID입니다. 이 매개변수는 OAuth 인증에 필요합니다. 참고: 이 매개변수는 사용자 이름 + 비밀번호 인증보다 우선합니다.
클라이언트 보안 비밀번호 비밀번호 해당 사항 없음 아니요 연결된 앱의 BMC Helix Remedyforce 클라이언트 보안 비밀번호입니다. 이 매개변수는 OAuth 인증에 필요합니다. 참고: 이 매개변수는 사용자 이름 + 비밀번호 인증보다 우선합니다.
로그인 API 루트 문자열 https://login.salesforce.com 예 BMC Helix Remedyforce에서 인증하는 데 사용되는 API 루트입니다.

커넥터 규칙

프록시 지원

커넥터가 프록시를 지원합니다.

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가로부터 답변을 받으세요.