Dynamics 365 Business Central

연결 구성 샘플

이 섹션에서는 연결을 만들 때 구성할 다양한 필드의 샘플 값이 표시됩니다.

OAuth 2.0 - 클라이언트 사용자 인증 정보 연결 유형

액세스 키 연결 유형

Dynamics 365 Business Central Workspace를 만드는 방법에 대한 자세한 내용은 Dynamics 365 Business Central 시작하기를 참고하세요.

Dynamics 365 Business Central API에 관한 자세한 내용은 Dynamics365BusinessCentral API 참조를 참고하세요.

항목 작업 예시

이 섹션에서는 이 커넥터에서 일부 항목 작업을 수행하는 방법을 보여줍니다.

예시 - 모든 판매 주문 나열

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 salesOrders를 선택합니다.
3. List 작업을 선택한 후 완료를 클릭합니다.
4. 커넥터 태스크의 태스크 입력 섹션에서 filterClause를 설정할 수 있습니다.

필터 절의 값을 묶으려면 작은따옴표 (')를 사용해야 합니다. 필터 절을 사용하여 열을 기준으로 레코드를 필터링할 수 있습니다.

예시 - 판매 주문 가져오기

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 salesOrders를 선택합니다.
3. Get 작업을 선택한 후 완료를 클릭합니다.
4. 엔티티 ID를 전달할 키인 '841c04f9-3391-ef11-8a6b-002248d4e29e'로 설정합니다. 엔티티 ID를 설정하려면 데이터 매핑의 데이터 매퍼 섹션에서 데이터 매핑 편집기 열기를 클릭한 후 입력 값 필드에 "841c04f9-3391-ef11-8a6b-002248d4e29e"을 입력하고 EntityId를 로컬 변수로 선택합니다.

   엔티티 ID 값은 직접 전달해야 합니다(예: '841c04f9-3391-ef11-8a6b-002248d4e29e'). 여기서 '841c04f9-3391-ef11-8a6b-002248d4e29e'는 고유한 기본 키 값입니다.

   단일 엔터티 ID를 전달할 때 복합 키가 2개 있으면 오류가 발생하는 경우 필터 절을 사용하여 값을 전달할 수 있습니다.

예시 - 판매 주문 삭제

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 salesOrders를 선택합니다.
3. DELETE 작업을 선택한 후 완료를 클릭합니다.
4. 엔티티 ID를 전달할 키인 '841c04f9-3391-ef11-8a6b-002248d4e29e'로 설정합니다. 엔티티 ID를 설정하려면 데이터 매핑의 데이터 매퍼 섹션에서 데이터 매핑 편집기 열기를 클릭한 후 입력 값 필드에 "841c04f9-3391-ef11-8a6b-002248d4e29e"을 입력하고 EntityId를 로컬 변수로 선택합니다.

   entityId를 지정하는 대신 항목에 복합 비즈니스 또는 기본 키가 2개 있으면 filterClause를 id='841c04f9-3391-ef11-8a6b-002248d4e29e'로 설정할 수도 있습니다.

예시 - 판매 주문 만들기

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 salesOrders를 선택합니다.
3. Create 작업을 선택한 후 완료를 클릭합니다.
4. 데이터 매핑 태스크의 데이터 매퍼 섹션에서 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload를 로컬 변수로 선택합니다.

   {
        "orderDate": "2024-10-30",
        "customerNumber": "10000",
        "currencyCode": "INR",
        "paymentTermsId": "590d75c5-f26e-ef11-a678-6045bdc89b07"
        }
        

   통합이 성공하면 salesOrders 태스크의 connectorOutputPayload 응답 매개변수 값은 다음과 유사합니다.

   {
        "id": "2e048d8a-a796-ef11-8a6b-6045bdae882d"
        }
        

예시 - 판매 주문 내역 만들기

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 salesOrderLines를 선택합니다.
3. Create 작업을 선택한 후 완료를 클릭합니다.
4. 데이터 매핑 태스크의 데이터 매퍼 섹션에서 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload를 로컬 변수로 선택합니다.

   {
        "documentId": "b747cc93-c37f-ef11-ac23-7c1e523b4365",
        "sequence": 10014,
        "itemId": "8b0f75c5-f26e-ef11-a678-6045bdc89b07",
        "lineType": "Item",
        "lineObjectNumber": "1996-S"
        }
        

   통합이 성공하면 salesOrderLines 태스크의 connectorOutputPayload 응답 매개변수 값은 다음과 유사합니다.

   {
        "id": "35535130-d09d-ef11-8a6b-002248d4cc93"
        }
        

예시 - 판매 견적 만들기

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 salesQuotes를 선택합니다.
3. Create 작업을 선택한 후 완료를 클릭합니다.
4. 데이터 매핑 태스크의 데이터 매퍼 섹션에서 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload를 로컬 변수로 선택합니다.

   {
        "paymentTermsId": "590d75c5-f26e-ef11-a678-6045bdc89b07",
        "currencyCode": "INR",
        "customerNumber": "30000"
        }
        

   통합이 성공하면 salesQuotes 태스크의 connectorOutputPayload 응답 매개변수 값은 다음과 유사합니다.

   {
        "id": "2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e"
        }
        

예시 - 구매 주문 만들기

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 purchaseOrders를 선택합니다.
3. Create 작업을 선택한 후 완료를 클릭합니다.
4. 데이터 매핑 태스크의 데이터 매퍼 섹션에서 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload를 로컬 변수로 선택합니다.

   {
        "vendorId": "7e0f75c5-f26e-ef11-a678-6045bdc89b07",
        "vendorNumber": "10000"
        }
        

   통합이 성공하면 purchaseOrders 태스크의 connectorOutputPayload 응답 매개변수 값은 다음과 유사합니다.

   {
        "id": "53389ee7-a796-ef11-8a6b-6045bdae882d"
        }
        

예시 - 항목 만들기

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 items를 선택합니다.
3. Create 작업을 선택한 후 완료를 클릭합니다.
4. 데이터 매핑 태스크의 데이터 매퍼 섹션에서 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload를 로컬 변수로 선택합니다.

   {
        "number": "4000-D",
        "displayName": "Charlie Altostrat",
        "type": "Inventory",
        "itemCategoryId": "d61672cb-f26e-ef11-a678-6045bdc89b07",
        "baseUnitOfMeasureCode": "PCS"
        }
        

   통합이 성공하면 items 태스크의 connectorOutputPayload 응답 매개변수 값은 다음과 유사합니다.

   {
        "id": "fad09437-8d9e-ef11-8a6b-000d3af0e092"
        }
        

예시 - 판매 주문 업데이트

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 salesOrders를 선택합니다.
3. Update 작업을 선택한 후 완료를 클릭합니다.
4. 데이터 매핑 태스크의 데이터 매퍼 섹션에서 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload/FilterClause를 로컬 변수로 선택합니다.

   {
        "phoneNumber": "7764872993"
        }
        

5. 데이터 매퍼에서 엔티티 ID를 salesOrders의 항목으로 설정합니다. 엔터티 ID를 설정하려면 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload/FilterClause를 로컬 변수로 선택합니다.

   entityId를 지정하는 대신 filterClause를 id ='5e9226d3-1c7b-ef11-a671-6045bdaef76c'로 설정할 수도 있습니다.

예시 - 판매 주문 내역 업데이트

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 salesOrderLines를 선택합니다.
3. Update 작업을 선택한 후 완료를 클릭합니다.
4. 데이터 매핑 태스크의 데이터 매퍼 섹션에서 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload/FilterClause를 로컬 변수로 선택합니다.

   {
        "description": "Test from Altostrat"
        }
        

5. 데이터 매퍼에서 엔터티 ID를 salesOrderLines의 엔터티로 설정합니다. 엔터티 ID를 설정하려면 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload/FilterClause를 로컬 변수로 선택합니다.

   entityId를 지정하는 대신 filterClause를 id ='35535130-d09d-ef11-8a6b-002248d4cc93'로 설정할 수도 있습니다.

예시 - 판매 견적 업데이트

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 salesQuotes를 선택합니다.
3. Update 작업을 선택한 후 완료를 클릭합니다.
4. 데이터 매핑 태스크의 데이터 매퍼 섹션에서 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload/FilterClause를 로컬 변수로 선택합니다.

   {
        "currencyCode": "USD"
        }
        

5. 데이터 매퍼에서 엔터티 ID를 salesQuotes의 엔터티로 설정합니다. 엔터티 ID를 설정하려면 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload/FilterClause를 로컬 변수로 선택합니다.

   entityId를 지정하는 대신 filterClause를 id='2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e'로 설정할 수도 있습니다.

예시 - 구매 주문 업데이트

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 purchaseOrders를 선택합니다.
3. Update 작업을 선택한 후 완료를 클릭합니다.
4. 데이터 매핑 태스크의 데이터 매퍼 섹션에서 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload/FilterClause를 로컬 변수로 선택합니다.

   {
        "shipToName": "Charlie Cruz"
        }
        

5. 데이터 매퍼에서 엔터티 ID를 purchaseOrders의 엔터티로 설정합니다. 엔터티 ID를 설정하려면 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload/FilterClause를 로컬 변수로 선택합니다.

   entityId를 지정하는 대신 filterClause를 id ='6b88738e-3891-ef11-8a6b-002248d4e29e'로 설정할 수도 있습니다.

예시 - 항목 업데이트

1. Configure connector task 대화상자에서 Entities를 클릭합니다.
2. Entity 목록에서 items를 선택합니다.
3. Update 작업을 선택한 후 완료를 클릭합니다.
4. 데이터 매핑 태스크의 데이터 매퍼 섹션에서 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload/FilterClause를 로컬 변수로 선택합니다.

   {
        "displayName": "Updates Altostrat name"
        }
        

5. 데이터 매퍼에서 엔터티 ID를 항목의 엔터티로 설정합니다. 엔터티 ID를 설정하려면 Open Data Mapping Editor를 클릭한 후 Input Value 필드에 다음과 유사한 값을 입력하고 EntityId/ConnectorInputPayload/FilterClause를 로컬 변수로 선택합니다.

   entityId를 지정하는 대신 filterClause를 id ='fad09437-8d9e-ef11-8a6b-000d3af0e092'로 설정할 수도 있습니다.