使用 VersionOne .Net SDK 建立/测试连接

Question

我是 VersionOne 的新手，C# 有限。需要帮助使用 .Net SDK 连接和测试与 VersionOne 实例的连接，以确保我实际上正在建立连接。

我有一些示例代码可以正常运行，但不确定它是否正在连接。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using VersionOne.SDK.APIClient;

namespace VersionOneExtract3
{
    public class Connection1
    {
         V1Connector connector = V1Connector

    .WithInstanceUrl("https://www14.v1host.com/MyCompanySite")

    .WithUserAgentHeader("VersionOneExtract2", "1.0")

    .WithWindowsIntegrated("XA\\MyUsername", "MyPassword")

    .Build();
    }
}
enter code here

没有结果或错误。有没有办法可以创建一个变量并让它返回某种确认的连接信息？感谢您的帮助！

Answer 1

您发布的代码创建了一个用于连接到 VersionOne API 的 VersionOne 连接器。我假设您出于隐私原因将用户名和密码以及 URL 替换为随机数据。确保这些详细信息正确无误。

在您设置好连接器后，您将希望使用它从 api 查询各种资源。一个例子如下：

IServices services = new Services(connector);
Oid memberId = services.GetOid("Member:20");
Query query = new Query(memberId);
QueryResult result = services.Retrieve(query);
Asset member = result.Assets[0];

您没有从您发布的代码中看到任何反馈的原因是，实际上，除了接收一些配置数据然后吐出一种 API 客户端之外，它并没有做太多的事情。

请务必仔细阅读文档，因为他们在解释如何使用他们的 SDK 方面做得相当不错。

https://community.versionone.com/VersionOne_Connect/Developer_Library/Get_an_SDK/.NET_SDK

Answer 2

将您的代码视为描述和设置 VersionOne 连接的代码。您正在构建一个对象，其中包含连接所需的一切。您尚未连接。

如果您的变量 connector 为空，您就知道您没有连接到 VersionOne。另一方面，您的连接器可能在连接设置中具有看起来像有效的信息，因此您需要添加下一段代码

IServices services = new Services(connector);

一旦你点击了这段代码，如果连接器对象无效，这将引发异常。要确认这一点，请连接到https://www14.v1host.com/MyCompanySiteWrongURL。如果您运行您的代码，连接器将引用一个对象，但它会在其中包含虚拟“垃圾”，因为它不会连接。一旦你点击了我建议的上述新代码，它就会抛出异常。相反，如果您输入正确的 URL 和凭据，则不应引发异常。您可以使用@DCCoders 代码块查询成员：20。我还建议使用 VersionOne API 在浏览器中进行查询，这样您就可以获得即时结果并体验 VersionOne 数据模型。 https://community.versionone.com/VersionOne_Connect/Developer_Library/Learn_the_API/VersionOne_REST_API_Tutorial