OneStream

Summary

ข้อกําหนดเบื้องต้น

ต้องใช้แพลตฟอร์ม OneStream เวอร์ชัน 8.2 หรือสูงกว่า มี ความต้องการของระบบ ที่ต้องตรวจสอบก่อนที่คุณจะติดตั้ง Microsoft Power BI Desktop

รองรับความสามารถ

ตัวเชื่อมต่อ OneStream ช่วยให้สามารถเข้าถึงแอปพลิเคชัน OneStream ของคุณได้อย่างปลอดภัย ด้วยตัวเชื่อมต่อ คุณสามารถ:

• เข้าถึงคิวบ์และข้อมูลเชิงสัมพันธ์จากแอปพลิเคชัน OneStream ลงใน Power BI โดยตรง
• เข้าถึงสมาชิกข้อมูลเมตาและคุณสมบัติ OneStream ทั้งหมดของพวกเขา
• สร้างโครงสร้างลําดับชั้นแบบเต็มของคุณใหม่ใน Power BI ได้อย่างง่ายดาย
• โหลดข้อมูลไปยังบริการของ Power BI โดยอัตโนมัติ

เชื่อมต่อกับ OneStream จาก Power BI Desktop

รับข้อมูล

1. เปิด Power BI Desktop และเลือก รับข้อมูลจากแหล่งข้อมูลอื่น

   

2. พิมพ์ OneStream ในกล่องค้นหาเพื่อค้นหาตัวเชื่อมต่อ OneStream แบบกําหนดเอง

   

3. เลือก OneStream

4. เลือก เชื่อมต่อ

กําหนดค่าตัวเชื่อมต่อ

1. ป้อน URL สภาพแวดล้อม OneStream ของคุณ ตรวจสอบให้แน่ใจว่า URL ของสภาพแวดล้อมถูกป้อนด้วย https:// นําหน้า (ดังที่แสดงในภาพหน้าจอต่อไปนี้) มิฉะนั้น ความพยายามในการเชื่อมต่อจะทํางานไม่ถูกต้อง

   

2. เลือก ตกลง

รับรอง

1. เลือก ลงชื่อเข้าใช้ เพื่อเริ่มกระบวนการรับรองความถูกต้อง

2. การเลือกนี้จะเปลี่ยนเส้นทางและเปิด OneStream Identity Server บนเบราว์เซอร์เริ่มต้นของคุณสําหรับการเข้าสู่ระบบ

3. ลงชื่อเข้าใช้บัญชี OneStream ของคุณ

   

4. หลังจากเข้าสู่ระบบสําเร็จ ให้เลือกเชื่อมต่อ

   

ตัวนําทาง OneStream

หลังจากเข้าสู่ระบบสําเร็จ ตัวเชื่อมต่อ OneStream จะแสดงตัวนําทางที่มีการโทร 4 ประเภท:

• รับคิวบ์
• รับอะแดปเตอร์แบบกําหนดเอง
• รับมิติ
• รับทรัพย์สินสําหรับสมาชิก

อ้างถึง แนวทางปฏิบัติที่ดีที่สุด หากคุณต้องการความช่วยเหลือในการกําหนดค่าฟังก์ชัน

หลังจากเลือกฟังก์ชันที่คุณต้องการใช้แล้ว ให้ทําตามเพื่อโหลดข้อมูล

โหลดข้อมูล

1. ตามข้อกําหนดให้ระบุค่าสําหรับฟังก์ชันที่กําหนด คุณสามารถสลับพารามิเตอร์เป็นพารามิเตอร์ที่ต้องการหรือใช้พารามิเตอร์ทั้งหมดได้หากจําเป็น Power BI แสดงตัวอย่างข้อมูลสําหรับตารางที่จะส่งคืน

2. หลังจากระบุพารามิเตอร์แล้ว ให้โหลดหรือแปลงข้อมูล

   • เลือก โหลด เพื่อโหลดตารางลงในแบบจําลองข้อมูล Power BI Desktop ภายใน
   • เลือก แปลงข้อมูล เพื่อทําการเปลี่ยนแปลงในตารางก่อนที่จะโหลดลงในแบบจําลองข้อมูล Power BI Desktop ภายใน แปลงข้อมูล จะเปิดใช้ตัวแก้ไข Power Query ในหน้าต่างใหม่ที่มีมุมมองตัวแทนของตาราง

3. ถ้าคุณต้องการโหลดตารางเพิ่มเติม ให้ทําซ้ําขั้นตอนก่อนหน้านี้ในการเลือกฟังก์ชัน ให้ค่า และโหลดหรือแปลงตาราง

4. หลังจากที่คุณโหลดแบบจําลองข้อมูล Power BI Desktop แล้ว คุณสามารถสร้างความสัมพันธ์ระหว่างตารางและสร้างรายงานได้

