会計年度の日付と日付時刻のクエリ演算子 FetchXML

FetchXML クエリイン Microsoft Dataverse では、クエリ内の日付と時刻の値に特別な会計日付値と older than 句を使用できます。 たとえば、 FetchXML クエリでは、前会計月に処理されたすべての注文や、15分以上経過した重大度の高い緊急のケースを見つけることができます。

会計日付条件演算子の使用 FetchXML

次の例は、組織の 会計年度 設定に従って、最後の 会計期間 で履行されたすべての注文を検索する FetchXML 式を示しています。 このクエリは、たとえば、組織の会計期間単位が歴月なら、前の会計月の処理済みの注文を返します。 組織の会計期間単位が四半期制なら、前の四半期の処理済みの注文を返します。 組織の会計期間単位が上半期/下半期制なら、前の半期の処理済みの注文を返します。

<fetch>  
 <entity name="order">  
  <attribute name="name"/>  
  <filter type="and">  
   <condition attribute="datefulfilled" operator="last-fiscal-period"/>  
  </filter>  
 </entity>  
</fetch>  

次の例は、会計年度2013に作成されたすべてのアカウントを検索する FetchXML 式を示しています。

<fetch>  
 <entity name="account">  
  <attribute name="name"/>  
  <filter type="and">  
   <condition attribute="createdon" operator="in-fiscal-year" value="2013"/>  
  </filter>  
 </entity>  
</fetch>  

次の例は、組織の 会計年度 設定に基づいて、今後3会計年度内に完了予定日があるすべての商談を検索する式を示しています。 FetchXML x の値は、条件タグの値列で指定されます。

<fetch>  
 <entity name="opportunity">  
  <attribute name="name"/>  
  <filter type="and">  
   <condition attribute="estimatedclosedate" operator="next-x-fiscal-years" value="3"/>  
  </filter>  
 </entity>  
</fetch>  

次の例は、組織の 会計年度 設定に従って、任意の 会計年度 の期間3に履行されたすべての注文を検索する FetchXML 式を示しています。 会計期間の値は、条件タグの値列で指定されます。 組織の会計期間単位が歴月なら、このクエリは第 3 月の結果を返します。 組織の会計期間単位が四半期制なら、第 3 四半期の結果を返します。 組織の会計期間単位が上半期/下半期制の場合、結果は返されません。この場合、期間が 2 つしか存在せず、指定した値が範囲を越えるからです。

<fetch>  
 <entity name="order">  
  <attribute name="name"/>  
  <filter type="and">  
   <condition attribute="datefulfilled" operator="in-fiscal-period" value="3"/>  
  </filter>  
 </entity>  
</fetch>  

次の例は、組織の 会計年度 設定に従って、会計年度2013の期間3に履行されたすべての注文を検索する FetchXML 式を示しています。 組織の会計期間単位が歴月なら、このクエリは第 3 月の結果を返します。 組織の会計期間単位が四半期制なら、第 3 四半期の結果を返します。 組織の会計期間単位が上半期/下半期制の場合、結果は返されません。この場合、期間が 2 つしか存在せず、指定した値が範囲を越えるからです。

<fetch>  
 <entity name="order">  
  <attribute name="name"/>  
  <filter type="and">  
   <condition attribute="datefulfilled" operator="in-fiscal-period-and-year">  
    <value>3</value>  
    <value>2013</value>  
   </condition>  
  </filter>  
 </entity>  
</fetch>  

次の例は、履行された注文の合計金額を合計し、その結果を会計年度の半期と 会計年度 別にグループ化する集計式を示しています。 FetchXML

<fetch aggregate="true">  
 <entity name="order">  
  <attribute name="totalamount" aggregate="sum" alias="total"/>  
  <attribute name="datefulfilled" groupby="true" dategrouping="fiscal-period"/>  
 </entity>  
</fetch>  

日付と時刻の値への "よりも古い" 句の使用

次の例は、30分以上経過したインシデントを検索するa FetchXML を示しています。

<fetch>  
  <entity name="incident">  
    <attribute name="title" />  
    <attribute name="ticketnumber" />  
    <attribute name="createdon" />  
    <attribute name="incidentid" />  
    <filter type="and">  
      <condition attribute="createdon" operator="olderthan-x-minutes" value="30" />  
    </filter>  
  </entity>  
</fetch>  

式内のさまざまな older than 句を指定するには、次の構文を使用します。 FetchXML

X 分よりも古い

<condition attribute="<AttributeName>" operator="olderthan-x-minutes" value="<VALUE>" />  

X 時間よりも古い

<condition attribute="<AttributeName>" operator="olderthan-x-hours" value="<VALUE>" />  

が X 日よりも古い

<condition attribute="<AttributeName>" operator="olderthan-x-days" value="<VALUE>" />  

が X 週間よりも古い

<condition attribute="<AttributeName>" operator="olderthan-x-weeks" value="<VALUE>" />  

が X か月よりも古い

<condition attribute="<AttributeName>" operator="olderthan-x-months" value="<VALUE>" />  

が X 年間よりも古い

<condition attribute="<AttributeName>" operator="olderthan-x-years" value="<VALUE>" />  

参照

.NET 用 SDK を使用したクエリ データ
FetchXML を使用してクエリを構築します
FetchXML 「含まれない」レコードを照会するには、左外部結合を使用します。