1C Webサービスを使用したC＃のクライアントとの1Cの交換

1つのプロジェクトでは、1C Webサービスを使用する必要があり、倉庫自動化システムを構築し、データ収集端末は1Cに直接接続され、クライアント自体は.NETで開発されました。 結果は非常に興味深い構造でした。 Webサービス操作モードでの1C設定に関する情報を受け取り、簡単な構成とクライアントをC＃でチュートリアルの実験形式で作成し、研究所で成功裏に提示しました。

実験室の作業には少し複雑な名前が付けられました。
1Cで開発されたソースの例でWebサービスを使用するクライアントサーバーマルチプラットフォームソリューション間の情報交換の組織：Enterprise 8.2プラットフォームとCの.NET 4.0プラットフォーム上のクライアント＃

猫の下で興味のある方、どうぞ。

仕事の目的

Webサービスを構築する技術、WebサービスのWSDL記述の形成を習得する。 Webサービスを介した転送の可能性について、XMLスキーマでオブジェクトをシリアル化する原則を学習します。

ハードウェアとソフトウェア

1. Microsoft Windows 7 x64
2. プラットフォーム1C：エンタープライズ8.2
3. インターネット情報サーバー
4. Visual Studio 10 Ultimate

理論的紹介

Webサービステクノロジーを使用して、ますます多くの交換が行われています。 ホストデータベースにはWebサービス拡張機能とデータハンドラーをインストールするだけで十分であり、ClintソリューションではWebサービスに接続できるため、これは便利です。 このテクノロジーはマルチプラットフォームであり、現時点ではその使用は非常に重要です。

WSDL記述を使用したWebサービスの例は次のとおりです。

1. http://www.cbr.ru/scripts/Root.asp?Prtid=DWS毎日のデータを受信するための中央銀行のWebサービス。
2. http://api.yandex.ru/speller/doc/dg/concepts/api-overview.xml Yandex Webサービススペルチェッカー。
3. https://www.flightstats.com/developers/bin/view/Web+Services/WSDLフライト、天気情報などを監視するための、多数のWebベースの統計サービス。

WSDL （Webサービス記述言語）は、Webサービスを記述してアクセスするためのXMLベースの言語です。 （仕様http://www.w3.org/TR/wsdl ）。

SOAP （Simple Object Access Protocol）は、分散コンピューティング環境の構造化メッセージングプロトコルです。 SOAPは、XML形式の任意のメッセージとリモートプロシージャコール（RPC）の交換に使用されます。 （仕様http://www.w3.org/TR/soap/ ）。

XDTO （XMLデータ転送オブジェクト） -XMLスキーマを使用して記述されたデータのオブジェクトモデリングのメカニズム（詳細については、 http ： //v8.1c.ru/overview/xdto.htmを参照）。

プリミティブ型をシリアル化するためのほとんどのメソッドはW3によって開発され、名前空間「 http://www.w3.org/2001/XMLSchema 」で説明されています。

作業タスク

タスク1：1C：Enterpriseプラットフォームをインストールし、IISサーバーコンポーネントをインストールし、1C Web ExtensionsをIISサーバーに接続します。

1C：Enterpriseプラットフォームをインストールする場合、Web拡張機能をインストールする必要があります。


図 1. 1Cのインストール時に選択されたコンポーネント

「 コントロールパネル\すべてのコントロールパネル要素\プログラムと機能 」メニューで、追加のWindowsコンポーネントをインストールする必要があります。 「Windows機能を有効または無効にする 」IISコンポーネントを指定します。 デフォルトで選択されたコンポーネントに加えて、ISAPIテクノロジーに関連するコンポーネントをさらに追加する必要があります。このテクノロジーのおかげで、1C WebサーバーエクステンションはIIS Webサーバーと通信でき、認証タイプは認証を使用してWebサービスへのアクセスを許可する「URLによる」です1Cデータベースユーザー。 インストール後、オペレーティングシステムを再起動することをお勧めします。


図 2. IISのインストール時に選択されたコンポーネント

