web-dev-qa-db-ja.com

QuickBooks Webコネクタ用の.qwcファイルを作成するにはどうすればよいですか？

QuickBooks（デスクトップバージョン）をASP.NETアプリケーションと統合しています。そのために私はQuickBooksWebConnectorを使用しています。カスタムWebサービス用の.qwcファイルを作成するにはどうすればよいですか？

quickbooksqbxmlqbwc
10
Golda

Webコネクタは、実際にはQuickBooksと独自のアプリケーションの間にある単なるプロキシまたはリレーです。

概要として、基本的に、特定のメソッドセットを話すSOAPサーバー/ Webサービスを構築します。次に、WebコネクタがQuickBooksを実行しているマシンにインストールされ、Webサービスをポーリングして「ねえ、私に何かすることがありますか？」その後、WebサービスはqbXML要求（ ここではqbXMLの例 ）で応答でき、Webコネクタに「この顧客を追加：…」または「請求書を送ってください」と伝えます。一致：…」などなど。次に、Webコネクタはそれらの要求をQuickBooksに中継し、QuickBooksはそれらを処理し、応答はWebサービスに中継されます。Webサービスは応答を何らかの方法で処理してから、 Webコネクタへの次のリクエスト。

より大きな ここにWebコネクタの概要 または、ダウンロードした場合 QuickBooks SDK 100以上のページがありますPDFこれを詳細に。

QuickBooks SDKをインストールした後、この例も確認することをお勧めします。

  • C：\ Program Files（x86）\ Intuit\IDN\QBSDK12.0\samples\qbdt\c-sharp\qbXML\WCWebService

これは、WebコネクタSOAP実装の完全な実例です。

最も基本的な形式では、次のようになります。

    [WebMethod]
    /// <summary>
    /// WebMethod - authenticate()
    /// To verify username and password for the web connector that is trying to connect
    /// Signature: public string[] authenticate(string strUserName, string strPassword)
    /// 
    /// IN: 
    /// string strUserName 
    /// string strPassword
    ///
    /// OUT: 
    /// string[] authReturn
    /// Possible values: 
    /// string[0] = ticket
    /// string[1]
    /// - empty string = use current company file
    /// - "none" = no further request/no further action required
    /// - "nvu" = not valid user
    /// - any other string value = use this company file
    /// </summary>
    public string[] authenticate(string strUserName, string strPassword)
    {
        string[] authReturn = new string[2];

        // Generate a random session ticket 
        authReturn[0]= System.Guid.NewGuid().ToString();

        // For simplicity of sample, a hardcoded username/password is used.
        string pwd="password";

        if (strUserName.Trim().Equals("username") && strPassword.Trim().Equals(pwd))
        {
            // An empty string for authReturn[1] means asking QBWebConnector 
            // to connect to the company file that is currently openned in QB
            authReturn[1]="";
        }
        else
        {
            authReturn[1]="nvu";
        }

        return authReturn;
    }

    [ WebMethod(Description="This web method facilitates web service to send request XML to QuickBooks via QBWebConnector",EnableSession=true) ]
    /// <summary>
    /// WebMethod - sendRequestXML()
    /// Signature: public string sendRequestXML(string ticket, string strHCPResponse, string strCompanyFileName, 
    /// string Country, int qbXMLMajorVers, int qbXMLMinorVers)
    /// 
    /// IN: 
    /// int qbXMLMajorVers
    /// int qbXMLMinorVers
    /// string ticket
    /// string strHCPResponse 
    /// string strCompanyFileName 
    /// string Country
    /// int qbXMLMajorVers
    /// int qbXMLMinorVers
    ///
    /// OUT:
    /// string request
    /// Possible values: 
    /// - “any_string” = Request XML for QBWebConnector to process
    /// - "" = No more request XML 
    /// </summary>
    public string sendRequestXML(string ticket, string strHCPResponse, string strCompanyFileName, 
        string qbXMLCountry, int qbXMLMajorVers, int qbXMLMinorVers)
    {
        // QuickBooks has asked for your next request

        ... return a qbXML request here ... 
    }

    [ WebMethod(Description="This web method facilitates web service to receive response XML from QuickBooks via QBWebConnector",EnableSession=true) ]
    /// <summary>
    /// WebMethod - receiveResponseXML()
    /// Signature: public int receiveResponseXML(string ticket, string response, string hresult, string message)
    /// 
    /// IN: 
    /// string ticket
    /// string response
    /// string hresult
    /// string message
    ///
    /// OUT: 
    /// int retVal
    /// Greater than zero  = There are more request to send
    /// 100 = Done. no more request to send
    /// Less than zero  = Custom Error codes
    /// </summary>
    public int receiveResponseXML(string ticket, string response, string hresult, string message)
    {
        // QuickBooks has sent you a qbXML response to your request 

        ... do something with 'response' here ... 
    }

この例には、.QWCファイルの例も含まれています。 ここにいくつかの.QWCファイルのドキュメントがあります そしてここに基本的な例があります：

<?xml version="1.0"?>
<QBWCXML>
    <AppName>QuickBooks Integrator</AppName>
    <AppID></AppID>
    <AppURL>https://secure.domain.com/quickbooks/server.php</AppURL>
    <AppDescription></AppDescription>
    <AppSupport>http://www.domain.com/quickbooks/support.php</AppSupport>
    <UserName>username</UserName>
    <OwnerID>{90A44FB7-33D9-4815-AC85-AC86A7E7D1EB}</OwnerID>
    <FileID>{57F3B9B6-86F1-4FCC-B1FF-967DE1813D20}</FileID>
    <QBType>QBFS</QBType>
    <Scheduler>
        <RunEveryNMinutes>2</RunEveryNMinutes>
    </Scheduler>
    <IsReadOnly>false</IsReadOnly>
</QBWCXML>
20
Keith Palmer Jr.