รายละเอียดเกี่ยวกับตัวเชื่อมต่อแบบกําหนดเองของ OneStream

ตัวเชื่อมต่อ OneStream ดึงข้อมูลจากอินสแตนซ์ OneStream โดยใช้ API การถ่ายโอนสถานะที่เป็นตัวแทน (REST)

ตัวเชื่อมต่อ OneStream ดําเนินการเรียก API ทั้งหมดภายใต้ขอบเขตสิทธิ์ของผู้ใช้ที่เข้าสู่ระบบปัจจุบัน ดังนั้นจึงใช้การรักษาความปลอดภัยที่กําหนดไว้สําหรับผู้ใช้ใน OneStream

ตัวเชื่อมต่อ OneStream มีข้อจํากัด 2 ล้านแถวต่อการโทร การดําเนินการคิวรีเกินขีดจํากัดนี้จะทําให้เกิดข้อผิดพลาด

เผยแพร่รายงาน Power BI ไปยังบริการของ Power BI

1. เลือกปุ่ม เผยแพร่ ใน Power BI Desktop เพื่อเผยแพร่ข้อมูล รายงาน และแบบจําลองข้อมูลไปยังบริการของ Power BI บนระบบคลาวด์

2. เลือกพื้นที่ทํางาน Power BI ที่เหมาะสม และเลือก เลือก

   

3. หลังจากการเผยแพร่สําเร็จ ข้อความ "สําเร็จ" พร้อมลิงก์เพื่อนําทางไปยังบริการของ Power BI จะปรากฏขึ้น

   

4. เลือกลิงก์เพื่อดูรายงานทั้งหมดจาก Power BI Desktop ในบริการของ Power BI รวมถึงสร้างแดชบอร์ดในบริการของ Power BI

   

แนวทางปฏิบัติที่ดีที่สุดและฟังก์ชันช่วยได้

แนวทางปฏิบัติที่ดีที่สุดทั่วไป

• โหลดเฉพาะข้อมูลที่จําเป็นเท่านั้น หมายความว่า หากคุณต้องการข้อมูลรวมที่ระดับเดือนเท่านั้น ยิ่งโมเดลมีขนาดเล็กเท่าไร ก็ยิ่งมีประสิทธิภาพมากขึ้นเท่านั้น

• จํากัดจํานวนการแปลงที่คุณทํา ยิ่งคุณทําให้คิวรีซับซ้อนมากเท่าไหร่ ก็ยิ่งมีโอกาสมากขึ้นที่คิวรีจะล้มเหลว

• ใช้ประโยชน์จากตรรกะทางการเงินของ OneStream และมุมมองคิวบ์/อะแดปเตอร์ข้อมูลเพื่อสร้างตารางที่โหลดลงใน Power BI

  ตัวอย่าง: การรวมบัญชีเกี่ยวข้องกับเอนทิตีหลักที่รับเพียง 40% ของค่าของเอนทิตีย่อยอย่างใดอย่างหนึ่ง ตรวจสอบให้แน่ใจว่าตรรกะนี้เสร็จสิ้นใน OneStream และคุณโหลดอะแดปเตอร์ข้อมูลใน Power BI ซึ่งมีค่าที่เติมไว้แล้ว

  การพยายามจําลองตรรกะใน Power BI จะไม่มีประสิทธิภาพอย่างยิ่งและดําเนินการได้ดีกว่าในระบบต้นทาง

การโหลดชุดข้อมูลขนาดใหญ่โดยใช้ลูปในคิวรี M แบบกําหนดเอง

เมื่อโหลดข้อมูลจํานวนมากที่อาจล้มเหลวเนื่องจากขีดจํากัดแถวสูงสุด เราขอแนะนําให้คุณสร้างคิวรีแบบกําหนดเองโดยตรงใน Power BI เพื่อวนซ้ําผ่านมิติ โดยแยกคิวรีออกเป็นหลายคิวรี และรวมข้อมูลจากคิวรีผลลัพธ์ใน Power BI โดยตรง

ตัวอย่างแบบสอบถามต่อไปนี้ดําเนินการเรียกข้อมูล CubeViewMD Data Adapter หลายครั้ง องค์ประกอบหลัก 3 ประการคือ:

• GetCubeViewColumns: ส่งคืนรายการของคอลัมน์ทั้งหมดจากอะแด็ปเตอร์ที่ระบุที่คุณพยายามโหลด คอลัมน์ถูกตั้งค่าด้วยตนเองเพื่อหลีกเลี่ยงการแยกวิเคราะห์แบบไดนามิก ซึ่งมีราคาแพง (ต้องมีการดําเนินการคิวรีเพิ่มเติมหนึ่งครั้ง)

