함수 실행
OData에서 작업은 엔티티에 대한 서버측 작업을 추가하는 데 사용됩니다. 함수는 단일 엔티티 또는 엔티티 컬렉션을 대상으로 지정할 수 있습니다. 함수는 엔티티 또는 컬렉션에 직접 해당되지 않는 데이터를 반환합니다.
함수 실행 작업을 사용하여 OData 메타데이터에 정의된 함수를 실행합니다.
워크플로에서 함수 실행 작업을 사용하려면 다음 단계를 완료합니다.
1. OData에 있는 함수 실행 작업을 캔버스에 끌어 놓고 마우스 포인터로 작업을 가리킨 다음 
을 클릭하거나 작업을 두 번 클릭합니다. 함수 실행 창이 열립니다.
을 클릭하거나 작업을 두 번 클릭합니다. 함수 실행 창이 열립니다.2. 필요한 경우 레이블을 편집합니다. 기본적으로 레이블 이름은 작업 이름과 동일합니다.
3. OData 커넥터 유형을 추가하려면 지원되는 OData 커넥터 유형을 참조하십시오.
이전에 커넥터 유형을 추가한 경우 적절한 커넥터 유형을 선택하고 커넥터 이름 아래에서 커넥터를 선택합니다.
4. 테스트를 클릭하여 커넥터의 유효성을 검사합니다.
5. 맵 커넥터를 클릭하여 입력 필드를 채우는 데 사용한 커넥터와 다른 커넥터를 사용하여 작업을 실행합니다. 런타임 커넥터 필드에 유효한 OData 커넥터 이름을 제공합니다. 맵 커넥터에 대한 자세한 내용은 맵 커넥터 사용을 참조하십시오.
6. 참조된 도메인에서 FunctionImport에 설명된 모든 함수를 표시하려면 참조 도메인 포함 확인란을 선택합니다.
7. 함수 목록에서 실행할 OData 함수를 선택합니다.
입력 양식의 필드는 사용자가 선택한 함수에 따라 동적으로 변경됩니다.
8. 이 양식에 나열된 개별 속성의 입력을 제공하려면 양식을 선택하고 모든 필수 입력이 있는 단일 JSON을 지정하려면 JSON 지정을 선택합니다.
9. 질의 유형 목록에 있는 옵션을 사용하여 출력에 포함할 객체 속성에 따라 출력을 필터링합니다. 함수가 객체를 반환하지 않는 경우 질의 유형 옵션을 사용할 수 없습니다.
함수의 반환 유형에 따라 질의에 다음과 같은 매개 변수가 있습니다.
◦ 단일 객체 - 속성 선택, 관련 항목 추가
◦ 객체 컬렉션 - 필터, 속성 선택, 관련 항목 추가, 제한, 건너뛰기
양식 기반 질의 a. (객체 컬렉션에만 사용 가능) 필터 그룹에서 다음을 수행합니다. a. 조인 기준 목록에서 필터 절을 조인하는 논리 연산자를 선택합니다. 기본값은 및입니다. b. 필터 절에서 추가를 클릭하여 필터를 추가합니다. ▪ 속성 - 속성을 선택합니다. ▪ 일치 조건 - 조건을 선택합니다. 조건은 문자열, 부울 등의 선택한 속성 유형에 따라 달라집니다. ▪ 값 - 속성 값을 입력합니다. 필터를 여러 개 추가하려면 추가를 클릭합니다. 추가한 필터를 삭제하려면  을 클릭합니다.동일한 속성을 추가하고 조인 기준 목록에서 및을 선택하면 또는 연산자로 속성이 조인됩니다. b. 속성 선택에서 추가를 클릭하고 속성 목록에서 값을 검색할 속성을 선택합니다. 속성을 여러 개 추가하려면 추가를 클릭합니다. 추가한 속성을 삭제하려면 을 클릭합니다.기본적으로 속성을 선택하면 선택한 속성 및 '키' 속성의 값을 출력에 읽어들입니다. 속성을 선택하지 않으면 기본적으로 모든 엔티티 속성이 출력에 포함됩니다. c. 관련 항목 추가에서 추가를 클릭하고 관련 항목 목록에서 값을 검색할 관련 항목을 선택합니다. 관련 항목을 여러 개 추가하려면 추가를 클릭합니다. 추가한 관련 항목을 삭제하려면 을 클릭합니다.NavigationProperty로 표시된 모든 속성은 관련 항목으로 분류됩니다. d. (객체 컬렉션에만 사용 가능) 제한 필드에 지정된 엔티티의 수로 출력을 제한할 값을 입력합니다. e. (객체 컬렉션에만 사용 가능) 건너뛰기 필드에 건너뛸 리소스 수를 입력합니다. |
이산 질의 a. (객체 컬렉션에만 사용 가능) 필터 필드에 propertyName operator 'value' [and | or | not]... 형식의 OData 필터 조건을 지정합니다. 예: number eq '0000222341', name eq 'PTC' 또는 startswith(name, 'PTC') b. 속성 선택 필드에서 쉼표로 구분된 속성 이름 목록을 제공하는 OData select 식을 지정합니다. 기본적으로 질의에 속성을 지정하면 선택한 속성의 값을 출력에 읽어들입니다. 속성을 지정하지 않으면 기본적으로 모든 엔티티 속성이 출력에 포함됩니다. c. 관련 항목 추가 필드에서 쉼표로 구분된 관련 항목 목록을 제공하는 OData select 식을 지정합니다. NavigationProperty로 표시된 모든 속성은 관련 항목으로 분류됩니다. d. (객체 컬렉션에만 사용 가능) 제한 필드에 검색할 검색 결과의 수를 입력합니다. e. (객체 컬렉션에만 사용 가능) 건너뛰기 필드에 결과에서 건너뛸 상위 검색 결과의 수를 입력합니다. |
원시 질의 질의 필드에서 OData query 식을 지정합니다. 예: $select=name,number&$expand=context&$top=2&$skip=1&$orderby=name asc&$filter=name eq 'PTC' 기본적으로 질의에 속성을 지정하면 선택한 속성의 값을 출력에 읽어들입니다. 속성을 지정하지 않으면 기본적으로 모든 엔티티 속성이 출력에 포함됩니다. NavigationProperty로 표시된 모든 속성은 관련 항목으로 분류됩니다. 함수의 반환 유형에 따라 질의 식에 필터, 제한 및 생략 매개 변수를 제공할 수 있습니다. |
10. 추가 필드 표시를 클릭합니다.
11. 머리글 그룹에서 추가를 클릭하여 요청에 사용자 정의 머리글을 추가합니다. 키-값 쌍을 제공합니다.
키-값 쌍을 여러 개 추가하려면 추가를 클릭합니다. 추가한 사용자 정의 머리글을 삭제하려면 을 클릭합니다.
을 클릭합니다.12. 완료를 클릭합니다.
출력 스키마
선택한 OData 함수에 따라 함수 실행 작업은 동적 출력 스키마를 반환합니다. 함수에 반환 유형이 없으면 메시지 문자열을 반환합니다.
양식 기반 질의를 선택하여 질의 매개 변수를 지정한 경우 출력 스키마는 선택된 속성의 세부 정보만 제공합니다.
이산 질의 또는 원시 질의의 경우 출력 스키마에 반환된 객체의 모든 속성이 포함되어 있지만 선택된 속성의 값만 제공합니다.