使用 Azure Analysis Services （AAS） 数据库嵌入报表

若要生成嵌入令牌，请提供以下信息：

• 用户名 （可选（如果没有 RLS）。RLS 必需） - 用户名必须与 API 调用方相同（在本例中为 Master 用户的 UPN）。 如果数据库不使用 RLS，并且未提供用户名，则使用主用户的凭据。
• 角色 （RLS 必需） - 仅当有效身份属于该角色时，报表才会显示数据。

示例：

为以下三种方案之一定义用户标识和角色：

• 如果未实现 RLS：

无需定义任何有效的标识。

• 如果使用静态 RLS：

      var rlsidentity = new EffectiveIdentity(  //If static RLS
         username: "username@contoso.com", 
         roles: new List<string>{ "MyRole" },
         datasets: new List<string>{ datasetId.ToString()}
      )
  

• 如果使用动态 RLS：

      var rlsidentity = new EffectiveIdentity(  // If dynamic RLS
         username: "username@contoso.com",
         roles: new List<string>{ "MyRoleWithCustomData" },
         customData: "SalesPersonA"
         datasets: new List<string>{ datasetId.ToString()}
      )
  

  注释

  customData 嵌入令牌中的字符不能大于 1,024 个字符。

使用有效身份生成嵌入令牌：

public EmbedToken GetEmbedToken(Guid reportId, IList<Guid> datasetIds, [Optional] Guid targetWorkspaceId)
{
    PowerBIClient pbiClient = this.GetPowerBIClient();
    // Create a request for getting an embed token for the rls identity defined above
       var tokenRequest = new GenerateTokenRequestV2(
        reports: new List<GenerateTokenRequestV2Report>() { new GenerateTokenRequestV2Report(reportId) },
        datasets: datasetIds.Select(datasetId => new GenerateTokenRequestV2Dataset(datasetId.ToString())).ToList(),
        targetWorkspaces: targetWorkspaceId != Guid.Empty ? new List<GenerateTokenRequestV2TargetWorkspace>() { new GenerateTokenRequestV2TargetWorkspace(targetWorkspaceId) } : null,
        identities: new List<EffectiveIdentity> { rlsIdentity } // Only in cases of RLS
    );
    // Generate an embed token
    var embedToken = pbiClient.EmbedToken.GenerateToken(tokenRequest);
    return embedToken;
}

若要生成嵌入令牌，请提供以下信息：

• 用户名（必填）- 用户名必须与 API 调用者相同。在这种情况下，可以使用 API 获取配置文件获取到的服务主体 ObjectId 或服务主体配置文件 ObjectId。获取配置文件。

• 角色 （RLS 必需） - 仅当有效标识是角色的成员时，报表才会显示数据。
  示例：
  为以下方案之一定义用户标识和角色：

• 如果未实现 RLS：

      var rlsidentity = new EffectiveIdentity(   // If no RLS
         username: "ServicePrincipalObjectId",   // Or, "ServicePrincipalProfileObjectID"
         datasets: new List<string>{ datasetId.ToString()}
      );
  

• 如果实现了动态 RLS：

      var rlsidentity = new EffectiveIdentity(  // If dynamic RLS
         username: "ServicePrincipalObjectId",
         roles: new List<string>{ "MyRoleWithCustomData" },
         customData: "SalesPersonA"
        datasets: new List<string>{ datasetId.ToString()}
      );
  

  注释

  customData 在嵌入令牌中不能大于 1,024 个字符。

使用有效身份标识生成嵌入令牌：

public EmbedToken GetEmbedToken(Guid reportId, IList<Guid> datasetIds, [Optional] Guid targetWorkspaceId)
{
    PowerBIClient pbiClient = this.GetPowerBIClient();
    
    // Create a request for getting an embed token for the rls identity defined above
    var tokenRequest = new GenerateTokenRequestV2(
        reports: new List<GenerateTokenRequestV2Report>() { new GenerateTokenRequestV2Report(reportId) },
        datasets: datasetIds.Select(datasetId => new GenerateTokenRequestV2Dataset(datasetId.ToString())).ToList(),
        targetWorkspaces: targetWorkspaceId != Guid.Empty ? new List<GenerateTokenRequestV2TargetWorkspace>() { new GenerateTokenRequestV2TargetWorkspace(targetWorkspaceId) } : null,
        identities: new List<EffectiveIdentity> { rlsIdentity }  // If using master user, only in cases of RLS. 
    );
    // Generate an embed token
    var embedToken = pbiClient.EmbedToken.GenerateToken(tokenRequest);
    return embedToken;
}