「 コントロールパネル\すべてのコントロールパネル要素\管理ツール」メニューで、「 IISマネージャー 」コンソールを起動し、「 アプリケーションプール 」要素を開き、コンテキストメニューで「 DefaultAppPool 」プールを開き、「 詳細設定... 」を選択します。 「インストールする必要があります」「 True 」。 これは、Web-Extension 1Cの操作に必要です。なぜなら、 32ビットアプリケーションです。 これはデバッグに便利です（コンフィギュレーターから公開する場合、デフォルトで「 DefaultAppPool 」が置き換えられるため）、管理対象環境なしでサービスごとに個別のプールを作成することをお勧めします。

同じIISマネージャーコンソールで、 既定のWebサイト要素を選択し、 認証アクションを選択します。ここで、オプション： 匿名認証を有効にする必要があります。

IISサーバーで1C Webサービスを公開できるようになりました。 ただし、このパブリケーションを可能にするには、 管理者ユーザーに代わって1C：Enterprise Configuratorを起動する必要があります。

タスク2：単純な1C構成を作成します。
構成の開発を開始する最初のことは次のとおりです。管理者ロールを作成する必要があります（ 構成開発の方法論に従って、これはFull Rightsと呼ばれるべきです）

データベースには、注文されたアイテムの数量とタイプを含むすべての注文に関する情報が含まれていると考えています。1つの注文にはアイテムと数量を含むリストがあり、注文には独自の番号と作成日もあります。 すべての注文に関する情報は、Webサービスを介して送信する必要があります。
これを説明するには、データベースオブジェクトを作成する必要があります。


図 3.作成された1C構成のデータ構造

追加の詳細なしのディレクトリ「 命名法 」。 「デフォルト」の詳細には、アイテムの名前とコードに関する情報が含まれています。

ドキュメント「 バイヤーの注文 」。表部分「 製品 」が含まれ、その各行には、命名法（タイプ「 DirectoryReference.Nomenclature 」の要素）および数量（タイプ「 数値 」の小数点以下15桁の「 数量 」の要素と3後）。

次に、1Cをエンタープライズモードで実行し、作成した命名法と対応する番号で記入された複数のドキュメントを作成できます。

タスク3：1C Webサービスの作成と公開。
「 一般 」構成グループで、最初にアイテムを転送するために、「 XDTO-packages 」タイプの新しい要素を作成します。 たとえば、「 NomenclatureXDTO 」と呼ぶことができます。 名前空間URLは、WSDL仕様に従って、このパッケージの仕様のURLアドレスとして割り当てる必要があります。たとえば、
「 Company.com/1C/Nomenclature 」 このパッケージでは、「 Nomenclature 」などのオブジェクトタイプを作成する必要があります。詳細には「 Code 」と「 Name 」があり、対応するタイプ「 string（http://www.w3.org/2001/XMLSchema） 」があります。
次に、顧客の注文に関する情報を含む2番目のXDTOパッケージを作成する必要があります。これは、名前空間「 company.com/1C/ClientOrder 」の「 ClientOrderXDTO 」と呼ぶことができます。 まず、作成した命名パッケージを使用できるようにするために、インポートディレクティブ「 company.com/1C/Nomenclature 」を接続する必要があります。 これは、ドキュメント「 顧客の注文 」の表部分に含まれるアイテムの転送に必要です。

次に、テーブルパーツの1行を含むオブジェクトタイプ「 ClientOrderRow 」を作成する必要があります。 このタイプは、詳細「 命名法 」と「 カウント 」の組み合わせで構成されます。それぞれの命名法については、オブジェクトの種類「命名法（http://company.com/1C/Nomenclature）」を示し、数量については「 double（http：// www.w3.org/2001/XMLSchema） 。 "
注文自体を含むオブジェクトのタイプは「 ClientOrder 」と呼ばれ、注文番号、作成日、注文の表形式部分の要素の配列を含む必要があります。 タイプ文字列の「 番号 」、タイプ「 dateTime（http://www.w3.org/2001/XMLSchema） 」の「 日付 」およびタイプ「 ClientOrderRow（http://company.com/1C/ClientOrder） 」の「 製品 」、最小数が「 0 」、最大数が「 -1 」であることを示す必要があります。これは、このオブジェクトが配列であることを示しています。

ただし、注文のリストを返す必要があるため、この配列を含むオブジェクトタイプを作成する必要があります。したがって、タイプ「 ClientOrder 」 （http：// company）の 「 ClientOrder 」という属性を 1つだけ持つ「 ArrayOfClientOrders 」という別の要素を作成する必要があります.com / 1C / ClientOrder） 。」


