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

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

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

Where 句の構築方法

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

Request_Criteriaセクション内のすべてのコンテンツは、アクティビティの Where 句に含めるのにふさわしいと見なすことができます。同様に、[ Response_Group ] セクション内の任意のコンテンツを [ Includes ] 要素または [ Excludes ] 要素で使用できます。これは、以下のスクリーンショットで確認できます。

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

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

• Where = "boolean_field = 'true'"
• Where = "Include_Inactive='false' and Enable_Transaction_Log_Lite='true'"

Organization_TypeObjectのような Object 型の場合、Where 句を構築する方法は次のとおりです。

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

ここで = "Organization_Type_Reference.Attribute_type='WID' and Organization_Type_Reference.Attribute_Value='WIDTEST'"。

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

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

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'"。

重要な情報:

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

[Includes] パラメーターと [Excludes] パラメーターを使用する

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" and 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'" と 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' および Organization_Type_Reference.ID.Attribute_Value='WIDTEST' 非アクティブな組織に対するクエリ Include_Inactive='true' トランザクション ログ条件 "Transaction_Log_Criteria.Transaction_Date_Range_Data.Updated_From='2020-09-05T12:00:00' および 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' と 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' と Transaction_Log_Criteria.Transaction_Type_References.Transaction_Type_Reference.Attribute_Value='WIDTEST'	"Roles_Data,Hierarchy_Data,Supervisory_Data,Staffing_Restrictions_Data	NA