1Cとの統合

こんにちはHabravchanam！



この記事では、私の組織の1Cプラットフォームとの統合がどのように確立されているかについてお話したいと思います。 このトピックに関する技術情報がほぼ完全に不足するようになりました。 1Cと任意の情報システムとの接続に関するさまざまな記事やレポートを読むことで、それらはすべてマーケティング、デモの性質であり、技術の問題ではなく、問題の解決策の本質を反映していることを繰り返し確信します。



この方法が普遍的であると主張するものではないことを警告します。 1C構成自体が多く、さらに多くの情報システム、言語、プラットフォームがあるため、可能な組み合わせの数は膨大です。 私の目標は、可能な解決策の1つを示すことです。





1Cと統合する言語として、Pythonを選択しました。 プロセス自動化に非常に適しています。 これは、最小限の構文（コードを非常にすばやく入力する）、豊富な標準ライブラリ（サードパーティモジュールの必要性が低い）、クロスプラットフォームによって促進されます-高い確率で、Linix OSで記述されたコードはWindowsで正常に動作します。



まず、作業に使用するデータの概要を説明します。 この組織は、極東地域のエネルギー販売会社であり、約40万人の加入者にサービスを提供しています。 加入者ごとに、彼の支払い、請求、消費されたサービスと計算スキーム、計測デバイス、測定値、その他多くのデータが保存されます。



この組織には、Delphiで記述されたプログラムがあり、MSSQL / Firebirdをデータベースとして使用していました。 これらの栄光の時代には、任意の言語を使用してデータベースに接続し、多くのアクションを実行することが可能でした-債務者の加入者を選択し、受け取った支払いを分配し、機器の測定値を記録します。 当然のことながら、ルーチンを自動化するスクリプトのコレクションは常に増え続けています。 プログラマは、プログラム自体を開かずに任意のアクションを実行できます。



悲しいかな、1Cへの移行で景品は終了しました-ベースに直接接続する方法はありませんでした。 一般に、1Cプラットフォーム自体は分割不可能であり、他のシステムとの統合が不十分です。 彼女は、彼らが言うように、彼女自身のものです。 1Cにデータをロードする場合、そこからデータを抽出するのはそれほど簡単ではないことに注意してください。 しかし、組織が支払いシステムと個人アカウントを導入する必要があるという事実を考慮して、何らかの解決策を見つける必要がありました。



私が直面した主なタスクは、特定の個人アカウントのデータを迅速に受信できることでした-名前、住所、計測デバイス、計測値、支払い、請求。 さらに、文書の作成-調整、支払い領収書の行為。 そのため、データベースに直接接続する可能性はありません。SQLサーバーで1Cデータベースを表示したすべての人は、aaa1、aaa2の形式のテーブルの質量を把握することは困難であることに気付きました。 そして、そのようなテーブルとフィールド名を使用してクエリを構築することは、単に非現実的です。 さらに、多くのテーブル1C（特に後者のスライス、残基、ターンなどの最も重要なテーブル）は仮想であり、複数の結合を収集する異なる物理テーブルに散らばっています。 この方法は適切ではありません。



Platform 1Cは、COM接続を介して接続する機能を提供します。 多くのWindowsプログラムと同様に、1Cのインストール中に、2つのCOMオブジェクト（オートメーションサーバーとCOMコネクタ）がシステムに登録されます。 COMテクノロジーのサポートが提供されている言語を使用して、両方のオブジェクトを操作できます。



Automation Serverオブジェクトは、通常のクライアントアプリケーションとほとんど変わらない1Cアプリケーションです。 違いは、さらに、アプリケーションインスタンスをプログラムで管理する可能性があることです。 COMコネクタオブジェクトを使用すると、1Cアプリケーションの軽量バージョンが起動します。このバージョンでは、フォームと、インターフェイスおよび視覚効果に関連する関数とメソッドは使用できません。 アプリケーション自体は外部接続モードで起動します。 グローバル変数の初期化（たとえば、現在のユーザーとその設定の決定）は、外部接続モジュール1Cで実行する必要があります。 このモードで使用できない関数が外部接続モードのコードで呼び出されると、例外が発生します（これはPythonスクリプトに渡されます）。 安全でない関数の呼び出しは、フォームの構造によってフレーム化される必要があります

#    ("!"); #
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

