사용 방법 App Connect with Salesforce

지원되는 제품 및 API 버전

이 커넥터가 지원하는 제품 및 API 버전을 확인하려면 IBM 지원 페이지에서 자세한 시스템 요구 사항을 참조하세요.

지원되는 에디션

• 계정이 Salesforce 없다면 개발자 계정을 생성하여 무료로 Salesforce 체험해 볼 수 있습니다.
  중요: App Connect 로 테스트할 무료 Salesforce 계정을 생성하려면, 체험판 계정이 아닌 개발자 계정을 생성해야 합니다. App Connect 에 평가판 계정으로 연결하면 이벤트가 Salesforce 작동하지 않습니다.
• 귀하의 에디션은 API 접근을 위해 Salesforce 활성화되어야 합니다( API 활성화 ).

  무료 체험판은 API를 Salesforce 지원하지 않습니다. 그러므로 대신 개발자 에디션에 가입하십시오.

  기본적으로 API 액세스는 엔터프라이즈, 개발자, 무제한 및 퍼포먼스 에디션에서만 허용됩니다. 프로페셔널 에디션에는 무료 API 접근 권한이 포함되어 있지 않으며, API 접근 권한을 활성화하거나 상위 에디션으로 업그레이드하려면 비용을 지불해야 할 수 있습니다.

  사용 Salesforce 중인 버전이 API를 지원하는지 관리자에게 Salesforce 문의하십시오. 필요한 경우 API 사용 권한을 요청하거나 API 접근 권한이 있는 상위 버전으로 업그레이드하십시오.

• 모든 이벤트가 Salesforce 정상적으로 작동하도록 하려면 조직에 대해 스트리밍 API 액세스가 활성화되어 있는지 확인하십시오.

  스트리밍 API는 연결이 종료될 때까지 사용자에게 업데이트된 데이터를 전송하는 지속적인 연결을 유지합니다. 사용자가 빠르게 변화하는 라이브 데이터의 지속적인 스트림을 보고자 할 때는 스트리밍 API가 이상적입니다. 사용자가 연결을 종료할 때까지 서버는 업데이트된 정보로 응답을 반복적으로 반환합니다.

  조직에 스트리밍 API를 활성화하려면 다음 단계를 완료하십시오.

  1. 계정에 로그인하세요 Salesforce 계정에 로그인합니다.
     참고: 이러한 설정은 라이트닝 모드 또는 클래식 모드에서 업데이트하도록 선택할 수 있습니다.
  2. 설정 (클래식)을 클릭하거나 톱니바퀴 아이콘을 클릭한 다음 설정 (라이트닝)을 클릭합니다.
  3. 빠른 찾기 상자에서 User Interface 을 검색한 다음 사용자 인터페이스를 선택합니다.
  4. 사용자 인터페이스 페이지의 설정 섹션에서 스트리밍 API 사용 확인란이 선택되어 있는지 확인합니다.

     그렇지 않은 경우 확인란을 클릭한 다음 저장을 클릭합니다.

다음에 연결 Salesforce

App Connect 를 Salesforce 계정에 연결하려면 App Connect 의 ' Salesforce 에 연결하기'를 참조하십시오.

연결된 앱에 대한 고려 사항 Salesforce

연결되면 IBM® App Connect 서비스가 Salesforce 의 ‘연결된 앱’ OAuth ‘사용 현황’ 페이지에 표시됩니다:

