各製品の資料を入手。
詳細はこちら →
製品をチェック
SQLAlchemy ORM を使って、Python でSAP Ariba Procurement のデータに連携する方法
CData Python Connector を使って、Python アプリケーションおよびスクリプトからSQLAlchemy 経由でSAP Ariba Procurement にOR マッピング可能に。
最終更新日：2023-09-23
この記事で実現できるSAP Ariba Procurement 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
Pythonエコシステムには、多くのモジュールがあり、システム構築を素早く効率的に行うことができます。CData Python Connector for SAPAribaProcurement は、pandas、Matplotlib モジュール、SQLAlchemy ツールキットから使用することで SAP Ariba Procurement にデータ連携するPython アプリケーションを構築し、SAP Ariba Procurement のデータを可視化できます。 本記事では、SQLAlchemy でSAP Ariba Procurement に連携して、データを取得、 する方法を説明します。
CData Python Connectors の特徴
CData Python Connectors は、以下のような特徴を持った製品です。
- SAP Ariba Procurement をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
- Python をはじめとする多様なデータ分析・BI ツールにSAP Ariba Procurement のデータを連携
- ノーコードでの手軽な接続設定
CData Python Connectors では、1.データソースとしてSAP Ariba Procurement の接続を設定、2.Python からPython Connectors との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
必要なモジュールのインストール
pip でSQLAlchemy ツールキットをインストールします：
pip install sqlalchemy
モジュールのインポートを忘れずに行います：
import sqlalchemy
Python でSAP Ariba Procurement のデータをモデル化
次は、接続文字列で接続を確立します。create_engine 関数を使って、SAP Ariba Procurement のデータに連携するEngne を作成します。
engine = create_engine("saparibaprocurement///?ANID=AN02000000280&API=PurchaseOrdersBuyerAPI-V1&APIKey=wWVLn7WTAXrIRMAzZ6VnuEj7Ekot5jnU&AuthScheme=OAuthClient&InitiateOAuth=GETANDREFRESH&OAuthSettingsLocation=/PATH/TO/OAuthSettings.txt")
SAP Ariba Procurement に接続するには以下を設定します。
- ANID：Ariba Network ID。
- API：本製品にSAP Ariba データを取得させたいAPI を指定。ビジネスロールに基づき、Buyer またはSupplier API を選択します（可能な値は、PurchaseOrdersBuyerAPIV1、または PurchaseOrdersSupplierAPIV1 です）。
- Environment：接続先がテスト環境か本番環境かを指定（可能な値は、TEST またはPRODUCTION です）。
OAuth 認証
接続プロパティを設定した後、認証のためにOAuth 接続を設定する必要があります。
- AuthScheme をOAuthClient に設定します。
- サービスにアプリケーションを登録し、APIKey、OAuthClientId、およびOAuthClientSecret を取得する必要があります。
OAuth アプリケーションの作成について、詳しくはヘルプドキュメントを参照してください。
OAuth の自動リフレッシュ
以下を設定して、接続してください。
- APIKey：アプリケーション設定のApplication key。
- OAuthClientId：アプリケーション設定のOAuth Client Id。
- OAuthClientSecret：アプリケーション設定のOAuth Secret。
接続すると、本製品は自動でOAuth プロセスを完了します。
- 本製品はSAP Ariba からアクセストークンを取得し、それを使ってデータをリクエストします。
- 本製品はアクセストークンの期限が切れると自動的にリフレッシュします。
- TOAuth 値はOAuthSettingsLocation で指定された場所に基づいてメモリに保存されます。
SAP Ariba Procurement のデータのマッピングクラスの宣言
接続を確立したら、OR マッパーでモデル化するテーブルのマッピングクラスを宣言します。本記事では、Orders テーブルを使います。sqlalchemy.ext.declarative.declarative_base 関数を使って、新しいクラスにフィールド（カラム）を定義します。
base = declarative_base() class Orders(base): __tablename__ = "Orders" DocumentNumber = Column(String,primary_key=True) Revision = Column(String) ...
SAP Ariba Procurement のデータをクエリ
マッピングクラスができたので、セッションオブジェクトを使ってデータソースをクエリすることができます。セッションにEngine をバインドして、セッションのquery メソッドにマッピングクラスを提供します。
query メソッドを使う
engine = create_engine("saparibaprocurement///?ANID=AN02000000280&API=PurchaseOrdersBuyerAPI-V1&APIKey=wWVLn7WTAXrIRMAzZ6VnuEj7Ekot5jnU&AuthScheme=OAuthClient&InitiateOAuth=GETANDREFRESH&OAuthSettingsLocation=/PATH/TO/OAuthSettings.txt")
factory = sessionmaker(bind=engine)
session = factory()
for instance in session.query(Orders).filter_by(OrderStatus="CHANGED"):
print("DocumentNumber: ", instance.DocumentNumber)
print("Revision: ", instance.Revision)
print("---------")
ほかの方法としては、execute メソッドを適切なテーブルオブジェクトに使うことが可能です。以下のコードはアクティブなsession に対して有効です。
execute メソッドを使う
Orders_table = Orders.metadata.tables["Orders"]
for instance in session.execute(Orders_table.select().where(Orders_table.c.OrderStatus == "CHANGED")):
print("DocumentNumber: ", instance.DocumentNumber)
print("Revision: ", instance.Revision)
print("---------")
より複雑なクエリとして、JOIN、集計、Limit などが利用可能です。詳細はヘルプドキュメントをご覧ください。
SAP Ariba Procurement からPython へのデータ連携には、ぜひCData Python Connector をご利用ください
このようにCData Python Connector と併用することで、270を超えるSaaS、NoSQL データをPython からコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。
日本のユーザー向けにCData Python Connector は、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。
関連コンテンツ
