---
schema_version: "1"
id: 98b06ed947e97ef81d2d615a5d71b863642407728a7e9f69a81885fecde19bef
title: ฟังก์ชันผู้ใช้
collection: tableau
version: next
locale: th-th
portal_url: https://docs.salesforce.com/tableau/next/th-th/pro/desktop/functions_functions_user.md
canonical_url: https://help.tableau.com/v0.0/pro/desktop/th-th/functions_functions_user.htm
source_site: help.tableau.com
content_type: documentation
content_hash: b4161ea2a30ae354a4afb9c3fc8e0fd6a6b1b5bb6e2fddf0686fb7af7ed566da
description: Reference for user functions used to build user filters and row-level security.
---
[ข้ามไปยังเนื้อหาหลัก](#main-content)

# ฟังก์ชันผู้ใช้

บทความนี้จะอธิบายฟังก์ชันผู้ใช้และการใช้งานใน Tableau และจะสาธิตวิธีสร้างการคำนวณผู้ใช้โดยใช้ตัวอย่าง

## ทำไมจึงควรใช้ฟังก์ชันผู้ใช้

ฟังก์ชันผู้ใช้สามารถใช้เพื่อสร้างตัวกรองผู้ใช้หรือตัวกรองการรักษาความปลอดภัยระดับแถวที่ส่งผลต่อการแสดงภาพที่เผยแพร่ไปยัง Tableau Server หรือ Tableau Cloud เพื่อให้เฉพาะบางคนเท่านั้นที่สามารถมองเห็นการแสดงภาพของคุณได้

ตัวอย่างเช่น หากคุณมีการแสดงภาพที่แสดงถึงประสิทธิภาพการขายของพนักงานแต่ละคนในแผนกของคุณที่เผยแพร่บน Tableau Server หรือ Tableau Cloud คุณอาจต้องอนุญาตให้พนักงานดูตัวเลขการขายของตนเองเท่านั้น เมื่อเข้าถึงการแสดงภาพดังกล่าว

ในกรณีนี้ คุณสามารถใช้ฟังก์ชัน ISMEMBEROF เพื่อสร้าฟิลด์ที่คืนค่าเป็นจริง หากชื่อผู้ใช้ของบุคคลที่เข้าสู่ระบบเซิร์ฟเวอร์เป็นสมาชิกของกลุ่มที่ระบุ (บนเซิร์ฟเวอร์) เช่น กลุ่ม "Managers" เป็นต้น จากนั้น เมื่อคุณกรองมุมมองโดยใช้ฟิลด์ที่คำนวณนี้ เฉพาะบุคคลที่เป็นส่วนหนึ่งของกลุ่มดังกล่าวเท่านั้นที่สามารถดูข้อมูลได้

การคำนวณในกรณีนี้อาจมีลักษณะดังนี้:

ISMEMBEROF('Managers')

หมายเหตุ: หากชื่อกลุ่มหรือชื่อผู้ใช้ของคุณมีอักขระที่ไม่ใช่ตัวอักษรและตัวเลข คุณต้องใช้การเข้ารหัส HTML URL สำหรับอักขระพิเศษเมื่อใช้ฟังก์ชัน

อนุญาตให้ใช้อักขระพิเศษบางตัวโดยไม่มีการเข้ารหัส HTML URL เช่น ขีดล่าง วงเล็บ และเครื่องหมายอัศเจรีย์ `_ ( ) !` ส่วนอักขระอื่นๆ อีกมากมายนั้นต้องเข้ารหัส

ตัวอย่างเช่น ฟังก์ชัน `ISMEMBEROF("USERS+")` จำเป็นต้องเขียนเป็น `ISMEMBEROF("USERS%2B")` เนื่องจาก '%2B' คือการเข้ารหัส HTML URL สำหรับสัญลักษณ์ '+' หากต้องการข้อมูลเกี่ยวกับการเข้ารหัส HTML URL โปรดดู [การอ้างอิงการเข้ารหัส HTML URL](https://www.w3schools.com/tags/ref_urlencode.asp) ที่ไซต์ W3schools Web Developer

### ฟังก์ชันแอตทริบิวต์ผู้ใช้เพื่อควบคุมและปรับแต่งการเข้าถึงข้อมูล

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

ข้อควรพิจารณาขณะที่เขียน:

- ฟังก์ชันแอตทริบิวต์ของผู้ใช้สามารถรวมอยู่ในเนื้อหาที่เขียนใน Tableau Desktop, Tableau Cloud หรือ Tableau Server
- ระบบจะรองรับฟังก์ชันแอตทริบิวต์ผู้ใช้ในเนื้อหาที่เข้าถึงผ่าน OIDC หรือเวิร์กโฟลว์การลงชื่อเพียงครั้งเดียว (SSO) ของ SAML ใน Tableau Cloud และ Tableau Server
- ดูตัวอย่างเนื้อหาด้วยฟังก์ชันเหล่านี้ไม่ได้เมื่อเขียนใน Tableau Desktop, Tableau Cloud หรือ Tableau Server ฟังก์ชันแอตทริบิวต์ผู้ใช้จะแสดงผลค่า NULL หรือ FALSE เพื่อให้แน่ใจว่าฟังก์ชันแอตทริบิวต์ผู้ใช้ทำงานตามที่คาดไว้ เราขอแนะนำให้คุณตรวจสอบเนื้อหาหลังจากเผยแพร่แล้ว หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับเวิร์กโฟลว์ที่มีฟังก์ชันผู้ใช้เหล่านี้ โปรดดูที่ความช่วยเหลือในหัวข้อ [Tableau Embedding API v3](https://help.tableau.com/current/api/embedding_api/th-th/docs/embedding_api_user_attributes.html), Tableau Cloud [OIDC](https://help.tableau.com/current/online/th-th/openid_auth_server_config.htm#user_attributes) หรือหัวข้อ [SAML](https://help.tableau.com/current/online/th-th/saml_config_site.htm#user_attributes) หรือ Tableau Server [OIDC](https://help.tableau.com/current/server/th-th/openid_auth_requirements.htm#user_attributes) หรือหัวข้อ [SAML](https://help.tableau.com/current/server/th-th/config_saml.htm#user_attributes)
- ไม่สามารถใช้ฟังก์ชันแอตทริบิวต์ผู้ใช้ในเวิร์กโฟลว์ที่ใช้ Tableau Bridge ได้

#### เวิร์กโฟลว์ 1: เวิร์กโฟลว์การฝัง (JWT และแอปที่เชื่อมต่อของ Tableau หรือโทเค็นการเข้าถึงแบบรวม)

ฟังก์ชันแอตทริบิวต์ของผู้ใช้ (USERATTRIBUTE และ USERATTRIBUTEINCLUDES) ในเนื้อหาแบบฝังสามารถเปิดใช้งานผ่านแอตทริบิวต์ของผู้ใช้ที่ส่งผ่านในโทเค็นเว็บ JSON (JWT) ผ่าน:

- [แอปที่เชื่อมต่อของ Tableau](https://help.tableau.com/current/online/th-th/connected_apps.htm) บน Tableau Cloud
- [แอปที่เชื่อมต่อของ Tableau](https://help.tableau.com/current/online/th-th/connected_apps.htm) บน Tableau Server 2025.1 และใหม่กว่า
- [โทเค็นการเข้าถึงแบบรวม](https://help.tableau.com/current/api/cloud-manager/th-th/docs/unified_access_tokens.html)บน Tableau Cloud ตั้งแต่เดือนธันวาคม 2025

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

**หมายเหตุ:**

- โปรดตรวจสอบความช่วยเหลือสำหรับ[การฝัง API ของ Tableau v3](https://help.tableau.com/current/api/embedding_api/th-th/docs/embedding_api_user_attributes.html#known-issues) เพื่อดู_ปัญหาที่ทราบ_และ_ข้อจำกัด_ ซึ่งอาจส่งผลต่อเวิร์กโฟลว์ของคุณ
- หากต้องการให้แอตทริบิวต์ผู้ใช้ทํางานได้:
    
    - ใน Tableau Cloud ผู้ดูแลต้อง 1) เปิดใช้งานการตั้งค่าควบคุมการเข้าถึงของผู้ใช้ในเวิร์กโฟลว์การตรวจสอบสิทธิ์ 2) กำหนดค่าแอปที่เชื่อมต่อหรือโทเค็นการเข้าถึงแบบรวมด้วยค่าการอ้างสิทธิ์แอตทริบิวต์ผู้ใช้ใน JWT และ 3) ผู้เขียนเนื้อหาต้องสร้างฟังก์ชันแอตทริบิวต์ผู้ใช้ (USERATTRIBUTE หรือ USERATTRIBUTEINCLUDES)
    - ใน Tableau Server ผู้ดูแลไซต์ต้อง 1) เปิดใช้งานความสามารถของแอตทริบิวต์ผู้ใช้ผ่านเมธอด[อัปเดตไซต์](https://help.tableau.com/current/api/rest_api/th-th/REST/rest_api_ref_site.htm#update_site) โดยใช้ Tableau REST API และเปิดใช้งานตัวเลือก TSM [features.VizDataServiceClientEnable](https://help.tableau.com/current/server/th-th/cli_configuration-set_tsm.htm#uaf) (ไม่บังคับ) 2) กำหนดค่าแอปที่เชื่อมต่อด้วยค่าการอ้างสิทธิ์แอตทริบิวต์ผู้ใช้ใน JWT และ 3) ผู้เขียนเนื้อหาต้องสร้าง[ฟังก์ชันแอตทริบิวต์ผู้ใช้](https://help.tableau.com/current/pro/desktop/th-th/functions_functions_user.htm#user_attributes)
        
        หากต้องการข้อมูลเพิ่มเติม โปรดดู[ปรับแต่งและควบคุมการเข้าถึงข้อมูลโดยใช้แอตทริบิวต์ผู้ใช้](https://help.tableau.com/current/api/embedding_api/th-th/docs/embedding_api_user_attributes.html) ในความช่วยเหลือเกี่ยวกับการฝัง API ของ Tableau v3

#### เวิร์กโฟลว์ 2: เวิร์กโฟลว์เนื้อหาที่มีการเข้าสู่ระบบ SAML หรือ OIDC โดยตรง

นอกเหนือจากเวิร์กโฟลว์การฝังที่อธิบายไว้ข้างต้นแล้ว ความสามารถของฟังก์ชันแอตทริบิวต์ผู้ใช้จะขยายไปยังเวิร์กโฟลว์การฝังและไม่ฝังเพิ่มเติมอีกด้วย ฟังก์ชันแอตทริบิวต์ผู้ใช้ในเนื้อหาสามารถเปิดใช้งานผ่านแอตทริบิวต์ผู้ใช้ที่ส่งผ่านในการอ้างสิทธิ์ OIDC หรือการยืนยัน SAML ที่บันทึกไว้เมื่อผู้ใช้เข้าสู่ระบบเพื่อเข้าถึงเนื้อหา หากได้รับการกำหนดค่าให้เข้าสู่ระบบโดยใช้ OIDC หรือ SAML SSO เมื่อแอตทริบิวต์ถูกส่งผ่านจากการอ้างสิทธิ์หรือการยืนยัน เนื้อหาที่เขียนด้วยฟังก์ชันเหล่านี้ (USERATTRIBUTE และ USERATTRIBUTEINCLUDES) จะสามารถควบคุมและปรับแต่งข้อมูลที่แสดงต่อผู้ใช้ได้

**หมายเหตุ:**

- ดูหัวข้อ [Tableau Cloud OIDC](https://help.tableau.com/current/online/th-th/openid_auth_server_config.htm#user_attributes_known_issues) หรือ [SAML](https://help.tableau.com/current/online/th-th/saml_config_site.htm#user_attributes_known_issues) หรือหัวข้อ [Tableau Server OIDC](https://help.tableau.com/current/server/th-th/openid_auth_requirements.htm#user_attributes) หรือ [SAML](https://help.tableau.com/current/server/th-th/config_saml.htm#user_attributes) (ตั้งแต่ Tableau Server 2026.2) สําหรับปัญหาและข้อจํากัดที่ทราบ ซึ่งอาจส่งผลต่อเวิร์กโฟลว์ของคุณ
- เพื่อให้แอตทริบิวต์ผู้ใช้ทํางานได้ ผู้ดูแลระบบจะต้องรวมแอตทริบิวต์ผู้ใช้ในการอ้างสิทธิ์ OIDC หรือการยืนยัน SAML และผู้เขียนเนื้อหาต้องสร้างฟังก์ชันแอตทริบิวต์ผู้ใช้ (USERATTRIBUTE หรือ USERATTRIBUTEINCLUDES)

## ฟังก์ชันผู้ใช้ที่มีอยู่ใน Tableau

### FULLNAME( )

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>ไวยากรณ์</td><td><code>FULLNAME( )</code></td></tr><tr><td>เอาต์พุต</td><td>สตริง</td></tr><tr><td>คำนิยาม</td><td><p>แสดงชื่อเต็มสำหรับผู้ใช้ปัจจุบัน</p></td></tr><tr><td>ตัวอย่าง</td><td><pre>FULLNAME( )</pre><p>สิ่งนี้จะแสดงชื่อเต็มของผู้ใช้ที่เข้าสู่ระบบ เช่น “Hamlin Myrer”</p><pre xml:space="preserve">[Manager] = FULLNAME( )</pre><p>หากผู้จัดการ “Hamlin Myrer” เข้าสู่ระบบ ตัวอย่างนี้จะแสดงค่า True ต่อเมื่อฟิลด์ “ผู้จัดการ” ในมุมมองมีชื่อ “Hamlin Myrer” เท่านั้น</p></td></tr><tr><td>หมายเหตุ</td><td><p>ฟังก์ชันนี้จะตรวจสอบรายการต่อไปนี้</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> และ <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>: ชื่อเต็มของผู้ใช้ที่เข้าสู่ระบบ</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>: ชื่อเต็มในเครื่องหรือเครือข่ายสำหรับผู้ใช้</li></ul><p><b>ตัวกรองผู้ใช้</b></p><p>เมื่อใช้เป็นตัวกรอง ฟิลด์ที่คำนวณเช่น <code>[Username field] = FULLNAME( )</code> สามารถใช้สร้างตัวกรองผู้ใช้ที่แสดงเฉพาะข้อมูลที่เกี่ยวข้องกับบุคคลที่เข้าสู่ระบบเซิร์ฟเวอร์</p></td></tr></tbody></table>

### ISFULLNAME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>ไวยากรณ์</td><td><code>ISFULLNAME("User Full Name")</code></td></tr><tr><td>เอาต์พุต</td><td>บูลีน</td></tr><tr><td>คำนิยาม</td><td><p>แสดงค่า <code>TRUE</code> หากชื่อเต็มของผู้ใช้ปัจจุบันตรงกับชื่อเต็มที่ระบุ หรือแสดงค่า <code>FALSE</code> หากไม่ตรงกัน</p></td></tr><tr><td>ตัวอย่าง</td><td><pre>ISFULLNAME("Hamlin Myrer")</pre></td></tr><tr><td>หมายเหตุ</td><td><p>อาร์กิวเมนต์ <code>&lt;"User Full Name"&gt;</code> ต้องเป็นสตริงตามตัวอักษร ไม่ใช่ฟิลด์</p><p>ฟังก์ชันนี้จะตรวจสอบรายการต่อไปนี้</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> และ <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>: ชื่อเต็มของผู้ใช้ที่เข้าสู่ระบบ</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>: ชื่อเต็มในเครื่องหรือเครือข่ายสำหรับผู้ใช้</li></ul></td></tr></tbody></table>

### ISMEMBEROF

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>ไวยากรณ์</td><td><code>ISMEMBEROF("Group Name")</code></td></tr><tr><td>เอาต์พุต</td><td>บูลีนหรือค่า null</td></tr><tr><td>คำนิยาม</td><td><p>แสดงค่า <code>TRUE</code> หากบุคคลที่ใช้ Tableau เป็นสมาชิกในกลุ่มที่ตรงกับสตริงที่กำหนด <code>FALSE</code> หากไม่ได้เป็นสมาชิกและ <code>NULL</code> หากไม่ได้เข้าสู่ระบบ</p></td></tr><tr><td>ตัวอย่าง</td><td><pre>ISMEMBEROF('Superstars')</pre><pre>ISMEMBEROF('domain.lan\Sales')</pre></td></tr><tr><td>หมายเหตุ</td><td><p>อาร์กิวเมนต์ <code>&lt;"Group Full Name"&gt;</code> ต้องเป็นสตริงตามตัวอักษร ไม่ใช่ฟิลด์</p><p>หากผู้ใช้เข้าสู่ระบบ <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> หรือ <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> ความเป็นสมาชิกกลุ่มจะถูกกำหนดโดยกลุ่ม Tableau ฟังก์ชันจะแสดงค่า TRUE หากสตริงที่กำหนดคือ “ผู้ใช้ทั้งหมด”</p><p>ฟังก์ชัน <code>ISMEMBEROF( )</code> จะยอมรับโดเมน Active Directory เช่นกัน โดยจะต้องแสดงโดเมน Active Directory ในการคำนวณพร้อมกับชื่อกลุ่ม</p><p>หากมีการเปลี่ยนแปลงการเป็นสมาชิกกลุ่มของผู้ใช้ การเปลี่ยนแปลงข้อมูลที่อิงตามการเป็นสมาชิกกลุ่มจะสะท้อนให้เห็นในเวิร์กบุ๊กหรือมุมมองในเซสชันใหม่ เซสชันที่มีอยู่จะแสดงข้อมูลเก่า</p></td></tr></tbody></table>

### ISUSERNAME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>ไวยากรณ์</td><td><code>ISUSERNAME("username")</code></td></tr><tr><td>เอาต์พุต</td><td>บูลีน</td></tr><tr><td>คำนิยาม</td><td>แสดงค่า <code>TRUE</code> หากชื่อผู้ใช้ปัจจุบันตรงกับชื่อผู้ใช้ที่ระบุหรือ <code>FALSE</code> หากไม่ตรงกัน</td></tr><tr><td>ตัวอย่าง</td><td><pre xml:space="preserve">ISUSERNAME("hmyrer")</pre></td></tr><tr><td>หมายเหตุ</td><td><p>อาร์กิวเมนต์ <code>&lt;"username"&gt;</code> ต้องเป็นสตริงตามตัวอักษร ไม่ใช่ฟิลด์</p><p>ฟังก์ชันนี้จะตรวจสอบรายการต่อไปนี้</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> และ <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>: ชื่อผู้ใช้ของผู้ใช้ที่เข้าสู่ระบบ</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>: ชื่อผู้ใช้ในเครื่องหรือเครือข่ายสำหรับผู้ใช้</li></ul></td></tr></tbody></table>

### USERDOMAIN( )

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>ไวยากรณ์</td><td><code>USERDOMAIN(&nbsp;)</code></td></tr><tr><td>เอาต์พุต</td><td>สตริง</td></tr><tr><td>คำนิยาม</td><td>แสดงโดเมนสำหรับผู้ใช้ปัจจุบัน</td></tr><tr><td>หมายเหตุ</td><td><p>ฟังก์ชันนี้จะตรวจสอบรายการต่อไปนี้</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> และ <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>: โดเมนผู้ใช้ของผู้ใช้ที่เข้าสู่ระบบ</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>: โดเมนในเครื่องหากผู้ใช้อยู่ในโดเมน</li></ul></td></tr></tbody></table>

### USERNAME( )

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>ไวยากรณ์</td><td><code>USERNAME( )</code></td></tr><tr><td>เอาต์พุต</td><td>สตริง</td></tr><tr><td>คำนิยาม</td><td>แสดงชื่อผู้ใช้สำหรับผู้ใช้ปัจจุบัน</td></tr><tr><td>ตัวอย่าง</td><td><pre xml:space="preserve">USERNAME( )</pre><p>สิ่งนี้จะแสดงชื่อผู้ใช้ของผู้ใช้ที่เข้าสู่ระบบ เช่น “hmyrer”</p><pre xml:space="preserve">[Manager] = USERNAME( )</pre><p>หากผู้จัดการ “hmyrer” เข้าสู่ระบบ ตัวอย่างนี้จะแสดงค่า True ต่อเมื่อฟิลด์ “ผู้จัดการ” ในมุมมองมีชื่อ “hmyrer” เท่านั้น</p></td></tr><tr><td>หมายเหตุ</td><td><p>ฟังก์ชันนี้จะตรวจสอบรายการต่อไปนี้</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> และ <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>: ชื่อผู้ใช้ของผู้ใช้ที่เข้าสู่ระบบ</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>: ชื่อผู้ใช้ในเครื่องหรือเครือข่ายสำหรับผู้ใช้</li></ul><p><b>ตัวกรองผู้ใช้</b></p><p>เมื่อใช้เป็นตัวกรอง ฟิลด์ที่คำนวณเช่น <code>[Username field] = USERNAME( )</code> สามารถใช้สร้างตัวกรองผู้ใช้ที่แสดงเฉพาะข้อมูลที่เกี่ยวข้องกับบุคคลที่เข้าสู่ระบบเซิร์ฟเวอร์</p></td></tr></tbody></table>

### USERATTRIBUTE

**หมายเหตุ**: ก่อนจะใช้ฟังก์ชันนี้ โปรดดู[ฟังก์ชันแอตทริบิวต์ผู้ใช้เพื่อควบคุมและปรับแต่งการเข้าถึงข้อมูล](#user_attributes) หากต้องการข้อมูลเพิ่มเติม โปรดดู[การตรวจสอบสิทธิ์และมุมมองแบบฝัง](https://help.tableau.com/current/api/embedding_api/th-th/docs/embedding_api_auth.html)ในความช่วยเหลือสำหรับ Embedding API v3, หัวข้อ [OIDC](https://help.tableau.com/current/online/th-th/openid_auth_server_config.htm#user_attributes) หรือ [SAML](https://help.tableau.com/current/online/th-th/saml_config_site.htm#user_attributes) ของ Tableau Cloud หรือหัวข้อ [OIDC](https://help.tableau.com/current/server/th-th/openid_auth_requirements.htm#user_attributes) หรือ [SAML](https://help.tableau.com/current/server/th-th/config_saml.htm#user_attributes) ของ Tableau Server ทั้งนี้ขึ้นอยู่กับเวิร์กโฟลว์ของคุณ

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>ไวยากรณ์</td><td><code>USERATTRIBUTE('attribute_name')</code></td></tr><tr><td>เอาต์พุต</td><td>สตริงหรือค่า null</td></tr><tr><td>คำนิยาม</td><td><p>หาก <code>&lt;'attribute_name'&gt;</code> เป็นส่วนหนึ่งของ JWT (ผ่านแอปที่เชื่อมต่อ, UAT, การอ้างสิทธิ์ OIDC) หรือการตอบสนอง XML ของ SAML ที่ส่งไปยัง Tableau การคำนวณจะส่งคืนค่าแรกของ <code>&lt;'attribute_name'&gt;</code>.</p><p>แสดงค่า null หาก <code>&lt;'attribute_name'&gt;</code> ไม่มีอยู่</p></td></tr><tr><td>ตัวอย่าง</td><td><p>สมมติว่า "Region" เป็นแอตทริบิวต์ผู้ใช้ที่รวมอยู่ในการตอบกลับ JWT หรือ SAML และส่งไปยัง Tableau</p><p>ในฐานะผู้เขียนเวิร์กบุ๊ก คุณสามารถตั้งค่าการแสดงเป็นภาพเพื่อกรองข้อมูลตามภูมิภาคที่ระบุได้ ในตัวกรองนั้น คุณสามารถอ้างอิงการคำนวณต่อไปนี้</p><pre xml:space="preserve">[Region] = USERATTRIBUTE("Region")</pre><p>เมื่อ User2 จากภูมิภาคตะวันตกดูการแสดงเป็นภาพแบบฝัง Tableau จะแสดงข้อมูลที่เหมาะสมสำหรับภูมิภาคตะวันตกเท่านั้น</p></td></tr><tr><td>หมายเหตุ</td><td>คุณสามารถใช้ฟังก์ชัน <code>USERATTRIBUTEINCLUDES</code> หากคาดหวัง <code>&lt;'attribute_name'&gt;</code> เพื่อแสดงผลค่าหลายค่า</td></tr></tbody></table>

### USERATRIBUTEINCLUDES

**หมายเหตุ**: ก่อนจะใช้ฟังก์ชันนี้ โปรดดู[ฟังก์ชันแอตทริบิวต์ผู้ใช้เพื่อควบคุมและปรับแต่งการเข้าถึงข้อมูล](#user_attributes) หากต้องการข้อมูลเพิ่มเติม โปรดดู[การตรวจสอบสิทธิ์และมุมมองแบบฝัง](https://help.tableau.com/current/api/embedding_api/th-th/docs/embedding_api_auth.html)ในความช่วยเหลือสำหรับ Embedding API v3, หัวข้อ [OIDC](https://help.tableau.com/current/online/th-th/openid_auth_server_config.htm#user_attributes) หรือ [SAML](https://help.tableau.com/current/online/th-th/saml_config_site.htm#user_attributes) ของ Tableau Cloud หรือหัวข้อ [OIDC](https://help.tableau.com/current/server/th-th/openid_auth_requirements.htm#user_attributes) หรือ [SAML](https://help.tableau.com/current/server/th-th/config_saml.htm#user_attributes) ของ Tableau Server ทั้งนี้ขึ้นอยู่กับเวิร์กโฟลว์ของคุณ

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>ไวยากรณ์</td><td><code>USERATTRIBUTEINCLUDES('attribute_name', 'expected_value')</code></td></tr><tr><td>เอาต์พุต</td><td>บูลีน</td></tr><tr><td>คำนิยาม</td><td><p>แสดงค่า <code>TRUE</code> หากทั้งสองข้อต่อไปนี้เป็น True:</p><ul><li><code>&lt;'attribute_name'&gt;</code> เป็นส่วนหนึ่งของ JWT (ผ่านแอปที่เชื่อมต่อ, UAT, การอ้างสิทธิ์ OIDC) หรือการตอบสนอง XML ของ SAML ที่ส่งไปยัง Tableau</li><li>หนึ่งในค่า <code>&lt;'attribute_name'&gt;</code> เท่ากับ <code>&lt;'expected_value'&gt;</code></li></ul><p>แสดง <code>FALSE</code> มิฉะนั้น</p></td></tr><tr><td>ตัวอย่าง</td><td><p>สมมติว่า "Region" เป็นแอตทริบิวต์ผู้ใช้ที่รวมอยู่ในการตอบกลับ JWT หรือ SAML และส่งไปยัง Tableau</p><p>ในฐานะผู้เขียนเวิร์กบุ๊ก คุณสามารถตั้งค่าการแสดงเป็นภาพเพื่อกรองข้อมูลตามภูมิภาคที่ระบุได้ ในตัวกรองนั้น คุณสามารถอ้างอิงการคำนวณต่อไปนี้</p><pre xml:space="preserve">USERATTRIBUTEINCLUDES('Region', [Region])</pre><p>หาก User2 จากภูมิภาคตะวันตกเข้าถึงการแสดงเป็นภาพแบบฝัง Tableau จะตรวจสอบว่าแอตทริบิวต์ผู้ใช้ Region ตรงกับค่าฟิลด์ [Region] ค่าใดค่าหนึ่ง เมื่อเป็นจริง การแสดงเป็นภาพจะแสดงข้อมูลที่เหมาะสม</p><p>เมื่อ User3 จากภูมิภาคทางเหนือเข้าถึงการแสดงเป็นภาพเดียวกัน จะไม่สามารถเห็นข้อมูลใดๆ ได้เนื่องจากไม่มีค่าที่ตรงกับค่าในฟิลด์ [Region]</p></td></tr></tbody></table>

## สร้างการคำนวณผู้ใช้

การคำนวณผู้ใช้จะทำงานร่วมกับผู้ใช้และกลุ่มที่คุณตั้งค่าไว้บน Tableau Server หรือ Tableau Cloud โดยตรง คุณสามารถสร้างการคำนวณผู้ใช้เพื่อใช้เป็นตัวกรอง ซึ่งผู้ใช้จะเห็นเฉพาะข้อมูลที่เกี่ยวข้องกับตนเองเท่านั้น

ตัวอย่างเช่น หากคุณมีแผนที่ที่คล้ายคลึงกับแผนที่ต่อไปนี้ ซึ่งแสดงข้อมูลการขายสำหรับ 48 รัฐในสหรัฐอเมริกา คุณสามารถสร้างการคำนวณผู้ใช้เพื่อแสดงเฉพาะบางส่วนของแผนที่ที่เกี่ยวข้องกับผู้ใช้แต่ละราย เช่น ข้อมูลที่เกี่ยวข้องกับผู้จัดการระดับภูมิภาคเทียบกับผู้จัดการระดับประเทศ (ผู้จัดการระดับประเทศควรดูข้อมูลสำหรับทั้งประเทศได้ ในขณะที่ผู้จัดการระดับภูมิภาคควรดูได้เฉพาะข้อมูลสำหรับภูมิภาคที่พวกเขาจัดการเท่านั้น)

เมื่อผู้จัดการระดับประเทศเข้าสู่ระบบ ก็จะเห็นการแสดงภาพดังต่อไปนี้:

![แผนที่แบบเต็มของสหรัฐอเมริกาแสดงยอดขายทั้งหมดตามภูมิภาค](/tableau/next/th-th/pro/desktop/th-th/Img/userfunctions1.png)

เมื่อผู้จัดการภูมิภาคตะวันตกเข้าสู่ระบบ ก็จะเห็นเฉพาะยอดขายในภูมิภาคของตนเท่านั้น:

![แผนที่รหัสสีของสหรัฐอเมริกาฝั่งตะวันตก โดยรัฐแคลิฟอร์เนียมีปริมาณการขายสูงสุด](/tableau/next/th-th/pro/desktop/th-th/Img/userfunctions2.png)

หากต้องการสร้างฟังก์ชันผู้ใช้ที่ทำงานคล้ายกับตัวอย่างนี้ ให้ดำเนินการตามขั้นตอนด้านล่าง

### ก่อนที่คุณจะเริ่มต้น

หากต้องการดำเนินการตามตัวอย่างนี้ คุณต้องมีสิทธิ์เข้าถึง Tableau Server หรือ Tableau Cloud คุณต้องเป็นผู้ดูแลเซิร์ฟเวอร์หรือไซต์

### ขั้นตอนที่ 1: สร้างผู้ใช้และกลุ่ม

1. เข้าสู่ระบบ Tableau Server หรือ Tableau Cloud
2. ใน Tableau Server หรือ Tableau Cloud ให้เพิ่มผู้ใช้ดังนี้:
    
    - Sadie Pawthorne
    - Chuck Magee
    - Fred Suzuki
    - Roxanne Rodriguez
    
    ดูข้อมูลเพิ่มเติมได้ที่[เพิ่มผู้ใช้ไปยังไซต์](http://onlinehelp.tableau.com/current/server/th-th/sites_addusers.htm)ในความช่วยเหลือ Tableau Server
3. สร้างกลุ่มใหม่ที่ชื่อว่า **National Managers**
    
    หากต้องการข้อมูลเพิ่มเติม โปรดดู [สร้างกลุ่มในเครื่อง](http://onlinehelp.tableau.com/current/server/th-th/groups_create_local.htm) ในความช่วยเหลือ Tableau Server
4. เพิ่มตัวคุณเองไปยังกลุ่ม National Managers
    
    หากต้องการข้อมูลเพิ่มเติม โปรดดู [เพิ่มผู้ใช้ไปยังกลุ่ม](http://onlinehelp.tableau.com/current/server/th-th/users_add_group.htm) ในความช่วยเหลือ Tableau Server

### ขั้นตอนที่ 2: สร้างการแสดงผล

1. เปิด Tableau Desktop และเชื่อมต่อแหล่งข้อมูล**ตัวอย่าง - Superstore** ที่มาพร้อมกับ Tableau
2. คลิกแท็บแหล่งข้อมูลที่มุมล่างซ้ายของพื้นที่ทำงาน
3. บนหน้าแหล่งข้อมูล จากแผงการเชื่อมต่อทางด้านซ้าย ให้ลากชีต People ไปยังพื้นที่การรวม
4. คลิกไอคอนรวมแล้วเลือกซ้าย
    
    ![สร้างการรวมทางด้านซ้าย](/tableau/next/th-th/pro/desktop/th-th/Img/user_functions1.gif)
5. ไปที่เวิร์กชีตใหม่
6. ในแผง**ข้อมูล**ในส่วนมิติข้อมูล ให้ดับเบิลคลิกที่รัฐ
    
    ระบบจะสร้างมุมมองแผนที่ขึ้น
7. ในแผง**ข้อมูล**ในส่วนการวัดผล ให้ลากยอดขายไปที่งสีบนการ์ดเครื่องหมาย
8. บนแถบคอลัมน์ ให้เลือกฟิลด์ลองจิจูดแล้วกด Control (Comman บน Mac) บนแป้นพิมพ์ค้างไว้เพื่อคัดลอก ลากสำเนาไปทางขวาของต้นฉบับบนแถบคอลัมน์
    
    ![สร้างแผนที่แกนคู่ใน Tableau](/tableau/next/th-th/pro/desktop/th-th/Img/user_functions2.gif)
9. บนการ์ด “เครื่องหมาย” ให้คลิกแท็บ**ลองจิจูด**ที่สอง (ด้านล่าง)
10. จากแผง**ข้อมูล** ให้ลากภูมิภาคไปยังสีบนการ์ด “เครื่องหมาย”
    
    มุมมองแผนที่ทางด้านขวาจะอัปเดตเป็นสีใหม่
    
    ![มุมมองแผนที่พร้อมใช้พาเล็ตสีใหม่](/tableau/next/th-th/pro/desktop/th-th/Img/user_functions3.png)
11. บนการ์ด “เครื่องหมาย” ให้คลิกดรอปดาวน์ประเภทของเครื่องหมาย แล้วเลือก**แผนที่**
    
    ![การ์ดเครื่องหมายพร้อมแผนที่ที่เลือก](/tableau/next/th-th/pro/desktop/th-th/Img/user_functions4.png)
12. บนการ์ดเครื่องหมาย ให้คลิก**สี** และภายใต้ส่วนความทึบให้ปรับแถบเลื่อนเป็น 50%
13. บนการ์ด “เครื่องหมาย” ให้คลิกแท็บ**ลองจิจูด** แรก
14. บนการ์ด “เครื่องหมาย” ให้คลิกสี \> แก้ไขสี แล้วเลือก**สีเทา**จากดรอปดาวน์จานสี
    
    มุมมองแผนที่ทางซ้ายจะอัปเดต
    
    ![มุมมองแผนที่พร้อมใช้พาเล็ตสีใหม่](/tableau/next/th-th/pro/desktop/th-th/Img/user_functions5.png)
15. ในแถบคอลัมน์ ให้คลิกขวาที่ฟิลด์**ลองจิจูด**ที่ด้านขวาแล้วเลือกแกนคู่
    
    ![เลือกเมนูคอลัมน์ที่มีแกนคู่](/tableau/next/th-th/pro/desktop/th-th/Img/user_functions7.png)

แผนที่มีลักษณะดังนี้:

![มุมมองแผนที่พร้อมใช้คอลัมน์ใหม่](/tableau/next/th-th/pro/desktop/th-th/Img/user_functions6.png)

### ขั้นตอนที่ 3: สร้างการคำนวณผู้ใช้

1. เลือกการวิเคราะห์ \> สร้างฟิลด์ที่คำนวณ
2. ในตัวแก้ไขการคำนวณที่เปิดขึ้น ให้ทำดังนี้

- ตั้งชื่อฟิลด์ที่คำนวณว่า User Filter (ตัวกรองผู้ใช้)
- ป้อนสูตรต่อไปนี้:
    
    `[Regional Manager] = USERNAME() OR ISMEMBEROF("National Managers")`
    
    การคำนวณนี้จะตรวจสอบว่าบุคคลนั้นรวมอยู่ในฟิลด์ “ภูมิภาค (ผู้คน)” หรือไม่ หรือบุคคลนั้นรวมอยู่ในกลุ่ม National Managers หรือไม่ หากเป็นเช่นนั้น ระบบจะคืนค่าเป็นจริง
- เมื่อเสร็จแล้ว ให้คลิกตกลง

การคำนวณผู้ใช้จะปรากฏในส่วน “มิติข้อมูล” ในแผงข้อมูล คุณสามารถใช้ฟิลด์นี้ในการแสดงเป็นภาพได้มากกว่าหนึ่งรายการ เช่นเดียวกับฟิลด์อื่นๆ

### ขั้นตอนที่ 4: เพิ่มการคำนวณผู้ใช้ไปยังแถบตัวกรอง

1. ที่แผงข้อมูลในส่วน “มิติข้อมูล” ให้ลากการคำนวณผู้ใช้ไปยังแถบตัวกรอง
2. ในกล่องโต้ตอบตัวกรองที่เปิดขึ้น ให้เลือกจริง จากนั้นคลิกตกลง
    
    **หมายเหตุ**: หากคุณไม่ได้เข้าสู่ระบบ Tableau Server หรือ Tableau Cloud ตัวเลือก “จริง” จะไม่ปรากฏให้เห็น ใน Tableau Desktop ให้เข้าสู่ระบบ Tableau Server หรือ Tableau Cloud เพื่อเลือก โปรดดู [เข้าสู่ระบบ Tableau Server หรือ Tableau Cloud จาก Tableau Desktop](https://help.tableau.com/v0.0/pro/desktop/th-th/sign_in_server.htm) หากต้องการข้อมูลเพิ่มเติม

### ขั้นตอนที่ 5: ทดสอบการคำนวณ

1. ใน Tableau Desktop ที่มุมล่างขวาของพื้นที่ทำงาน ให้คลิกเมนูดรอปดาวน์ “กรองเป็นผู้ใช้” แล้วเปลี่ยนผู้ใช้เป็น Sadie Pawthorne
    
    แผนที่จะอัปเดตเพื่อแสดงเฉพาะภูมิภาคตะวันตกของสหรัฐอเมริกา เนื่องจาก Sadie ถูกกำหนดไปยังภูมิภาคตะวันตกในชีต People
2. เลือกเมนูดรอปดาวน์ “กรองเป็นผู้ใช้” อีกครั้ง แล้วเปลี่ยนผู้ใช้เป็น Roxanne Rodriguez
    
    แผนที่จะอัปเดตเพื่อแสดงเฉพาะภูมิภาคตอนกลางของสหรัฐอเมริกา เนื่องจาก Roxanne ถูกกำหนดไปยังภูมิภาคตอนกลางในชีต People
3. เลือกเมนูดรอปดาวน์ “กรองเป็นผู้ใช้” อีกครั้ง แล้วเปลี่ยนผู้ใช้เป็น Chuck Magee
    
    แผนที่จะอัปเดตเพื่อแสดงเฉพาะภูมิภาคตะวันออกของสหรัฐอเมริกา เนื่องจาก Chuck ถูกกำหนดไปยังภูมิภาคตะวันออกในชีต People
4. เลือกเมนูดรอปดาวน์ “กรองเป็นผู้ใช้” อีกครั้ง แล้วเปลี่ยนผู้ใช้เป็น Fred Suzuki
    
    แผนที่จะอัปเดตเพื่อแสดงเฉพาะภูมิภาคตอนใต้ของสหรัฐอเมริกา เนื่องจาก Fred ถูกกำหนดไปยังภูมิตอนใต้ในชีต People
5. เลือกเมนูดรอปดาวน์ “กรองเป็นผู้ใช้” อีกครั้ง แล้วเปลี่ยนผู้ใช้กลับมาเป็นตัวคุณ
    
    แผนที่จะอัปเดตเพื่อแสดงข้อมูลทั้งหมดเนื่องจากคุณเป็นส่วนหนึ่งของกลุ่ม National Managers บนเซิร์ฟเวอร์

ลักษณะการทำงานนี้จะยังคงอยู่เมื่อคุณเผยแพร่มุมมองไปยัง Tableau Server หรือ Tableau Cloud ผู้ใช้ที่ไม่อยู่ในกลุ่ม National Managers หรือในชีต People ในแหล่งข้อมูล ตัวอย่าง Superstore จะเห็นเพียงการแสดงภาพที่ว่างเปล่า

## ดูเพิ่มเติม

[ฟังก์ชันใน Tableau](https://help.tableau.com/v0.0/pro/desktop/th-th/functions.htm)

[ฟังก์ชัน Tableau (ตามหมวดหมู่)](https://help.tableau.com/v0.0/pro/desktop/th-th/functions_all_categories.htm)

[ฟังก์ชัน Tableau (เรียงตามตัวอักษร)](https://help.tableau.com/v0.0/pro/desktop/th-th/functions_all_alphabetical.htm)