パッケージのインストール

依存関係

Python コネクタの要件は、Python 3.10以降がインストールされていることだけです。

インストール

CData Python Connector for e-Sales Manager Remix は、Windows、Linux、およびMac 用のWHL ファイルとして提供されています。各コネクタはPython 3.10 Stable ABI を使用してビルドされており（ファイル名内のabi3 タグで示されます）、単一のホイールファイルがPython 3.10以降のあらゆるインストールをサポートするため、Python のマイナーバージョンを正確に一致させる必要はありません。プラットフォームに適したWHL ファイルを指定して"pip install" コマンドを使用してください。

Windows：

pip install cdata_esalesmanager_connector-26.0.9770-cp310-abi3-win_amd64.whl

Linux：

pip install cdata_esalesmanager_connector-26.0.9770-cp310-abi3-linux_x86_64.whl

macOS：

pip install cdata_esalesmanager_connector-26.0.9770-cp310-abi3-macosx_12_0_arm64.whl

macOS 用のホイールファイルは、macOS 12以降でのみarm64（Apple Silicon）アーキテクチャをサポートします。

環境に関わらずいくつかのディストリビューションでは、すでにインストールされたPython 2ディストリビューションがある場合、それと区別するために"pip3 install" コマンドを使用する必要があるかもしれません。インストール後に、コネクタが正常にインストールされたかどうかを"pip list" コマンドを実行して確認できます。コマンドで出力されるリストに"cdata_esalesmanager_connector" があれば、インストールは成功です。

アップグレード

アップグレード時、"pip install" は古いJRE ファイルを自動的にクリーンアップしません。JVM エラーの原因となる可能性がある不要なファイルの残存を避けるため、新しいバージョンをインストールする前に以前のバージョンをアンインストールしてください。

ライセンス

インストール完了後にコネクタのライセンスをアクティベートするには、追加のステップが必要です。ディストリビューションのsite-packages のCData アセット内に、ライセンスをアクティベートするためのinstall-license ツールがあります。ディストリビューションのsite-packages フォルダから、"cdata/installlic_esalesmanager" フォルダに移動後、次のコマンドを使用するだけでライセンスをアクティベートできます。<key> 引数を除外すると、評価版ライセンスがアクティベートされます。

Windows：
```
./install-license.exe <key>
```
Linux / Mac：
```
./install-license.sh <key>
```

非対話形式でインストールするには、名前、メールアドレス、ライセンスキーを引数として渡します。

Windows:

./install-license.exe --name "John Doe" --email "[email protected]" <key>

Linux / Mac:

./install-license.sh --name "John Doe" --email "[email protected]" <key>

ファイルアクセスの関係で、pip がpython ディストリビューションのメインやプライマリサイトパッケージの場所ではないフォールバックファイルパスにコネクタをインストールする場合があります。この場合、コネクタがインストールされた場所や、そこからライセンスアクティベータを見つけることが難しくなります。そうしたケースでは、以下のpython スクリプトを実行することで、コネクタのネイティブファイルの完全なファイルパスが出力されます。このファイルはcdata フォルダに保存されており、そこから installlic_esalesmanager フォルダを簡単に見つけることができます。

import os
import cdata.esalesmanager
path = os.path.abspath(cdata.esalesmanager.__file__)
print(path)

アンインストール

何らかの理由でコネクタをアンインストールする必要がある場合は、以下の例のようにpip uninstall コマンドを実行してください。

pip uninstall cdata-esalesmanager-connector