COMオブジェクトの操作はWindows専用の技術であるため、標準のPythonパッケージに含まれていないことは驚くことではありません。 PythonのWindowsでのプログラミングに必要なすべての機能を提供するモジュールのセットであるWin32拡張機能をインストールする必要があります。 既にアセンブルされたexe-installerとしてダウンロードできます。 拡張機能自体は、レジストリ、サービス、ODBC、COMオブジェクトなどへのアクセスを提供します。 別の方法として、 ActiveState Pythonディストリビューションをすぐにインストールできます。このディストリビューションでは、Win32拡張機能がすぐに使用できます。



しばらくの間、Webアプリケーション、特に個人アカウントの開発において、COM接続を試しました。 次の欠点が確認されました。



-COM接続が遅い。 パフォーマンスの低下は、COMテクノロジーのマイナス面として知られています。

-1Cとの接続を確立するプロセスは、構成によって異なりますが、1〜8秒（私の場合は6秒）かかります。 言うまでもなく、各リクエストに接続を設定すると、各ページが8秒間読み込まれます。

-Python上のWebアプリケーションは独立したサーバーとして機能するため、以前のポイントは接続をグローバル変数に保存し、エラーが発生した場合にそれを復元することで補うことができます。 正直なところ、PHPで接続を維持する方法については、まだ考えていません。

-クロスプラットフォームWebアプリケーションが失われました。



上記の点に基づいて、相互作用の原理を変更し、最初のプラットフォーム依存（Windows）、1Cデータを何らかの便利な形式にアップロードする2番目の部分、および何も疑わずにデータを操作できる2番目のプラットフォーム非依存の2つの部分に分けることにしました原則として約1C。



アクション戦略は次のとおりです。Pythonスクリプトは1Cに接続し、必要なクエリを実行して、SQLiteデータベースにデータをアップロードします。 Python、PHP、Javaからこのデータベースに接続できます。 私たちのプロジェクトのほとんどはpythonで動作し、生のSQLクエリを自分の手で書くのに我慢できないので、SQLiteデータベースでのすべての動作はSQLAlchemy ORMを介して行われます。 必要なのは、データベース構造を宣言型で記述することだけです。

 from sqlalchemy.ext.declarative import declarative_base from sqlalchemy import Column, Integer, Numeric, DateTime, Unicode, Boolean, LargeBinary, ForeignKey Base = declarative_base() class Abonent(Base): __tablename__ = "abonents" id = Column(Integer, primary_key=True) account = Column(Unicode(32), index=True) code = Column(Unicode(32)) address = Column(Unicode(512)) fio = Column(Unicode(256)) source = Column(Unicode(16)) psu = Column(Unicode(256)) tso = Column(Unicode(256)) np = Column(Unicode(256)) street = Column(Unicode(256)) house = Column(Integer) flat = Column(Integer) mro = Column(Unicode(256)) class Payment(Base): __tablename__ = "payments" #   ...
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これで、このモジュールを任意のpythonプロジェクトにインポートするだけで十分になり、データを操作できます。



私はあなたの質問を予見します-「なぜSQLite」？ 主な理由は、データベースが読み取り専用であるため、SQLiteへの書き込みに関する問題が心配する必要がないためです。 第二に、このDBMSの形式は便利です-表示する方が便利です（FireFoxのスーパー拡張機能を含む多くの無料ユーティリティがあります）。 第三に、場合によっては、MySQLサーバーに接続されていないマシンからサブスクライバーにアクセスする必要がありました。 この場合、SQLiteデータベースファイルをコピーするだけで十分であり、このマシンはすべての情報にアクセスできます。



荷降ろしは夜に1日に1回行われます。 1Cでのデータ入力も同じ方法で自動化できます。 たとえば、個人アカウントのWebサイトに加入者が残した証言を記録するとします。 この場合、再び1Cに接続し、ソフトウェアメソッドを使用して、「測定値の取得」というドキュメントを作成および実行します。 以下にコードを示します。



PythonでCOMオブジェクトを操作することは少し珍しいです。 まず、コードの「pythonicity」が失われます-1Cで変数と関数を命名する規則は、控えめに言っても、Zen of Pythonに対応していません。 第二に、1Cオブジェクトはしばしばキリル文字と呼ばれることを誰もが知っています。キリル文字はPythonで開発するときに問題を引き起こしますが、解決可能です。 コードを理解することをお勧めします。

 import pythoncom import win32com.client V82_CONN_STRING = "Srvr=v8_server;Ref=v8_db;Usr=username;Pwd=megapass;" pythoncom.CoInitialize() V82 = win32com.client.Dispatch("V82.COMConnector").Connect(V82_CONN_STRING)
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

