- 인쇄
To download the app, visit: Library
소개
Salesforce는 영업 리드 추적부터 주문 및 재고 관리까지 다양한 애플리케이션에 사용되는 클라우드 기반 CRM 소프트웨어 플랫폼입니다.
목적
이 문서는 Tulip 라이브러리에서 찾을 수 있는 Salesforce REST API 커넥터에 대해 자세히 설명합니다. 이 커넥터 함수를 구성하면 Tulip 앱에서 Salesforce 데이터를 검색, 쿼리 및 수정하는 데 사용할 수 있습니다.
API 문서
Salesforce REST API에 대한 문서는 여기에서 찾을 수 있습니다. 이 문서에 포함된 일부 커넥터 함수는 전체 구문은 여기에 설명되어 있는 SOQL(Salesforce 개체 쿼리 언어)을 사용하여 쿼리를 수행한다는 점에 유의하세요.
Note: Salesforce supports a number of API across a variety of methods, the full list of which can be found here. This article and the Connectors to which it is related are built to use the Salesforce REST API.
처음 설정
Warning: generating the following values requires developer- or administrator-level permissions in Salesforce.
다음 프로세스는 새로 고침 토큰을 생성하는 방법을 설명하며, 이 토큰은 모든 Tulip 앱에서 Salesforce에 성공적으로 연결하는 데 필요한 액세스 토큰을 검색하는 데 사용됩니다.
- Salesforce에서 연결된 앱을 만듭니다. 이렇게 하려면 Salesforce의 '설정' 공간으로 이동합니다. 그런 다음 플랫폼 도구 >> 앱 >> 연결된 앱 >> 연결된 앱 관리로 이동합니다.
- 새 연결된 앱을 만듭니다. 애플리케이션에 필요한 모든 범위를 포함하되,
refresh_token을
포함해야 합니다. b. OAuth 설정 사용을 선택하고 콜백 URL을https://login.salesforce.com/services/oauth2/success
으로 입력합니다. - 완료되면 소비자 세부 정보 관리를 클릭하여 '소비자 키'와 '소비자 비밀'을 확인합니다. 이는 나중에 사용됩니다.
- 이제 Tulip에서 커넥터 기능 [설정] 인증 코드 가져오기 URL을 엽니다. 위 3단계에서 생성한 "소비자 키"를 쿼리 매개변수
client_id로
복사하여 붙여넣습니다. - "커넥터 함수를 '실행'합니다.
- 커넥터의 "출력"으로 URL이 생성되었는지 확인합니다. 이 URL을 브라우저 창에 붙여넣습니다.
- 표시되는 인증 프롬프트를 완료하여 Tulip이 Salesforce 인스턴스와 상호 작용할 수 있도록 권한을 부여합니다.
- 성공하면 브라우저가
원격 액세스 애플리케이션 인증
이라고 표시된 새 페이지로 리디렉션됩니다. 인증 코드는 이 페이지의 URL에서 찾을 수 있습니다. 예를 들어,https://login.salesforce.com/services/oauth2/success?code=asdf1234
URL에서 인증 코드는asdf1234입니다
. - 이 인증 코드를 저장합니다. 코드는 두 개의 등호 기호로 끝나야 합니다. 코드가
%3D%3D로
끝나는 경우 이 문자를 제거하고==로
바꾸세요. - 설정] 토큰 새로 고침 토큰 가져오기 튤립 커넥터 기능으로 이동합니다. 쿼리 매개변수에 위에서 수집한 모든 정보를 붙여넣습니다:
grant_type=
authorization_code
redirect_uri=
https://login.salesforce.com/services/oauth2/success
client_id=
위 3단계의 소비자 키client_secret=
위 3단계의 소비자 시크릿code=
위 9단계의 인증 코드
- 이 커넥터를 실행하고 응답에 표시되는
새로고침_토큰을
저장합니다. - 마지막으로 [인증] 액세스 토큰 가져오기 커넥터 기능으로 이동합니다. 다음 쿼리 매개 변수를 입력합니다:
grant_type=
권한``부여
코드
client_id=
위 3단계의 소비자 키client_secret=
위 3단계의 소비자 비밀번호refresh_token=
위 10단계의 새로 고침 토큰
- 커넥터를 실행합니다. 응답에는 출력으로 매핑된
액세스 토큰이
포함됩니다. 커넥터를 저장하여 새로 고침 토큰 저장
이 함수가 access_token을
생성할 수 있게 되면 설정이 완료된 것입니다! 이제 이 액세스 토큰은
2단계에서 구성한 시간 제한 설정이 허용하는 한 이후의 모든 커넥터 함수에서 사용할 수 있습니다.
튤립 연결 세부 정보
커넥터가 Salesforce와 인터페이스할 수 있도록 하려면 커넥터의 연결 세부 정보 아래에 Salesforce 인스턴스의 하위 도메인을 "기본 하위 도메인"으로 입력하세요. 예를 들어 Salesforce 인스턴스가 sample.my.salesforce.com에서 찾을 수 있는 경우 기본 하위 도메인은 sample.my가
되어야 합니다.
여기의 모든 커넥터 함수는 Salesforce REST API v46.0에서 작동하도록 만들어졌습니다.
커넥터 함수
커넥터에는 개체 유형 커넥터와 쿼리 유형 커넥터의 두 가지 기본 유형이 있습니다. 두 커넥터 모두 액세스 토큰이
필요하므로 앱에서 [인증] 액세스 토큰 가져오기를 먼저 실행해야 합니다! 일반적으로 앱 또는 프로세스가 시작될 때 새 액세스 토큰을 생성하고 나중에 사용할 수 있도록 앱 변수에 저장하는 것이 좋습니다.
객체 유형 커넥터
- 해당 오브젝트의 모든 필드를 반환합니다.
- 엔드포인트
./services/data/v46.0/sobjects/<오브젝트 이름>/<오브젝트 ID>
사용 - 예제: 커넥터 [기회] 모든 필드 가져오기
쿼리 유형 커넥터
- 쿼리에 지정된 필드만 반환합니다.
- 연결된(예: 기회와 관련된 계정 이름) 또는 집계(예: 레코드 수) 정보를 반환할 수 있습니다.
- 엔드포인트
./services/data/v46.0/query
사용 - SOQL을 사용하여 쿼리를 작성해야 합니다( 여기
문서{target=_blank}
). - 예제: 커넥터 [주문] 모든 주문 상태 가져오기
포함된 커넥터 함수
다음 커넥터 함수는 이 팩에 포함되어 있으며 Salesforce API를 통해 가능한 기능을 소개하기 위한 것입니다.* [설정] 인증 코드 URL 가져오기 및 [설정] 토큰 새로 고침 가져오기 * 처음 설정할 때만 사용됩니다. 자세한 내용은 위를 참조하세요.* [인증] 액세스 토큰 가져오기 * 이후의 모든 커넥터 함수에 포함되어야 하는 액세스 토큰을 생성하는 데 사용됩니다.* [기회] 함수: * 모든 필드 가져오기 * 쿼리된 기회에 대한 모든 필드를 반환합니다. 액세스 토큰과 기회 ID가 필요합니다. * 스테이지 변경 * 표시된 기회 스테이지를 지정된 값으로 업데이트합니다.* [주문] 기능: * 모든 상태의 주문 가져오기 * 지정된 상태의 모든 주문 목록을 반환합니다. * 상태의 주문 수 계산 * 지정된 상태의 모든 주문 수를 반환합니다. * ID에서 주문 번호 가져오기 * 지정된 주문 ID에서 주문 번호를 반환합니다.
이러한 함수를 필요에 맞게 수정하려면 아래 조언을 참고하세요: 1. 객체 유형 커넥터 함수를 수정하려면 URL에 표시된 객체를 변경하기만 하면 됩니다. 필요에 따라 새 출력을 추가하거나 제거합니다.2. 쿼리 유형 커넥터 함수를 수정하려면 쿼리에서 모든 변경 사항을 수행해야 합니다. 이는 쿼리 매개변수에서 q
키로 찾을 수 있습니다.1. 팁: LIMIT(number_of_responses) 함수를 사용하여 쿼리에서 응답 수를 제한하세요.
원하는 정보를 찾았나요?
community.tulip.co로 이동하여 질문을 게시하거나 다른 사람들이 비슷한 질문을 했는지 확인할 수도 있습니다!