アクティビティ

WHERE 句を使用して Workday でデータをフィルター処理する

フィルター処理はどこに適用されますか?

Workday の [すべてのレコードのリストを取得] アクティビティは、[Where] 句と [Includes] と [Excludes] フィールドに対するクエリをサポートし、過剰なデータを取り込んだり、除外したりします。

Where 句の構築方法

Get_Organizations SOAP サービスの詳細については、「Get_Organizations操作の詳細」を参照してください。

Request_Criteria セクション内のすべてのコンテンツは、アクティビティの Where 条項に含まれる対象と見なすことができます。同様に、 Response_Group セクション内のすべてのコンテンツは、 Includes または Excludes 要素と組み合わせて使用できます。これは、以下のスクリーンショットで確認できます。

Request_Criteria では、以下のパラメーターを確認できます。

ブールフィールドを含む Where 句を作成するには、以下に示すように句を構築できます。

場所 =

"boolean_field =
                  'true'"

場所 =

"Include_Inactive='false' and
                  Enable_Transaction_Log_Lite='true'"

Object である Type の場合、 Organization_TypeObjectのように、 Where 句を構築する方法は次のようになります。

ここで示す型は WID して Organization_Type_IDできるため、この句は次の形式で構成する必要があります。

場所 =

"Organization_Type_Reference.Attribute_type='WID' and
                  Organization_Type_Reference.Attribute_Value='WIDTEST'"

です。

同様に、 Transaction_Log_Criteria では 、Where 句を次の形式で記述できます。

したがって、以下の形式を使用する必要があります。

場所 =

"Transaction_Log_Criteria.Transaction_Date_Range_Data.Updated_From='2022-09-05T12:00:00'
                  and
                  Transaction_Log_Criteria.Transaction_Date_Range_Data.Updated_Through='2023-01-01T16:00:00'"

前述のすべての要素を 1 つのクエリに統合する場合は、次の例のように構造化できます。

場所 =

"Transaction_Log_Criteria.Transaction_Date_Range_Data.Updated_From='2022-09-05T12:00:00'
               and
               Transaction_Log_Criteria.Transaction_Date_Range_Data.Updated_Through='2023-01-01T16:00:00'
               and Include_Inactive='false' and Enable_Transaction_Log_Lite='true' and
               Organization_Type_Reference.Attribute_type='WID' and
               Organization_Type_Reference.Attribute_Value='WIDTEST'"

です。

重要な情報:

これは実例に過ぎず、実際のクエリシナリオを表していない場合があります。
Where 句は、常に Stringとして渡す必要があります。

[含める] および [除外] パラメーターを使用する

Includes 機能と Excludes 機能の使用状況は、 Response_Group 属性グループと関連付けられています (下図を参照)。

この 2 つの関数を使用して、応答のデータ要素を取得または除外するため、不要なデータや機密データを除外しながら、必要な特定の情報に的を絞ることができます。

この場合、データ要素 Roles_Data、 Hierarchy_Data、 Supervisory_Data 、 Staffing_Restrictions_Dataがあります。

これらをアクティビティの出力に含める場合は、次の例のようにコンマ区切りの文字列として渡します。

"Roles_Data,Supervisory_Data,Staffing_Restrictions_Data"

このプラクティスの他の例をいくつか以下に示します。

オブジェクト	サポートされる WHERE 句の例	次の値を含む (コンマ区切りの値)	除外 (コンマ区切りの値)
従業員/作業者	参照オブジェクトを使用したクエリ: "Organization_Reference.ID.Attribute_type='WID' and Organization_Reference.ID.Attribute_Value='WIDTEST" および Include_Subordinate_Organizations='true' トランザクションログの条件を使用したクエリの実行 "Transaction_Log_Criteria.Transaction_Date_Range_Data.Updated_From='2020-09-05T12:00:00' and Transaction_Log_Criteria.Transaction_Date_Range_Data.Updated_Through='2021-09-05T16:00:00'" and Include_Subordinate_Organizations='true'	"Personal_Information,Additional_Jobs,Employment_Information,Compensation,Organizations,Roles,Management_Chain_Data,Multiple_Managers_in_Management_Chain_Data,Benefit_Enrollments,Benefit_Eligibility,Related_Persons,Qualifications,Employee_Review,Goals,Development_Items,Skills,Photo,Worker_Documents,Transaction_Log_Data,Subevents_for_Corrected_Transaction,Subevents_for_Rescinded_Transaction,Succession_Profile,Talent_Assessment,Employee_Contract_Data,Contracts_for_Terminated_Workers,Collective_Agreement_Data,Probation_Period_Data,Extended_Employee_Contract_Details,Feedback_Received,User_Account,Career,Account_Provisioning,Background_Check_Data,Contingent_Worker_Tax_Authority_Form_Information"	"Organization_Support_Role_Data,Location_Hierarchies,Cost_Centers,Cost_Center_Hierarchies,Companies,Company_Hierarchies,Matrix_Organizations,Pay_Groups,Regions,Region_Hierarchies,Supervisory_Organizations,Teams,Custom_Organizations,Funds,Fund_Hierarchies,Grants,Grant_Hierarchies,Business_Units,Business_Unit_Hierarchies,Programs,Program_Hierarchies,Gifts,Gift_Hierarchies"
ジョブファミリ	非アクティブなジョブファミリを使用したクエリ "Include_InActive_Job_Families='true'"	"Reference,Job_Profile_Info_Data"	NA
場所	参照オブジェクトを使用したクエリ Location_Type_Reference.ID.Attribute_type='WID' and Location_Type_Reference.ID.Attribute_Value='WIDTEST' 場所名を指定したクエリ Location_Name='HYD' 非アクティブな場所を含むクエリ Exclude_Inactive_Locations='true'	"Reference,Location_Data"	NA
組織	参照オブジェクトを使用したクエリ Organization_Type_Reference.ID.Attribute_type=‘WID’ and Organization_Type_Reference.ID.Attribute_Value=‘WIDTEST’ 非アクティブな組織でクエリを実行する Include_Inactive='true' トランザクションログの条件を使用したクエリ "Transaction_Log_Criteria.Transaction_Date_Range_Data.Updated_From='2020-09-05T12:00:00' and Transaction_Log_Criteria.Transaction_Date_Range_Data.Updated_Through='2021-09-05T16:00:00'" "Transaction_Log_Criteria.Transaction_Date_Range_Data.Updated_From='2020-09-05T12:00:00' and Transaction_Log_Criteria.Transaction_Date_Range_Data.Updated_Through='2021-09-05T16:00:00'" "Transaction_Log_Criteria.Transaction_Type_References.Transaction_Type_Reference.Attribute_type='WID' and Transaction_Log_Criteria.Transaction_Type_References.Transaction_Type_Reference.Attribute_Value='WIDTEST'	"Roles_Data,Hierarchy_Data,Supervisory_Data,Staffing_Restrictions_Data"	NA