コードからわかるように、クライアントは1Cで動作するように初期化されています。 COMオブジェクトの定義は、「V82.COMConnector」という名前で発生します。 この名前はV8.2プラットフォームで有効であり、バージョン8.1を使用している場合、名前は「V81.COMConnector」になることに注意してください。



初期化されたクライアントで、Connect（）メソッドを呼び出し、接続文字列を渡します。 文字列は、サーバー名、データベース、ユーザー、およびパスワードで構成されます。 結果のV82オブジェクトは、1Cアプリケーションへの接続を保存します。 Disconnect（）メソッドなどはありません。 データベースから切断するには、del（）関数を使用してオブジェクトをメモリから削除するか、Noneに割り当てます。



オブジェクトを取得すると、1Cグローバルコンテキストの任意のフィールドとメソッドにアクセスし、TableDocument、ValueValueなどのタイプのユニバーサルオブジェクトを操作できます。 COM接続を介して作業する場合、1Cは「外部接続」モードで動作することを考慮することが重要です。 ポップアップダイアログ、通知、そして最も重要なフォームなど、インタラクティブな作業のための機能はありません。 ドキュメントフォームモジュールのButton1Press（）プロシージャで最も重要な機能を囲む構成開発者を呪うことがよくあると確信しています。



キリル文字属性などの重要なことについて話しましょう。 1Cはバイリンガルメディアであり、ロシア語の各メソッドに英語の類似物があるという事実にもかかわらず、遅かれ早かれ、キリル文字の属性に目を向ける必要があります。 PHPまたはVBSCriptで問題が発生しない場合、

 Set Con = CreateObject("v81.COMConnector") Set v8 =Con.Connect("") Set  = v8.. .... Set = .() . = .... .... .()
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

その後、Pythonコードは構文エラーでクラッシュします。 どうする？ 構成を編集しますか？ いいえ、getattrメソッドとsetattrメソッドを使用するだけです。 COMオブジェクトとキリル文字の属性名をこれらの関数に渡すと、それに応じて値を取得および設定できます。

 #coding=cp1251 catalog = getattr(V82.Catalogs, "")
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

以下が重要です。詳細の名前、および関数とメソッドのパラメーターは、cp1251エンコードで送信する必要があります。 したがって、事前にエンコードされたパスを回避するために、ファイルの先頭で宣言することは理にかなっています：＃coding = cp1251。 その後、エンコードを気にせずに文字列を転送できます。 しかし！ 1Cから取得したすべての文字列（関数、クエリの呼び出しの結果）はUTF-8エンコードになります。



1C環境でクエリを実行し、結果を反復処理してデータベースをSQLiteに保存するコード例：

 #coding=cp1251 q = '''  .  code, ... + ", " + .  address, ..  fio, ..  psu, (.  .).  tso, ...  np, ...  street, ..  house, ..  flat, ...  mro  .     ..(,  = (..))    . = . ''' query = V82.NewObject("Query", q) selection = query.Execute().Choose() CONN = db.connect() CONN.query(models.Abonent).delete() while selection.Next(): abonent = models.Abonent() abonent.account = selection.code.strip() abonent.code = selection.code abonent.fio = selection.fio abonent.address = selection.address abonent.psu = selection.psu abonent.tso = selection.tso abonent.source = u"ASRN" abonent.np = selection.np abonent.street = selection.street abonent.house = selection.house abonent.flat = selection.flat abonent.mro = selection.mro CONN.add(abonent) CONN.commit()
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ここで、CONNはSQLite-baseに接続するセッションです。 クエリクエリオブジェクトが作成され、そのテキストが入力されます。 上記のように、要求テキストはcp1251にある必要があります。このために、エンコードが最初に宣言されます。 要求が完了すると、重複を追加しないようにデータベース内のすべてのサブスクライバーが削除され、ループに追加されて最終的なコミットが実行されます。



クエリを操作するとき、次のルールを特定しました。



-フィールドを選択するとき、ラテン文字で名前を割り当てます。getattr（）ではなく、セレクター（ドット）を使用してアクセスする方がはるかに便利です。

-プリミティブデータタイプ（文字列、数値、日付、ブール値）のみを選択します。 オブジェクト（ドキュメント、参照）へのリンクを選択しないでください！ このコンテキストでは、属性またはリンクメソッドを呼び出すと、COM接続を介して要求が発生するため、リンクは絶対に必要ではなく、有害ですらあります。 ループ内でリンク属性にアクセスすると、非常に遅くなります。

