开始

概述

Smartsheet Live Data Connector(也称为Smartsheet ODBC Driver)提供了Smartsheet和第三方分析工具之间的行业标准连接。它使商业用户能够使用诸如Tableau、Spotfire、QlikView / qlikk Sense、Excel等商业分析和数据可视化软件与Smartsheet中存储的数据进行交互和可视化。

使用实时数据连接器的好处包括但不限于以下方面:

  • 到Smartsheet的基于odbc的行业标准连接。连接器与ODBC规范的3.8版本兼容。
  • Smartsheet范围内的访问控制(ACL)是强制的，通过ODBC的数据访问和检索受制于所有Smartsheet现有的安全机制。
  • 动态地与Smartsheet数据交互，使用Smartsheet作为实时数据源。
  • 使用存储在一个或多个Smartsheet表或报告中的数据创建图表、图形和其他可视化效果。

快速启动

本节提供快速通道，帮助您尽快启动和运行Smartsheet Live Data Connector。


下载安装程序 运行安装程序 配置您的软件
  • 场景桌面
  • 表服务器
  • Tibco Spotfire
  • Qlik感
  • QlikView
  • Excel
    		•


    需求

    为了使用实时数据连接器，您需要:

    • 实时数据连接器许可证(包括在一些计划中-请参阅定价）
    • 内容的许可证
    • 微软Windows 7、Windows 8或Windows Server 2012

    此外，要使用该驱动程序，您需要访问以下产品中的至少一个:ob欧宝娱乐app手机下载

    • Tableau Desktop专业版8.2/8.3/9。或Tableau Server 8.3.3/9.x
    • QlikView 11.2, qlikk Sense 1.1
    • Tibco Spotfire桌面，服务器，Web播放器7.0.1+
    • Microsoft Excel 2010, 2013, 2016 -数据连接向导，MSFT查询，电源查询
    • 微软Access 2013和2016

    支持

    如果您遇到任何困难，有问题或功能要求，请访问内容帮助中心．

    如果您有技术问题，请向我们的支持团队提供详细信息支持联系页面。为了更好地帮助您解决该问题，我们可能需要以下信息:

    • 错误消息的截图
    • 复制问题的精确步骤
    • 附加由实时数据连接器生成的日志副本(按照下面的步骤操作)本节启用日志记录)。

    下载

    下载最新的安装程序:

    配置

    Windows代理配置(可选)

    一些组织使用代理服务器访问网页内容。如果您正在使用代理访问web内容，Smartsheet Live Data Connector也将使用您的代理服务器。可以从查看代理设置互联网选项在控制面板中。

    默认情况下，Smartsheet Live Data Connector将为当前登录的用户使用Windows / Internet Explorer的代理设置。你可以找到更多的信息压倒一切的代理设置在高级选项菜单部分。

    要检查设置，请选择连接选项卡，然后单击局域网设置在窗口底部:



    如果你已经配置了代理，你会在你的局域网设置中看到它(示例):



    智能表实时数据连接器将使用中的自动配置脚本自动配置区域中的代理服务器地址代理服务器组框作为有效的代理服务器配置。

    如果Smartsheet Live Data Connector在Windows Server上运行，它没有模拟登录用户(例如，当它在Tableau Server服务下运行时)，则只使用系统默认的代理设置。的详细信息，请向网络管理员查询为代理访问配置Windows Server．

    启用日志记录(可选)

    如果您遇到连接器的任何问题，我们可能会要求您将日志文件发送给我们，以帮助识别和解决问题。启用日志记录只需在计算机上创建一个文本文件并记录Connector活动。

    要启用日志记录，请通过导航到:

    1. 开始>项目>Smartsheet实时数据连接器
    2. 点击实时数据连接器设置



    1. 点击驱动程序属性
    2. 检查启用日志记录
    3. 点击文件夹…指定日志的目的地址。



    选择目标文件夹，单击好吧：



    选择目的地后，单击好吧完成:



    配置Smartsheet DSN(可选)

    如果你需要设置一个数据源:

    1. 导航到开始>项目>Smartsheet实时数据连接器
    2. 运行ODBC数据源管理



    点击添加……使用实例添加数据源。



    选择Smartsheet实时数据连接器并点击完成：



    然后填写细节。如果您的Smartsheet帐户不允许使用电子邮件和密码登录，您可以使用使用API令牌单点登录选项。



    Windows 10

    如果你正在使用Windows 10，您可能已经注意到开始菜单中缺少ODBC数据源管理选项。请按照以下步骤在Windows 10上添加Smartsheet DSN。

    在任务栏上，单击搜索框并键入控制面板：



    打开控制面板后，单击系统和安全：



    向下滚动并单击管理工具：



    双击与您安装的驱动程序版本相匹配的适当快捷方式(32位或64位):



    之后，你会看到ODBC数据源管理窗口出现，您可以返回前一节创建内容DSN．

    高级选项菜单

    Advanced Options菜单提供的控件包括额外的行元数据、管理数据转换模式、启用驱动程序日志记录和手动覆盖代理设置。

    菜单可以在使用连接器时访问(例如，从Tableau内部):



    当设置ODBC数据源时:



    或者通过导航到开始>Smartsheet实时数据连接器>实时数据连接器设置：



    的高级选项菜单(称为实时数据连接器设置在开始菜单中)有包含扩展元数据(如甘特属性、大纲级别和讨论文本)作为附加列的选项。它还为高级特性和日志记录提供了控件。





    在这个菜单中有以下选项卡和选项:

    1. 连接属性
      • 可选内容——作为附加列扩展的元数据
      • 数据检索模式
      • SQL表名
    2. 驱动程序属性
      • 启用日志记录
      • 报告缓存-自动刷新设置
      • 手动覆盖代理设置

    数据检索模式有3个选项:

    • 总是返回文本-以文本形式返回所有结果
    • 使用多数Rule -仅当超过一半的列输入为数字时返回数字结果，丢弃所有非数字输入
    • 使用全部Rule -仅当列输入100%为数字时返回数值结果，否则以文本形式返回所有结果

    可以使用SQL表名部分缩短名称。默认情况下，完整路径附加到工作表名称后。取消选中此选项将只返回工作表/报表名称。

    自定义SQL函数(可选)

    在“高级选项”菜单中，向下滚动到可选内容列表，您将看到一个启用自定义SQL函数复选框:



    勾选此选项将启用以下SQL函数:

    函数 生动的例子
    attachments_count () -返回整数 RAWSQL_INT(“attachments_count(% 1)”,[_Rowlocator])
    discussions_count () -返回整数 RAWSQL_INT(“discussions_count(% 1)”,[_Rowlocator])
    discussions_text () -返回文本 RAWSQL_STR(“discussions_text(% 1)”,[_Rowlocator])
    parent_id () -返回文本 RAWSQL_STR(“parent_id(% 1)”,[_Rowlocator])
    child_ids () -返回文本(逗号分隔值) RAWSQL_STR(“child_ids(% 1)”,[_Rowlocator])
    outline_level () -返回整数 RAWSQL_INT(“outline_levle(% 1)”,[_Rowlocator])
    sheet_id () -返回文本 RAWSQL_STR(“sheet_id(% 1)”,[_Rowlocator])
    sheet_name () -返回文本 RAWSQL_STR(“sheet_name(% 1)”,[_Rowlocator])
    predecessor_ids () -返回文本(逗号分隔值) RAWSQL_STR(“predecessor_ids(% 1)”,[_Rowlocator])
    predecessor_labels () -返回文本 RAWSQL_STR(“predecessor_labels(% 1)”,[_Rowlocator])
    duration_seconds () -返回双 RAWSQL_REAL(“duration_seconds(% 1)”,[_Rowlocator])
    workspace_id () -返回文本 RAWSQL_STR(“workspace_id(% 1)”,[_Rowlocator])
    workspace_name () -返回文本 RAWSQL_STR(“workspace_name(% 1)”,[_Rowlocator])

    列类型转换逻辑

    连接器使用以下逻辑处理和转换Smartsheet数据:

    • 文字/数字:文本/数字列默认为多数决定原则。这意味着如果超过一半的列输入是数字，则返回数值。所有其他值将被丢弃。可以更改此规则高级选项节期间登录。

    • 日期、时间,datetime: Date、time和datetime列的存储类为TEXT，这意味着在运行查询之前它们不会转换为日期。

    • Picklists: Picklists探测类型，但他们使用一个精确的规则(100%)。因此，整数列表中的一个文本字符串将导致选择列表显示文本。所有的状态选择列表都解析为文本(5-State Signal, 6-State Hearts等)。

    • 复选框:复选框(或任何开/关列)值存储为布尔值，并使用整数存储类。复选框列中的任何文本数据都将丢失。这条规则的一个例外是一个等价于布尔数据(开/关，真/假，0/1)的列表，即星号和旗号。这些数据将存储在布尔值中，适用相同的规则。

    使用

    场景桌面

    连接到Smartsheet数据源到服务器>其他数据库(ODBC)选择。如果您没有看到此处列出的ODBC选项，请单击更多的服务器…从附加选项列表中选择它:



    下连接使用选择司机，然后选择Smartsheet实时数据连接器从驱动程序下拉菜单:



    …并单击连接．

    使用电子邮件地址和密码连接

    通过将您的Smartsheet凭据输入到内容登录对话框:



    使用API访问令牌连接(针对单点登录用户)

    首先，您需要创建一个令牌——这很容易，只需单击几下。

    在Smartsheet中，导航到账户>个人设置：



    在“个人设置”中选择API访问并点击生成新的访问令牌：



    为新令牌指定一个任意的描述性名称，然后单击好吧：





    现在回到你的内容登录窗口并单击使用API令牌单点登录选择:



    然后粘贴你的访问令牌:



    登录成功后，确认连接信息，单击好吧：



    创建工作簿和报告

    浏览或搜索工作表。您可以通过工作表或报表名称，或它们路径的任何部分(父工作区或文件夹的名称)进行搜索。



    然后将需要的每个工作表或报表拖放到右上角窗格:



    如果您正在使用多个工作表或报告，并且它们有共同的列，Tableau将尝试自动找出如何映射所选的工作表，并在它们之间创建默认关系。此时可以修改关系的类型(JOIN)。

    完成之后，单击去工作表在应用程序的底部继续进行可视化设计步骤:



    下一步是设计和配置您的报表:



    最后，使用Tableau Dashboard创建一个引人注目的数据可视化表示:



    重新开张了作业本

    Tableau Desktop设计上不保存登录凭证(出于安全原因)，所以下次你启动Tableau Desktop并重新打开之前保存的工作簿时，在Tableau 8中，你会看到一个错误消息:



    点击是的并重新输入您的Smartsheet密码。或者，如果您正在使用API访问令牌要连接，请将令牌粘贴到密码字段中:



    在Tableau 9中，您将看到不同的消息，重新输入您的登录凭证，然后单击好吧．或者，如果您正在使用API访问令牌要连接，请将令牌粘贴到密码字段中。



    表服务器

    安装

    安装Smartsheet Live Data Connector的过程对于服务器和桌面都是相同的。你可以参观下载部分查找最新的安装程序包。

    将工作簿发布到Tableau服务器

    典型的Tableau Server工作流开始于在Tableau Desktop中创建工作簿/报告．在Tableau Desktop中创建工作簿后，可以将其发布到Tableau Server中供其他人使用。

    打开服务器菜单选项和选择发布工作簿…：



    如果您还没有登录到Tableau Server，系统会提示您这样做。

    输入您的服务器:



    然后输入您的登录凭证:



    登录后，在下一步中，您将有机会命名工作簿，指定在服务器上将新工作簿保存的位置，并管理已发布工作簿的权限和访问。在访问工作簿数据方面，您有两个选项:

    1. 让用户提供他们自己的凭证(这要求他们有Smartsheet登录，并在Smartsheet中拥有访问工作簿中包含的数据的权限)。

    2. 访问已发布的数据，而不必提供Smartsheet凭据。

    第二种选择可能是最常见的．Tableau Server可以将您的登录凭证与已发布的工作簿一起存储。若要选择此选项，请单击身份验证……按钮:



    下一步，您可能需要向右滚动以查看Authentication选项:



    最后，在Authentication下拉列表中选择嵌入式密码：



    要保存并完成，请单击好吧．

    Tibco Spotfire桌面

    Spotfire安装说明可以找到在这里．可以找到使用Spotf欧宝体育app官方888ire的其他资源在这里．


    启动Spotfire，然后导航到添加数据>添加数据连接>其他：



    点击添加然后选择数据库……在列表的底部:



    选择Odbc数据提供商然后单击配置…：



    选择您之前配置的DSN．填写Smartsheet凭据以登录。或者，如果您正在使用API访问令牌要连接，请保留email字段为空，并将令牌粘贴到密码字段中:



    选择一个表和所需的所有列，设置数据源名称，然后单击好吧：



    选择刚刚设置的Data表并单击好吧以导入数据(名称将与数据源名称你在最后一步输入了):



    最后，使用Spotfire创建一个漂亮的可视化数据:



    Tibco Spotfire服务器

    使用电子邮件地址和密码连接

    当您打开Tibco Spotfire Analyst时，将提示您登录并选择一个服务器。如果您还没有配置它，请单击管理服务器……：



    在Manage Servers窗口上，单击添加：



    在下一个屏幕上，输入服务器地址您的Tibco Spotfire服务器:



    从Spotfire图书馆开始

    点击添加数据选项卡，然后单击开放的图书馆：



    从列表中选择一个文件，然后单击开放：



    保存到Spotfire图书馆

    您可以通过单击将任何更改保存回Spotfire库文件>另存为>图书馆项目……：


    Spotfire Web播放器

    要在Spotfire Web Player上访问您的内容，您首先需要登录:



    登录后，您可以查看上传到Spotfire服务器的当前文件。你也可以通过点击从你的电脑上传文件开放的分析：



    然后浏览对于您计算机上的文件:



    Qlik感

    打开Qlik，然后点击创建一个新的应用程序在出现的对话框中



    为你的应用程序输入一个名称，然后单击创建：



    点击打开应用程序：



    点击添加数据：



    然后点击连接我的数据,然后单击ODBC：



    创建一个新的连接您之前配置的DSN．填写Smartsheet凭据以登录。或者，如果您正在使用API访问令牌要连接，请将令牌粘贴到密码字段中:



    选择所需的数据，然后单击加载和完成：



    加载数据之后，单击关闭：



    然后点击刚刚创建的新数据表:



    最后，使用这些数据在Qlik Sense中创建您的仪表盘:



    QlikView

    打开ClickView并导航到文件>新：



    后入门向导:对话框开始时，单击X在右上角:



    对话框关闭后，单击文件再次点击编辑脚本…：



    在下一个屏幕上，选择ODBC在数据库下拉菜单，然后单击连接……(你可以点击选择……同样，它们也会打开相同的对话框):



    在下一个对话框中，选择您设置的数据源(如果它没有显示，单击显示用户dsn复选框)。填写Smartsheet凭据以登录。或者，如果你是使用API访问令牌进行连接，将令牌粘贴到密码字段:



    点击选择：



    选择您想要的表和列，然后单击好吧：



    在完成添加表并准备好脚本之后，单击好吧：



    你的数据现在已经加载，但在你开始制作图表之前，你需要保存你的项目:



    然后你需要启动图表向导:


    点击文件>重新加载：



    Excel

    本节介绍使用Excel使用Smartsheet实时数据连接器的各种方法。

    Excel -数据连接向导

    通过导航到打开数据连接向导数据>获取外部数据>从其他来源：



    选择ODBC DSN并点击下一个：



    选择前面创建的DSN的名称，然后单击下一个：



    出现提示时，填写Smartsheet登录凭证。如果您的Smartsheet帐户需要单点登录，而您无法使用电子邮件和密码登录，您可以使用使用API令牌单点登录选项，并将你的API令牌粘贴到密码字段:



    连接到Smartsheet后，选择您的工作表或报告，然后单击完成：



    最后，指定导入数据的目的地:



    Excel - Microsoft Query

    DSN配置完成后，通过导航到Microsoft Query数据>从其他来源>来自微软的查询：



    选择前面创建的数据源，然后单击好吧：



    出现提示时，填写Smartsheet登录凭证。如果您的Smartsheet帐户需要单点登录，而您无法使用电子邮件和密码登录，您可以使用使用API令牌单点登录选项，并将你的API令牌粘贴到密码字段:



    连接后，选择所需的表或报告:



    指定数据的目的地:



    选择查看数据的方式:



    储蓄凭证

    要保存凭据，请单击数据选项卡，然后单击连接：



    为查询选择Connection，然后单击属性：




    点击定义选项卡，然后检查保存密码选择。

    选项保存密码后，需要将以下字符串复制到连接字符串(替换API_TOKEN与API访问令牌你生成的):

    PWD = API_TOKEN

    最后,点击好吧：







    Excel -功率查询

    遵循微软查询的早期说明，但不是将数据返回到Excel，而是选择在Microsoft query中查看数据或编辑数据查询：



    进入查询编辑器后，单击SQL并在打开的窗口中复制SQL语句:



    现在，从Excel主菜单启动Power Query并选择从其他来源>从ODBC：



    下一步，将下面的字符串粘贴到连接字符串，并将从前面步骤中复制/保存的查询粘贴到其中SQL语句：

    驱动程序={Smartsheet Live Data Connector}



    最后，在出现提示时输入您的Smartsheet凭据:



    常见问题解答

    本部分回答了以下问题:

    为什么我看到这个错误-“意外错误”，当展开说“ODBC未为您的帐户启用”?





    这是因为尚未为您的Smartsheet帐户启用ODBC访问。请参见需求部分，以确保您的帐户有资格使用实时数据连接器。

    回到常见问题解答



    我的日期列包含混合的里程碑名称(文本)和日期，但导入到Tableau时，所有文本数据都丢失了。我怎样才能看到这些信息?

    日期和时间列在实时数据连接器中有一个文本存储类。这意味着在导入Tableau或其他ODBC应用程序之前，它们都是纯文本字符串。如果希望查看这些列的非日期/时间内容，则必须在导入之前修改Tableau列类型。您可以通过右键单击Tableau表选择屏幕中的日历图标并选择字符串类型。所有单元格内容现在都将显示为原始的、未格式化的文本。



    回到常见问题解答



    我的Smartsheet数据需要以某种方式格式化以与Tableau兼容吗?

    电子表格数据可能需要一些格式化才能使用Tableau。Tableau为Excel用户创建了一个指南，其中大部分也适用于Smartsheet，因为在Excel和Smartsheet中数据结构的相似之处。看到为Tableau准备Excel数据知识库文章。

    回到常见问题解答



    当我使用Tableau Desktop时，为什么我每次重新打开Tableau时都必须重新输入我的Smartsheet证书?

    作为一种安全预防措施，Tableau Desktop不保存用户登录凭证。这是Tableau Desktop的一个特性，而不是Smartsheet Live Data Connector的一个特性。要重新打开以前保存的Tableau Desktop工作簿，请参见本节．

    回到常见问题解答



    当我试图重新打开以前保存的Tableau Desktop工作簿时，为什么我得到一个“无效的用户名或密码”错误?



    请参阅这个FAQ条目．

    回到常见问题解答



    Smartsheet Live Data Connector在连接中支持的最大表数是多少?

    Smartsheet Live Data Connector将在一次连接中支持最多64个表(表)。

    回到常见问题解答



    Smartsheet实时数据连接器支持哪种SQL方言?

    Smartsheet Live Data Connector使用SQLite的实现来本地存储和查询Smartsheet表和报告。因此，实时数据连接器可以解释SQLite所理解的原生SQL。SQLite使用的SQL语法在SQLite网站上有很好的文档:https://www.sqlite.org/lang.html．除了SQLite的核心功能https://www.sqlite.org/lang_corefunc.html， Live Data Connector还支持通过本机SQL公开表、列和单元元数据的各种功能。这些功能在上面已经描述过了。

    回到常见问题解答



    为什么Tableau的财政日历启动功能不能正常工作?

    每当我选择不同的财政年度开始月份时，它就会丢失开始月份之后的任何月份的年度和季度数据，直到日历年的结束。例如，如果我选择8月作为财政年度的开始，那么8月到12月将显示年和季度的Null值。然而，1月到7月显示正确。

    当与Smartsheet Live Data Connector通信时，Tableau期望(作为一个例子)，如果您请求2014年的第15个月，连接器将返回2015年第3个月的日期。然而，Connector的日期函数将第15个月视为错误值，并返回NULL。为了解决这个限制，在Tableau中创建一个计算字段:

    1. 右键单击Data窗格中的任何位置并选择创建计算字段
    2. 我们叫它财政年度订单日期
    3. 在函数列中选择RAWSQL_DATE
    4. 然后在“公式”窗口中键入RAWSQL_DATE("日期(%1，'+6个月')，[订单日期]),在那里订单日期应替换为您将从表中使用的日期列的名称。

    在这个例子中，财政年度从7月1日开始——因此+ 6月”。如果你的会计年度在不同的月份开始，你需要相应地调整。例如，如果它开始于3月，你的计算应该是'+ 2月”。

    结果应该如下所示:



    回到常见问题解答



    我尝试发布一个基于Smartsheet的工作簿，得到的消息是，函数TODAY()和NOW()将以不同的方式工作，因为服务器和Smartsheet在不同的时区。

    类时，Tableau似乎返回不正确的信息现在()功能，而且似乎有一些在线论坛的帖子证实了这一点。

    幸运的是,与返回和DATEDIFF我们可以修改这些计算以返回UTC或本地时间。的现在()UTC函数RAWSQL_DATETIME(“datetime(现在的)”)．和现在()本地时间函数为RAWSQL_DATETIME(“datetime(‘现在’,‘作用’)”)．

    大多数其他Tableau用户解决这个问题的方法是选择一个公共时区，并修改计算以始终使用该时区。我们的建议是更换现在()用你自己的函数返回UTC，如果你需要跨时区一致(所有其他Smartsheet日期也将以UTC返回)。

    回到常见问题解答



    我的Smartsheet数据在Tableau服务器上没有刷新。

    在8.3.3版本之前，Tableau Server有一个已知的问题，手动刷新(使用F5)不会刷新Smartsheet中的任何数据。这个问题在Tableau Server 8.3.3中得到了解决。

    回到常见问题解答



    我看到了“Tableau identified limits…”的警告信息。

    Smartsheet Live Data Connector附带一个Tableau配置文件，旨在优化Tableau集成体验。该文件被安装到C:\My Documents\My Tableau Repository\Datasources目录中，名为“smartsheet.tdc”。

    如果由于某种原因Tableau找不到这个文件，你会看到以下警告:


    这可能是以下两个原因之一:

    1. Smartsheet Live Data Connector是在Tableau安装之前安装的，因此.tdc文件从未复制到Tableau目录中，因为它当时不存在。

    2. 同时安装32位和64位连接器，然后卸载其中一个连接器，删除.tdc文件。

    在这两种情况下，解决方案都是卸载Smartsheet Live Data Connector并重新安装Connector，确保.tdc文件现在被安装到Tableau目录中。

    回到常见问题解答



    如何让Excel自动刷新智能表数据?

    要开始，请导航到数据>刷新所有>连接属性……



    之后，将打开一个对话框，其中有几个设置供刷新。完成按自己喜好设置选项后，单击好吧：



    回到常见问题解答



    我收到一个错误消息，试图配置或删除一个DSN -“无法找到…的设置例程。请重新安装驱动器。”

    如果您从计算机上删除了实时数据连接器，或从1.0.20.3版本(或以前称为Smartsheet ODBC Driver的版本)升级了它，但仍使用旧驱动程序设置了数据源名称(dsn)，则无法配置或删除它们。

    当您试图配置或删除为已从计算机中删除的ODBC驱动程序设置的DSN时，您将收到以下错误消息:



    请按照这个在线发布删除对旧驱动程序的任何引用。

    首先,单击开始、类型注册表编辑器并启动Windows注册表编辑器:



    如果你的深空网络是用户DSN(很可能)配置为64位驱动程序，导航到HKEY_LOCAL_MACHINE \ \ ODBC \ ODBC.INI软件并删除下的数据源键ODBC.INI下面的条目ODBC.INI \ ODBC数据源:

    回到常见问题解答



    当试图打开保存的工作簿时，我收到一个错误消息-“数据源的用户名或密码无效”

    这个错误可能是由Tableau中的字符限制造成的。由于工作簿重新打开时在Tableau中传递数据的方式，以下字符不能用于您的密码:

    {};＝

    如果您的密码中包含这些字符，则需要更改并删除它们。


    回到常见问题解答