• GetEntities: ดําเนินการ DataAdapter ที่กําหนดค่าเป็น เมธอด - สมาชิก (ดูภาพต่อไปนี้) เพื่อดึงข้อมูลสมาชิกทั้งหมดที่จําเป็นสําหรับมิติ (ในกรณีนี้คือเอนทิตี) คุณสามารถเปลี่ยนสิ่งนี้เพื่อวนซ้ํามิติข้อมูล / สคริปต์สมาชิกที่ต้องการได้

  

• GetCubeViewData: เรียกใช้อะแด็ปเตอร์ CubeViewMD CubeView มีพารามิเตอร์ที่เรียกว่า pbi_param_entityซึ่งเป็นพารามิเตอร์ที่ใช้สําหรับส่งผ่านค่าของ GetEntities เมื่อวนซ้ํา

คุณสามารถใช้โค้ดนี้ในคิวรีแบบกําหนดเองเพื่อเรียกใช้อะแดปเตอร์ข้อมูลที่เลือกในลูปผ่านสคริปต์สมาชิกที่ระบุสําหรับมิติ

let
   GetCubeViewColumns = () as list =>
      let 
            Source = {"Cube","Entity","Parent","Cons","Scenario","Time","StartDate","EndDate","View","Account","Flow","Origin","IC","UD1","UD2","UD3","UD4","UD5","UD6","UD7","UD8","CalcScript","Amount"}
      in
            Source,

   GetEmptyTable = () as table =>
      let
            Source = #table(
               GetCubeViewColumns(),
               {
               }
            )
      in 
            Source,

   GetEntities = () as table =>
      let
            Source = OneStream.Navigation("https://your-environment.onestreamcloud.com"),
            YourApp = Source{[Key="YourApp"]}[Data],
            YourCube = YourApp{[Key="YourCube"]}[Data],
            #"Get Custom Adapter" = YourCube{[Key="Get Custom Adapter"]}[Data],
            MemberList = #"Get Custom Adapter"("zzz_PBI_EntityMembers", "Default", null, null),
            MemberListNoDuplicates = Table.Distinct(#"Invoked FunctionGet Custom Adapter1", {"MemberId"}),
            MemberListNamesOnly = Table.RemoveColumns(MemberListNoDuplicates,{"DimTypeId", "DimId", "MemberId", "Description", "SupportsChildren", "IndentLevel"})
      in
            MemberListNamesOnly,


   GetCubeViewData = (EntityName) as table =>
      let
            Source = OneStream.Navigation("https://your-environment.onestreamcloud.com"),
            YourApp = Source{[Key="YourApp"]}[Data],
            YourCube = YourApp{[Key="YourCube"]}[Data],
            #"Get Custom Adapter" = YourCube{[Key="Get Custom Adapter"]}[Data],
            CubeView = try #"Get Custom Adapter"("zzz_PBI_CubeViewAdapter", "Default", null, "pbi_param_entity="& EntityName),
            CubeViewOrDefault = if CubeView[HasError] then GetEmptyTable() else CubeView[Value]
      in
            CubeViewOrDefault,

   List = GetCubeViewColumns(),
   Source = GetEntities(),
   Data = Table.AddColumn(Source, "LoopCubeViewData", each GetCubeViewData([Name])),
   Expand = Table.ExpandTableColumn(Data, "LoopCubeViewData", List),
   Rows = Table.SelectRows(Expand, each [Cube] <> null)
in
   Rows

รับคิวบ์

ฟังก์ชันนี้ดึงข้อมูลจาก OneStream Cube

• พารามิเตอร์ทั้งหมดสามารถระบุได้ผ่านสคริปต์สมาชิก OneStream (ตัวอย่างเช่น 2023.Base สําหรับเวลา) ยกเว้นมุมมองและสกุลเงินที่ต้องใช้สมาชิกคนเดียว
• สกุลเงินหมายถึงมิติการรวมบัญชีใน OneStream ดังนั้นคุณจึงสามารถใช้ Local หรือ Aggregate ได้ เป็นต้น

รับอะแดปเตอร์แบบกําหนดเอง

• ระบุชื่อพื้นที่ทํางานและอะแด็ปเตอร์ (พารามิเตอร์บังคับ)
• ชื่อตารางและพารามิเตอร์เป็นตัวเลือก
• อ้างถึงอะแดปเตอร์แดชบอร์ดที่กําหนดค่าไว้ภายใน OneStream เพื่อให้แน่ใจว่าคุณกําลังแทรกค่าที่ถูกต้อง

รับมิติข้อมูลและรับคุณสมบัติของสมาชิก

• ระบุชนิดมิติ OneStream ที่คุณต้องการดึงข้อมูล
• ระบุชนิดสถานการณ์ ใช้ ค่าเริ่มต้น หรือ ทั้งหมด เพื่อใช้มิติเริ่มต้นของคิวบ์ที่เลือก และดึงคุณสมบัติเริ่มต้น
• รวมคําอธิบายสามารถตั้งค่าเป็น จริง หรือ เท็จ