CSV 파일 가져오기 지침

사용자 정보가 포함된 CSV(쉼표로 구분된 값) 파일을 만든 후 가져오는 방식으로 사용자 추가 작업을 자동화할 수 있습니다. CSV 파일에 라이선스 수준 및 게시 액세스와 같은 특성을 포함시켜 파일을 가져올 때 사용자에게 적용할 수 있습니다.

사용자를 가져오려면 사이트 관리 페이지 또는 tabcmd 유틸리티를 사용하면 됩니다. tabcmd 사용 시 CSV 파일에 포함된 모든 사용자에게 사이트 역할을 할당하는 옵션이 있습니다. 자세한 내용은 사용자 가져오기 또는 createsiteusers filename.csv 항목을 참조하십시오.

CSV 파일 형식 요구 사항

사용자를 가져오기 위한 CSV 파일을 만들 때 파일이 다음과 같은 형식 요구 사항을 충족하는지 확인하십시오.

  • 파일에 열 머리글이 포함되어 있지 않아야 합니다. Tableau Cloud는 파일의 모든 라인이 사용자를 나타내는 것으로 간주합니다.

  • 파일이 UTF-8 형식이며 BOM(바이트 순서 표시)을 포함합니다.

  • BIG-5 같은 문자 인코딩을 UTF-8로 변환했습니다. 이 작업은 텍스트 편집기에서 파일을 열고 다른 이름으로 저장 명령을 사용하여 수행할 수 있습니다.

  • 사용자 이름에 도메인 구분 기호 이외의 의미를 나타내는 @ 문자가 포함된 경우 해당 기호를 표시할 때 16진수 형식(\0x40)을 사용해야 합니다.

    예를 들어 user@fremont@mycompany.comuser\0x40fremont@mycompany.com이 되어야 합니다.

CSV 파일의 필수 열

각 사용자에 대해 다음과 같은 값이 필요합니다.

  • 사용자 이름: 사용자의 이메일 주소.

추가 CSV 열 옵션

각 사용자에 대해 CSV 파일에 다음과 같은 필드를 포함할 수 있습니다. 표시된 경우, Tableau Cloud는 필드를 사용하지 않지만 필드가 파일에 기록되어야 합니다.

  • User name. 사용자의 이메일 주소입니다. 이것이 유일한 필수 열입니다.

  • Password. Tableau Cloud는 이 필드를 사용하지 않지만 후속 필드를 올바르게 배치하려면 각 행에서 이 필드를 구분 기호로 분리해야 합니다.

  • Display name. Tableau Cloud는 이 필드를 사용하지 않지만 후속 필드를 올바르게 배치하려면 각 행에서 이 필드를 구분 기호로 분리해야 합니다.

  • License level. Creator, Explorer, Viewer 또는 Unlicensed일 수 있습니다.

  • Administrator level. Site 또는 None일 수 있습니다.

  • Publishing capability. 허용 가능한 값은 Yes/True/1 또는 No/False/0입니다. 라이선스 수준이 Creator인 경우 게시 기능은 Yes/True/1이어야 합니다.

CSV 파일 샘플 항목

다음 예제에서는 Explorer 사이트 역할이 부여되고, 사이트 관리자가 아니며, 적절한 콘텐츠 사용 권한이 있는 프로젝트에 게시할 수 있는 사용자를 보여 줍니다.

user1@domain.com,,,Explorer,None,true

Administrator level 열을 변경하면 다음 사용자를 사이트 관리자 Explorer 사이트 역할이 있는 사이트 관리자로 가져올 수 있습니다.

adminuser@domain.com,,,Explorer,Site,true

참고

  • CSV 파일에 사용자 이름 값(이메일 주소)만 포함된 경우 사용자가 사이트 초대 이메일을 받습니다. 사용자는 사이트에 가입하여 자신의 계정을 만들 수 있지만 관리자가 계정을 구성(표시 이름, 라이선스 수준 등)할 때까지 계정에 라이선스가 부여되지 않습니다.

  • 비밀번호(두 번째 값) 및 표시 이름(세 번째 값) 필드는 Tableau Cloud에서 사용되지 않습니다. 이들 필드에 지정한 값은 무시됩니다.

    하지만 사용자의 라이선스와 게시 액세스 권한을 설정하려면 이전 예제에 나와 있는 것처럼 파일에 계속 이들 필드의 구분 기호를 포함해야 합니다.

  • 새 사용자는 Tableau Cloud에 처음 로그인할 때 비밀번호와 표시 이름을 선택해야 합니다. 사용자에게 Tableau 커뮤니티 포럼에 사용하는 것과 같은 Tableau 계정이 있으면 암호도 이미 보유하고 있는 것입니다.

  • CSV 파일에는 인증 유형(Tableau, Google 또는 SAML)을 설정할 수 있는 필드가 포함되지 않습니다. 인증 유형은 파일을 가져올 때 Tableau Cloud에서 지정합니다. 이 설정은 가져온 모든 사용자에게 적용되며 나중에 개별 사용자의 인증 유형을 변경할 수 있습니다.

    참고: 또한 tabcmd를 사용하여 사용자를 가져오고 CSV 파일에 포함된 모든 사용자에게 적용되는 인증 유형 및 사이트 역할을 설정할 수도 있습니다. 자세한 내용은 createsiteusers filename.csv를 참조하십시오.

CSV 설정 및 사이트 역할

사용자에 대한 라이선스 수준, 관리자 및 게시자 설정은 가져오기 프로세스 중에 사용자의 사이트 역할이 설정되는 방식을 결정합니다. 다음 표에서는 이러한 설정이 사이트 역할로 변환되는 방식을 보여 줍니다.

CSV 설정사이트 역할

라이선스 수준=(any)

관리자=시스템

게시자=true

서버 관리자. 이 설정은 Tableau Server에만 적용되며 서버를 관리하는 상태, 즉 특정 사이트에 로그인하지 않은 상태에서 사용자를 가져오는 경우에만 유효합니다.

라이선스 수준=Creator 또는 Explorer

관리자=사이트

게시자=true

사이트 관리자 Creator 또는 사이트 관리자 Explorer. 이 설정은 특정 사이트에 로그인한 상태에서 사용자를 가져오는 경우에만 유효합니다.

라이선스 수준=Creator

관리자=없음

게시자=true

Creator

라이선스 수준=Explorer

관리자=없음

게시자=true

Explorer(게시 가능)

라이선스 수준=Explorer

관리자=없음

게시자=false

Explorer

라이선스 수준=Viewer(뷰어)

관리자=없음

게시자=false

Viewer(뷰어)

라이선스 수준= 라이선스 없음

관리자=없음

게시자=false

라이선스 없음

피드백을 제공해 주셔서 감사합니다!귀하의 피드백이 제출되었습니다. 감사합니다!