attribute 요소

쿼리를 사용하여 반환할 엔터티 또는 링크 엔터티 의 열을 지정합니다.

FetchXml을 사용하여 열을 선택하는 방법을 알아봅니다.

Example

<fetch>
  <entity name='account'>
    <attribute name='name' />
    <link-entity name='contact'
      from='contactid'
      to='primarycontactid'
      link-type='inner'
      alias='contact'>
      <attribute name='fullname' />
    </link-entity>
  </entity>
</fetch>

Attributes

이름	필수?	Description
aggregate	아니오	적용할 집계 함수 입니다. FetchXml을 사용하여 데이터를 집계하는 방법 알아보기
alias	아니오	반환할 열의 이름입니다. 각 열에는 고유한 이름이 있어야 합니다. 집계 값을 검색할 때 별칭을 사용합니다. 열 별칭에 대해 자세히 알아봅니다.
dategrouping	아니오	데이터를 datetime 값으로 그룹화할 때 이 특성은 사용할 날짜 부분을 지정합니다. 날짜 그룹화 옵션 참조
distinct	아니오	집계 countcolumn 함수를 사용하는 경우 이 특성은 열에 대한 고유 값만 반환되도록 지정합니다. 고유한 열 값에 대해 자세히 알아봅니다.
groupby	아니오	데이터를 집계할 때 이 특성은 데이터를 그룹화하는 데 사용할 열을 지정합니다. 그룹화에 대해 알아보기.
name	Yes	열의 논리적 이름입니다.
rowaggregate	아니오	이 값이 레코드의 총 자식 레코드 수를 포함하는 값으로 설정된 CountChildren 경우 결과에 포함됩니다. 이 특성을 사용하는 방법을 알아봅니다.
usertimezone	아니오	datetime 열별로 그룹화되는 집계 쿼리에서 사용됩니다. 표준 시간대에 따라 동일한 날짜/시간 값이 다른 날짜로 떨어질 수 있습니다. 날짜의 일부를 기준으로 그룹화에 대해 알아보기 값과 함께 false 이 특성을 사용하여 그룹화에서 UTC 값을 사용하도록 강제합니다. 이 특성을 설정하지 않으면 기본값은 true사용자의 표준 시간대가 사용됩니다. 참고: QueryExpression을 사용하면 그룹화는 항상 UTC를 사용합니다. SDK FetchXmlToQueryExpressionRequest 클래스를 사용하는 경우 이 설정이 손실됩니다. QueryExpression을 사용하여 설정할 수 있는 방법은 없습니다.

부모 요소

이름	Description
실체	fetch 요소의 자식 요소인 쿼리의 '부모 엔터티'를 지정합니다. 하나의 엔터티만 허용됩니다.
link-entity	엔터티 또는 링크 엔터티와 관련된 테이블을 조인하여 결과와 함께 추가 열을 반환합니다. 필터 요소와 함께 관련 테이블의 열 값에 조건을 적용하는 데도 사용됩니다.

집계 함수

이러한 집계 함수를 사용합니다. FetchXml을 사용하여 데이터를 집계하는 방법 알아보기

기능	반환 값
avg	데이터가 있는 열 값의 평균 값입니다.
count	행 수입니다.
countcolumn	해당 열에 데이터가 있는 행의 수입니다.
max	해당 열에 있는 행의 최대값입니다.
min	해당 열에 있는 행의 최소값입니다.
sum	데이터가 있는 열 값의 총 값입니다.

날짜 그룹화 옵션

날짜의 일부를 기준으로 그룹화에 대해 자세히 알아보기

가치	Description
day	월의 일별로 그룹화
week	연도별 주별 그룹화
month	연도별 월별 그룹화
quarter	회계 연도의 분기별 그룹화
year	연도별 그룹화
fiscal-period	회계 연도 기간별로 그룹화
fiscal-year	회계 연도별 그룹화

회계 연도 설정에 대해 자세히 알아보기