図4. 1CのXDTOパッケージの構造

これに関して、転送された値の説明の作成は完了したと見なすことができます。 Webサービス自体とそのメソッドを記述する必要があります。
「一般」構成グループでは、オブジェクト、Webサービスを作成する必要があります。 「 サービス 」と呼ぶことができます。 「その他」タブで、Webサービスが属する名前空間、例えば「 company.com/1C 」、および新しく作成されたパッケージ「 company.com/1C/Nomenclature、company.com/を含むXDTOパッケージのリスト」を指定します1C / ClientOrder 。」 「操作」タブで、「 GetClientOrders 」メソッドを作成します。このメソッドは、値「 ArrayOfClientOrders（http://company.com/1C/ClientOrder） 」を返します。同時に、空の値を返す機能を設定し、「Method Name」という虫眼鏡のフィールドをクリックします」、それにより、このWebサービスメソッドにアクセスするときに呼び出されるWebサービスモジュールに関数を作成します。

データベースから受け取って顧客注文のリストを返す関数を正しく記述するためには、この関数のコードは付録1にあるため、内部言語1Cを知る必要があります。説明が必要なのは、「 XDTO Factory 」はシリアル化を実行する何らかのマネージャーであるということですオブジェクト、およびこのシリアル化されたオブジェクトを返す必要があります。 同時に、データベースに含まれるすべての注文が選択され、表部分の番号、日付、行のシリアル化が行われますが、命名法には追加のシリアル化が必要で、既にパックされたオブジェクトが一般構造に挿入されます。 パックされたオブジェクトの配列がアセンブルされ、配列パッケージにシリアル化されます。 呼び出された関数の結果としてクライアントに送信されます。
Webサービスを公開するには、1C configuratorメニューで「 Administration \ Publish on a web server ... 」を選択し、Webサービスパブリケーションの名前、たとえば「 Company 」、サービスの名前、例えば「 Service 」およびアドレス「 service.1cws 」を指定します。また、パブリケーションのパスも指定します（例： " C：\ inetpub \ wwwroot \ Company \ "）。

その後、WSDL Webサービス構造はアドレス「 localhost / Company / ws / service.1cws？Wsdl 」で利用可能になります

タスク4：C＃Platform .NET 4.0でのクライアントの作成。
Visual Studioで、新しいC＃コンソールアプリケーションを作成します。

次に、「 Reference 」プロジェクト要素のコンテキストメニューを呼び出し、「 Add service reference ... 」アクションを実行し、開いたメニューの「 Advanced ... 」ボタンをクリックします。「 Add Web Reference ... 」ボタンをクリックする必要があるウィンドウが開きます。
WebサービスのWSDL記述へのリンクを挿入する必要があるメニューが開きます。


図 5. C＃でWebサービスをプロジェクトに接続する

1Cで作成されたWebサービスの場合、このリンクは「 localhost / Company / ws / service.1cws？Wsdl 」のようになります。Webサービスの説明を正しく受け取った後、Webへのアクセス元となる.NET名前空間の名前を指定する必要がありますサービス、たとえば「 CompanyService 」、「 参照の追加... 」ボタンをクリックすると、Visual Studioはこの説明に従ってクラスを自動的に生成します。 プロジェクトでは、生成されたクラスのメソッドを呼び出すだけで十分ですが、シリアル化と呼び出しは.NETプラットフォームによって実行されます。

次に、Webサービスにアクセスし、受信したデータをユーザーに表示するプログラムを作成する必要があります。 これを行うには、C＃言語を知っておく必要があります。プログラムコードは付録2に記載されています。このコードから、「 サービス 」オブジェクトの作成はサービスアクセスマネージャーの作成に過ぎないことを明確にする必要があります。 これに代わって、Webサービスメソッドが呼び出されます。
「 _1CWebServiceClientConsole 」はプロジェクトの一般的な名前空間であり 、作成時に選択されます。 WSDL構造から取得したWebサービスの名前空間は、プロジェクトの名前空間に完全に含まれているため、「独自の」リモートメソッドを呼び出すことができます。

このようなアーキテクチャの構築はプログラマにとって透過的ですが、その後の送信のためにどのポイントで何がシリアル化されているかを理解する必要があります。 このクライアント/サーバーアプリケーションアーキテクチャは、現在最も人気があります。