INFOR.GET.ELEMENT

ฟังก์ชันนี้คืนค่าที่แสดงแอตทริบิวต์ขององค์ประกอบอย่างน้อยหนึ่งแอตทริบิวต์ ตัวอย่างเช่น คำอธิบายภาพ (MEMBER_CAPTION) หรือรหัส (MEMBER_UNIQUE_NAME)

INFOR.GET.ELEMENT รองรับคุณลักษณะเหล่านี้:

  • การเลือกหลายรายการ

    คุณสามารถระบุชื่อเฉพาะหลายๆ ชื่อให้กับองค์ประกอบจากลำดับขั้นเดียวกัน

  • การดึงแอตทริบิวต์ทั้งหมด
  • นิพจน์ MDX

    ตัวอย่างเช่น คุณสามารถระบุ [HierarchyUN].DefaultMember เพื่อคืนค่าแอตทริบิวต์องค์ประกอบเริ่มต้นหรือ elementUN.Children ไปยังองค์ประกอบลูกหลายรายการที่ส่งคืน

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

ไวยากรณ์

ฟังก์ชันมีไวยากรณ์นี้:

=INFOR.GET.ELEMENT("data_connection", "cube", [attribute], "hierarchy" {, element, ...})

ตารางนี้แสดงพารามิเตอร์และคำอธิบายพารามิเตอร์:

พารามิเตอร์ คำอธิบาย
data_connection แสดงถึงชื่อเฉพาะของฐานข้อมูล เป็นสตริงหรือการอ้างอิงเซลล์
คิวบ์ แสดงถึงชื่อเฉพาะของคิวบ์ เป็นสตริงหรือการอ้างอิงเซลล์
แอตทริบิวต์ แสดงถึงชื่อเฉพาะของแอตทริบิวต์ ซึ่งก็คือเมทริกซ์ของสตริงหรือการอ้างอิงเซลล์ หากไม่ได้ระบุ ค่าเริ่มต้นคือ MEMBER_CAPTION
ลำดับขั้น แสดงถึงชื่อเฉพาะของลำดับขั้น เป็นสตริงหรือการอ้างอิงเซลล์ หากไม่ได้ระบุลำดับขั้น ค่าเริ่มต้นจะเป็นสตริงว่าง และลำดับขั้นจะถูกแยกวิเคราะห์จากชื่อเฉพาะขององค์ประกอบ
องค์ประกอบ แสดงถึงชื่อเฉพาะขององค์ประกอบจากลำดับขั้นที่ระบุ ซึ่งก็คือสตริงหรือการอ้างอิงเซลล์จำนวนเท่าใดก็ได้
หมายเหตุ

หากไม่ได้ระบุลำดับขั้น ต้องระบุชื่อเฉพาะขององค์ประกอบในรูปแบบยาว เช่น [PERIOD].[ALL YEARS].[2018]

.

ค่าที่ส่งคืน

ฟังก์ชันนี้จะส่งคืนค่าเซลล์เดียวทุกประเภท

สำหรับลำดับขั้นที่ระบุและถูกต้อง:

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

เมื่อพารามิเตอร์แอตทริบิวต์มีชื่อเฉพาะหลายชื่อ เช่น MEMBER_CAPTION และ MEMBER_UNIQUE_NAME ฟังก์ชันจะส่งกลับอาร์เรย์ขนาด 1 x N ลำดับของแอตทริบิวต์ที่ระบุจะกำหนดลำดับของรายการที่ส่งคืน

ถ้าไม่ได้ระบุอาร์กิวเมนต์ [attribute] ฟังก์ชันจะส่งกลับแอตทริบิวต์ MEMBER_CAPTION

ข้อผิดพลาด

ฟังก์ชันจะส่งกลับค่าความผิดพลาดหากไม่มีพารามิเตอร์ที่จำเป็น หากพารามิเตอร์ที่ระบุไม่ถูกต้อง องค์ประกอบที่เกี่ยวข้องจะถูกข้าม