この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

カスタム会計年度で定義された範囲を超える日付

クエリに含まれている日付が、継承された会計年度によって定義された範囲にない場合、SAQL はその日付のデータを返しません。

Salesforce から継承された会計年度で定義された範囲に日付が含まれていない場合、SAQL はその日付に対して null を返します。日付項目でグループ化する場合に、そのグループ内の日付が、継承されたカスタム会計年度で定義された範囲にない場合、未定義の日付に対してグループは返されません。会計期間以外の期間に基づいてデータをグループ化した場合、カスタム会計年度に含まれていない日付のデータは期待どおりに返されます。

例

会計年度が 2021 年 3 月に終了し、日付項目の CreatedDate が 2021 年 4 月の場合、CreatedDate_Month_Fiscal でグループ化すると、2021 年 4 月には null が返されるか、グループは返されません。CreatedDate_Month でグループ化すると、期待どおりにデータが返されます。

次のデータセットの例を考えてみます。

商談名	作成日	金額
ウィジェット	2017 年 2 月 1 日	100
ウィジェット	2018 年 2 月 1 日	100
ウィジェット	2019 年 2 月 1 日	100
ウィジェット	2020 年 2 月 1 日	100
ウィジェット	2021 年 2 月 1 日	100
ウィジェット	2022 年 2 月 1 日	100
ウィジェット	2023 年 2 月 1 日	100

Salesforce では、カスタム会計年度として 2018 年から 2022 年までの各年を 1 月 1 日から 12 月 31 日までに定義しています。Analytics では、このカスタム会計年度を [開始日] 設定を使用して継承します。

実行するクエリは、次のようになります。

1q = load "opportunities";
2q = foreach q generate 'Created_Date' as 'Created Date', Created_Date_Year_Fiscal as 'Fiscal Year';
3q = limit q 2000;

SAQL によって次の結果が返されます。

作成日	会計年度
2017 年 2 月 1 日	-
2018 年 2 月 1 日	2018
2019 年 2 月 1 日	2019
2020 年 2 月 1 日	2020
2021 年 2 月 1 日	2021
2022 年 2 月 1 日	2022
2023 年 2 月 1 日	-

カスタム会計年度の定義には、2/1/2017 と 2/1/2023 は含まれてないため、SAQL は null を返します。

では、データセットを作成してみましょう。

1q = load "opportunities";
2q = group q by 'Created_Date_Year_Fiscal';
3q = foreach q generate 'Created Date_Year_Fiscal' as 'Fiscal Year', count() as 'Count';
4q = order q by 'Created_Date_Year_Fiscal';
5q = limit q 2000;

SAQL によって次の結果が返されます。

会計年度	計
2018	1
2019	1
2020	1
2021	1
2022	1

カスタム会計年度の定義には 2/1/2017 と 2/1/2023 が含まれていないため、これらの日付が結果から除外されています。

Analytics SAQL 開発者ガイド

カスタム会計年度で定義された範囲を超える日付

例