-日付型のフィールドを選択すると、PyTimeオブジェクトとして返されます。 これは、COM接続で日時を送信するための特別なデータ型です。 通常の日時のように作業するのは便利ではありません。 このオブジェクトをint（）に渡すと、タイムスタンプが返され、そこからfromtimestamp（）メソッドを使用して日時を取得できます。



次に、紙の文書がどのように形成されるかを検討します。 実際には、消費者には、事前に準備されたドキュメント（支払い領収書や和解行為など）をダウンロードする機会を与える必要があります。 これらのドキュメントは、確立された要件に従って1Cで生成され、Pythonでの実装には多くの時間がかかります。 したがって、1Cでドキュメントを生成し、Excel形式で保存することをお勧めします。



そのため、特別な外部処理によって調整レポートドキュメントが生成されます。 1Cの用語に詳しくない場合：処理は、1C環境で実行するように設計された独自のモジュール、フォーム、テンプレートを備えた自律型プログラムです。 処理を初期化し、詳細を入力し、関数を呼び出す必要があります。これにより、1Cでの表示を目的としたテーブルドキュメントが返されます。 このドキュメントは、Excel形式で保存し、サーバーにコピーするか、データベースに書き込む必要があります。

 link = getattr(V82.Catalogs, "").FindByDescription("  ") nav_url = V82.GetURL(link, "") name = V82.ExternalReports.Connect(nav_url) ExternalReport = V82.ExternalReports.Create(name) setattr(ExternalReport, "", reference) table_doc = ExternalReport.GetDoc() path = V82.GetTempFileName("xls") table_doc.Write(path, V82 .SpreadsheetDocumentFileType.XLS) report = models.Report() report.account = reference.Code.strip() report.type = u"act" report.document = open(path, "rb").read() CONN.add(report)
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

指定されたフラグメントでは、以下が実行されます。 ドキュメントを形成する処理は接続されています。 処理を構成に組み込み、ディスクまたは1Cデータベース（一部のディレクトリ）に保存できます。 毎回構成が更新されないように処理が頻繁に変更されるため、最も頻繁に変更される処理は、レポートという名前の「値ストレージ」タイプの属性の「システムレポート」ディレクトリに保存されます。 データベースからディスクにアンロードしてロードするか、GetURL（）メソッドを使用して処理を初期化できます。GetURL（）メソッドでは、ディレクトリ項目と属性の名前へのリンクを転送する必要があります。 結果の処理オブジェクトに詳細を割り当て、エクスポートされたGetDoc（）関数を呼び出し、一時的なExcelファイルに保存されているテーブルドキュメントを取得します。 このファイルの内容は、SQliteデータベースに書き込まれます。



考慮すべき最後のことは、1Cでのソフトウェアデータ入力です。 サブスクライバーからの読み取り値を記録するとします。 これを行うには、「証言を行う行為」という文書を作成して実施するだけで十分です。

 #coding=cp1251 acts = getattr(V82.Documents, "") act = acts.CreateDocument() setattr(act, "", 1024.23) setattr(act, "", "") #   ... act.Write()
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

データ入力が自動化されました。



そのため、COM接続を使用してデータをアップロードおよびダウンロードするソフトウェアに基づく方法の概要を説明しました。 この方法は、私の組織でほぼ1年間正常に機能しています。 1Cで形成されたベースは、3つの支払いシステム、インターネット取得（インターネット経由のカードによる支払い）、および個人アカウントに対応しています。 さらに、さまざまなスクリプトがデータベースに接続され、ルーチンを自動化します。



この方法の短所（COM接続速度が遅い）にもかかわらず、一般に、安定して機能します。 プラットフォームに依存しない形式（SQLite）のデータがあり、任意の言語で作業できます。 また、コードの主要部分はPythonで記述されています。つまり、1Cでは夢にも思わない多くのツールやテクニックが利用可能です。



これは、1Cと対話する可能な方法の1つです。 それは新しいものではなく、おそらく既にテストされ、誰かによって最適化されていると確信しています。 しかし、私自身が踏み込んでいた落とし穴からあなたを守るために、プロセスの詳細を最大限に設定しようとしました。



幸運をお祈りします。1Cは塗装ほど怖くないことを忘れないでください。