FetchXML の会計日クエリ演算子および older than 日付/時刻クエリ演算子

[アーティクル]
03/30/2022

注意

エンティティとテーブルの違いがわかりませんか？ Microsoft Dataverse で「開発者: 用語を理解する」を参照してください。

Microsoft Dataverse アプリの FetchXML クエリは特別な会計日の値と、日付と時刻の値にクエリで older than 句を使用できます。たとえば、FetchXML クエリは、前の会計月に履行したすべての注文や、15 分経過した重大度の高い緊急のサポート案件を検索できます。

注意

すべての会計日付クエリに対して、FetchXML クエリは組織の会計年度設定を使用します。

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 分経過したインシデントを検索する 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>

次の構文を使用して、FetchXML 式でさまざまな older than 句を指定します。

X 分よりも古い

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

注意

この句は、DateOnly 動作を持つ日付と時刻の列ではサポートされていません。詳細: DateOnly の動作でサポートされない日付および時刻のクエリ演算子

X 時間よりも古い

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

注意

この句は、DateOnly 動作を持つ日付と時刻の列ではサポートされていません。詳細: DateOnly の動作でサポートされない日付および時刻のクエリ演算子

が 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>" />

FetchXML の会計日クエリ演算子および older than 日付/時刻クエリ演算子

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

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

関連項目

フィードバック