Salesforce 조직당 사용자 1인당 연결된 앱은 최대 5개까지 허용됩니다. 연결된 앱에 대해 다섯 번째 승인이 이루어지면 가장 오래된 승인이 취소됩니다. App Connect 의 경우, App Connect의 Connect > Applications and APIs 페이지(이전의 Catalog 페이지) 에서 모든 Salesforce 애플리케이션에 걸쳐 5개 이상의 계정을 생성하지 않도록 하십시오. 사용자 에이전트 흐름과 같은 다른 Salesforce 연결된 애플리케이션도 최대 5개 계정을 줄일 수 있습니다. 이 사항에 대한 자세한 내용은 ‘ Salesforce ’ 문서의 “ OAuth 가 활성화된 연결된 앱의 데이터 액세스 관리”를 참조하십시오. (이러한 접근 권한 취소가 App Connect 에 영향을 미치는 경우, 해당 Salesforce 계정을 플로우에서 사용하려고 하면 다음과 같은 메시지가 표시됩니다We can't connect to Salesforce with the account details that you provided..)

App Connect 에서 Salesforce 사용 시 일반적인 고려 사항

• 검색 호출 실패로 인한 401 권한 없는 액세스 오류를 방지하려면 로그인 시 세션 보안 수준을 '높음 보증' 대신 '없음'으로 설정해야 합니다.
  세션 보안 수준을 '없음'으로 설정하려면 다음 단계를 완료하세요:

  1. 계정에 로그인하세요 Salesforce 계정에 로그인합니다.
     참고: 이러한 설정은 라이트닝 모드 또는 클래식 모드에서 업데이트하도록 선택할 수 있습니다.
  2. 설정 (클래식)을 클릭하거나 톱니바퀴 아이콘을 클릭한 다음 설정 (라이트닝)을 클릭합니다.
  3. 관리 섹션(클래식) 또는 관리 섹션(라이트닝)에서 사용자 관리 (클래식) 또는 사용자 (라이트닝)를 확장한 다음 사용자를 클릭합니다.
  4. 모든 사용자 페이지에서 계정과 연결된 프로필 이름을 클릭하세요.
  5. 프로필 페이지에서 수정을 클릭합니다.
  6. 세션 설정에서 로그인 시 필요한 세션 보안 수준 값을 없음으로 설정합니다.
  7. Save를 클릭하십시오.
     참고: 인증 방법을 사용하여 신원을 확인하라는 메시지가 표시될 수 있습니다.
• 샌드박스 또는 Salesforce 하위 도메인에 연결하고 소스 애플리케이션으로 이벤트를 Salesforce 트리거하려면 환경에서 Salesforce 조직 Salesforce 개체를 활성화해야 합니다. 관리자에게 Salesforce 해당 개체를 활성화해 달라고 요청하십시오.
• App Connect 최적화된 이벤트 처리를 제공합니다 Salesforce. 이벤트의 Salesforce 경우, SalesforcePushTopic 쿼리가 지원하는 표준 개체의 다음 하위 집합을 사용할 수 있습니다: 계정, 캠페인, 사례, 연락처, 리드, 기회 및 작업.
• 날짜를 지정할 때는 ISO 표준 형식인 YYYY-MM-DD를 사용하십시오. 예를 들어, 2017년 9월 19일을 다음과 2017-09-19같이 지정하십시오.
• 동일한 Salesforce 계정으로 최대 15개의 플로우가 동시에 실행될 수 있습니다. 동일한 Salesforce 계정으로 15개 이상의 플로우가 실행을 시도하면 오류가 발생합니다You've exceeded your organization's concurrent user limit for your Salesforce account동시 사용자 제한 오류가 발생하면 Salesforce, 몇 분간 기다린 후 이벤트 기반 흐름을 트리거하거나 API 작업을 호출하기 위해 다시 시도하십시오.
• (일반적인 고려 사항) App Connect 디자이너의 애플리케이션 및 API 페이지에서 사용 가능한 트리거 이벤트 및 작업 목록을 확인할 수 있습니다.

  일부 애플리케이션의 경우 이벤트 및 작업은 환경과 커넥터가 구성 가능한 이벤트 및 동적 작업 검색을 지원하는지 여부에 따라 달라집니다. 애플리케이션이 구성 가능한 이벤트를 지원하는 경우 이벤트 목록 아래에 구성 가능한 이벤트 더 보기 링크가 표시됩니다. 애플리케이션이 동작의 동적 검색을 지원하는 경우 동작 목록 아래에 자세히 보기 링크가 표시됩니다.

• (일반적인 고려 사항) 애플리케이션에 여러 개의 계정을 사용하는 경우 해당 애플리케이션에 대한 작업을 선택할 때 표시되는 필드 집합은 계정마다 다를 수 있습니다. 흐름 편집기에서 일부 애플리케이션은 항상 작업에 대해 선별된 정적 필드 집합을 제공합니다. 다른 애플리케이션은 동적 검색을 사용하여 연결된 인스턴스에 구성된 필드 집합을 검색합니다. 예를 들어 애플리케이션의 두 인스턴스에 대해 두 개의 계정이 있는 경우 첫 번째 계정에서는 즉시 사용할 수 있는 설정을 사용할 수 있습니다. 그러나 두 번째 계정은 추가 사용자 지정 필드로 구성할 수 있습니다.

플랫폼 이벤트

조직에서 Salesforce 의미 있는 이벤트 발생 시 사용자 정의 이벤트 알림을 제공하기 위해 플랫폼 이벤트가 정의된 경우, 해당 플랫폼 이벤트를 App Connect 플로우에 추가할 수 있습니다. 플랫폼 이벤트는 다음 중 하나로 추가할 수 있습니다: Salesforce - 이벤트 알림(또는 이벤트 메시지)을 사용하는 이벤트로, - 이벤트 알림을 게시하는 작업 으로. App Connect 에서 플랫폼 이벤트를 쉽게 식별할 수 있도록, 이벤트 및 작업 목록의 Salesforce 각 플랫폼 이벤트에 라벨이 (Platform event) 추가됩니다.

• 플랫폼 이벤트를 플로우를 트리거하는 ' App Connect ' 이벤트로 추가하려면 'Configure more events' 링크를 사용하여 더 많은 Salesforce 개체를 표시하십시오. 그런 다음 플로우에 추가하려는 플랫폼 이벤트를 선택하세요.
  팁: 검색된 이벤트 또는 작업 목록에서 플랫폼 이벤트를 빠르게 검색하려면 검색 필드에 (plat 을 필터로 입력하면 됩니다.

  선택적으로 플로우의 후속 노드에서 플랫폼 이벤트 필드에 매핑하여 이벤트 알림의 데이터를 가져올 수 있습니다. 플로우가 실행 중일 때, 조직 Salesforce 내에서 새로운 이벤트 알림(즉, 플랫폼 이벤트 인스턴스)이 게시될 때마다 구성된 작업이 처리됩니다.

  

  

• 플로우에 플랫폼 이벤트를 ' App Connect ' 액션으로 추가하려면, '더 보기' 링크를 사용하여 더 많은 Salesforce 개체를 표시한 후, 이벤트 알림을 생성(또는 게시)하려는 플랫폼 이벤트를 선택하십시오. 생성된 Create 노드에서 플랫폼 Salesforce 이벤트 정의에서 구성된 사용자 정의 필드를 완료할 수 있습니다. 플로우가 실행되면, ` App Connect `가 이벤트 알림을 게시하고, 해당 이벤트에 설정된 모든 Salesforceafter insert 트리거가 실행됩니다.

  

  

  

재생 ID

Salesforce 플랫폼 이벤트 기록을 위한 큐를 제공하며, 각 이벤트 알림에는 고유한 재생 ID가 부여됩니다. Salesforce 플랫폼 이벤트는 72시간 동안 보존되며, 사용자는 재구독 시 보존 기간 내 이벤트를 검색하기 위해 사용할 재생 ID 값을 저장할 수 있습니다. App Connect 플랫폼 이벤트를 Salesforce 통해 리플레이 ID를 지원합니다. 따라서 플랫폼 이벤트를 사용하는 플로우를 중지하더라도, 플로우가 중지된 동안 수신된 이벤트는 손실되지 않습니다. 이 기능을 사용하려면 플로우에 플랫폼 이벤트를 액션으로 App Connect 추가하고, 그림 7 에 표시된 대로 리플레이 ID 필드에 다음 옵션 중 하나를 입력하십시오. 리플레이 ID가 제공되지 않으면 해당 필드는 기본값으로 -1 을 사용합니다. 자세한 내용은 개발자 Salesforce 문서의 메시지 지속성 항목을 참조하십시오.

Replay ID

이 필드에 지정된 이벤트 알림의 ID 이후에 보관된 모든 이벤트를 수신하려면 다시보기 ID를 입력합니다. 이 옵션은 연결 실패 후 놓친 이벤트를 따라잡거나, 연결 재인증과 같이 흐름을 중지해야 할 때 유용합니다.

-1

흐름이 트리거된 후 새 이벤트 알림을 받으려면 -1 을 입력합니다.

-2

Enter 키를 -2 누르면 보존 기간 내에 있는 과거 이벤트와 플로우가 트리거된 후 발생하는 새로운 이벤트를 포함한 모든 이벤트를 수신할 수 있습니다.

필수 필드 업데이트

대상 애플리케이션으로 를 Salesforce 사용할 때는 생성 중인 레코드에 필요한 필드를 식별하고 해당 필드에 값을 할당해야 합니다.

• 리드를 생성하는 경우 성 (Last Name) 및 회사(Company) 필드에 값을 반드시 입력해야 합니다.
• 계정을 만드는 경우 계정 이름 필드에 값을 입력해야 합니다.

일부 Salesforce 작업에는 특정 종속성이 있습니다. 예를 들어, 주문을 생성할 때는 해당 주문을 계약 또는 계정에 반드시 추가해야 합니다. 따라서 주문 생성 작업의 경우 필수 입력란(별표 * 표시) 외에도 계약 ID 또는 계정 ID 필드를 반드시 작성해야 합니다. 이 ID가 누락된 경우, 플로우 실행 시 해당 종속성을 강조 표시하기 위한 오류가 발생합니다.

고유 ID 지정

일부 Salesforce 작업의 경우 고유한 ID 번호를 지정해야 합니다. 예를 들어, 주문 생성 작업의 경우 계약 ID 또는 계정 ID 값이 필요합니다. 하드코딩된 값을 입력하거나 흐름의 이전 노드에 있는 값에 매핑할 수 있습니다.

필요한 경우, 해당 Salesforce 레코드의 URL 에서 하드코딩된 ID를 얻을 수 있습니다. 다음 예시에서 계약 번호 00000101의 계약 ID 값이 8000Y000000lfvG 임을 확인할 수 있습니다. (개설된 계정 기록에서 비슷한 방법으로 계정 ID를 얻을 수도 있습니다.)

데이터 캡처 변경

데이터 변경 캡처 기능은 관심 대상 객체에 변경 Salesforce 사항이 발생할 때 알려줍니다. 상태 변경에 대한 구체적인 정보가 캡처되어 알림으로 제공됩니다. 객체에 대해 변경 데이터 Salesforce 캡처를 활성화한 경우, 해당 객체에 접근하여 객체가 수정된 모든 App Connect 시점을 캡처할 수 있습니다. 예를 들어, 리드가 업데이트될 때마다 알림을 받기 위해 플로우 중 하나에서 이벤트 트리거로 '리드 업데이트' Salesforce 노드를 사용할 수 있습니다. 리드 개체에서 변경 데이터 캡처를 Salesforce 활성화한 경우, 이전에는 확인할 수 없었던 정보가 포함된 리드에 변경 사항이 발생할 때마다 알림을 받을 수 있습니다. 이 정보에는 객체를 수정했던 사람, 객체가 수정된 시점, 그리고 변경된 필드 등이 포함될 수 있습니다.

변경 데이터 캡처를 사용하는 Salesforce 객체를 활용하는 플로우는 통합 App Connect 환경에서 발생하는 증분 업데이트에 대한 최신 정보를 제공합니다.

We can't retrieve the Change Data Capture events for the Salesforce Contact object because 
your Salesforce account doesn't have the required permission on the object to subscribe to subscribe
to Change Data Capture. 
Ensure that your Salesforce account has the required permission to subscribe to Change Data Capture.

We can't retrieve the Change Data Capture events for the Salesforce Contact object because
the object isn't configured for Change Data Capture.
Ensure that you selected a valid Salesforce object and the object is configured for Change Data Capture.

Change Data Capture를 Salesforce 활성화한 후에는 App Connect 플로우에 Change Data Capture 개체를 이벤트로 추가할 수 있습니다. 이 Salesforce 이벤트는 의 이벤트 알림을 사용합니다. 변경 데이터 캡처 이벤트를 쉽게 식별할 수 있도록 App Connect, 이벤트 목록 Salesforce 내 각 변경 데이터 캡처 이벤트에 라벨이 (Change Data Capture) 추가됩니다.

흐름을 트리거하는 이벤트로 App Connect 변경 데이터 캡처 개체를 추가하려면, '추가 이벤트 구성' 링크를 사용하여 더 많은 Salesforce 개체를 표시하십시오. 그런 다음 플로우에 추가하려는 변경 데이터 캡처 이벤트를 선택합니다.

참고: 검색된 이벤트 목록에서 변경 데이터 캡처 이벤트를 빠르게 찾으려면 필터로 검색 필드에 를 Change Data Capture 입력하세요.

다음 코드 예제에서는 매핑할 수 있는 필드의 메시지 구조를 표시합니다. 변경 이벤트 헤더의 필드는 변경 데이터 캡처 개체를 통해 이제 접근할 수 있는 추가 정보를 캡처합니다.

  {
    "schema": "<schema_ID>",
    "ChangeEventHeader": {
         "entityName" : "...",
         "recordIds" : "...",
         "changeType" : "...",
         "changedFields": [...],
         "changeOrigin" : "...",
         "transactionKey" : "...",
         "sequenceNumber" : "...",
         "commitTimestamp" : "...",
         "commitUser" : "...",
         "commitNumber" : "..."
      },
     "field1":"...",
     "field2":"...",
     . . .
    "event": {
      "replayId": <replayID>
    }
  },
  

흐름의 후속 노드에서 변경 알림의 데이터를 가져오기 위해 선택적으로 다음 변경 데이터 캡처 이벤트 필드 중 어느 것과도 매핑할 수 있습니다. 매핑에는 객체에 속하는 모든 필드(예: 중간 이름 또는 우편번호)도 포함되며, 이는 코드 예시에서 field2 와 field1 로 표시됩니다. 표준 필드(예: 생성 날짜 및 마지막 수정 날짜)는 항상 포함됩니다. 플로우가 실행 중일 때, 조직 Salesforce 내에서 새로운 변경 알림(즉, 변경 데이터 캡처 이벤트의 인스턴스)이 게시될 때마다 구성된 작업이 처리됩니다.

연결 후 고려 사항

Salesforce 이벤트를 구성할 때는 다음 사항을 유의하십시오. Salesforce 에서 이벤트를 선택하면 이벤트 구성 페이지가 표시됩니다.

• 'Replay ID ' 필드에는 리플레이 ID를 입력하십시오. 값이 지정되지 않은 경우 기본값은 -1.입니다. 재생을 위한 ID로 를 -2 지정하고 대량의 이벤트 메시지가 저장된 경우, 성능 문제가 발생할 수 있습니다. Salesforce 의 메시지 내구성에 대한 자세한 내용은 ‘메시지 내구성’을 참조하십시오.

  CometD 구독의 경우, 를 -1 사용하면 새로운 이벤트만 수신할 수 있으며, -2 (또는 0/1)를 사용하면 이용 가능한 모든 이벤트를 수신할 수 있습니다. 또한 특정 리플레이 ID 번호(예: 12345)를 지정하면 해당 지점부터 시작할 수 있습니다. gRPC 구독의 경우, maps를 LATEST(0)로, -2-1 maps를 EARLIEST(1)로 설정하고, 특정 리플레이 ID는 리플레이 ID를 바이트 배열로 변환한 후 CUSTOM(2)에 매핑합니다.

• ‘구독 유형 ’ 필드에서는 필요에 따라 ‘Pub/Sub ’, ‘ gRPC ’ 또는 ‘ CometD ’을 선택하십시오. 자세한 내용은 ‘ gRPC API로서 Platform Events 및 Pub/Sub API 구독하기’를 참조하세요.

이벤트 및 작업

Salesforce 이벤트

이러한 이벤트는 흐름에서 작업을 완료하기 시작하도록 흐름을 트리거하는 이 애플리케이션의 변경에 대한 것입니다.

기본적으로 표시되는 이벤트는 최적화된 연결을 사용하여 미리 구성되어 있습니다. 더 많은 이벤트를 보려면 폴링할 구성 가능한 이벤트 표시를 클릭하세요 Salesforce 을 클릭하여 새 개체 또는 업데이트된 개체를 확인합니다.

흐름이 이 애플리케이션에서 이러한 작업을 완료합니다.

App Connect 를 연결하면 더 많은 항목을 Salesforce 이용할 수 있습니다.