REST APIリファレンス

前へ次へ

コミット履歴の取得

commitHistoryリソースを使用して、組織のソース管理オブジェクトのコミット履歴を取得します。

ソース管理オブジェクト、特定のプロジェクトまたはフォルダ、または特定のアセットすべてのコミット履歴を要求できます。クエリパラメータを使用して、特定の［エクスプローラ］ページまたは指定したページ数のオブジェクトすべてのコミット履歴を要求することもできます。

GET要求

組織のプロジェクトとアセットのすべてのコミット履歴を要求したり、特定のプロジェクトまたはアセットの履歴を要求できます。

コミット履歴を取得するには、次のURIを使用します。

/public/core/v3/commitHistory?<query parameters>

組織のすべてのオブジェクトのコミット履歴を取得するには、クエリパラメータを省略します。

特定のプロジェクトまたはアセットのコミット履歴を取得するには、次のクエリパラメータをURIに追加します。

パラメータ	タイプ	説明
q	String	クエリフィルタの文字列。オブジェクトID、プロジェクト名またはフォルダ名、またはアセットタイプを含めます。
perPage	String	ページごとに含まれるエントリの数。最大エントリ数は100です。デフォルトは100です。
ページ	String	結果の指定したページを示します。デフォルトはページ1です。

以下のフィールドを使用してクエリフィルタを定義できます。

フィールド	タイプ	演算子	説明
id	String	==	プロジェクト、フォルダ、アセットのID。
path	String	==	アセットがあるプロジェクトまたはパス。
type	String	==	アセットタイプ。アセットのコミット履歴を受信するのに必須。次のいずれかのタイプです。 DTEMPLATE。マッピング。 MTT。マッピングタスク。 DSS。同期タスク。 DMASK。マスキングタスク。 DRS。レプリケーションタスク。 MAPPLET。 BSERVICE。ビジネスサービス定義。 HSCHEMA。階層スキーマ。 PCS。PowerCenterタスク。 FWCONFIG。固定長の設定。 CUSTOMSOURCE。保存済みクエリ。 MI_TASK。一括取り込みタスク。 WORKFLOW。リニアタスクフロー。 VISIOTEMPLATE TASKFLOW PROCESS。アプリケーションの統合 AI_CONNECTION アプリケーションの統合アプリの接続。 AI_SERVICE_CONNECTOR。アプリケーションの統合サービスコネクタ。 GUIDE。アプリケーションの統合ガイド。 PROCESS_OBJECT。アプリケーションの統合プロセスオブジェクト。 HUMAN_TASK。アプリケーションの統合ヒューマンタスク。

クエリの例

クエリパラメータを使用して特定のオブジェクトのコミット履歴を取得する例を以下に示します。

IDを使用する単一のアセットまたはフォルダのコミット履歴:

GET /public/core/v3/commitHistory?q=id=='23546'

IDを使用する2つのプロジェクトのコミット履歴:

GET /public/core/v3/commitHistory?q=id=='23423' and id=='5645esf'

パスを使用する2つのプロジェクトのコミット履歴:

GET /public/core/v3/commitHistory?q=path=='project name 1' and path=='project name 2'

パスを使用するアセットのコミット履歴:

GET /public/core/v3/commitHistory?q=path=='ProjectName/FolderName/AssetName1' and type=='DTEMPLATE'

GET応答

最新のコミットが最初にリストされているコミットのリストを返します。エラーが発生した場合はエラーを返します。

成功した場合、commitsオブジェクトに各コミットの次の情報を返します。

フィールド	タイプ	説明
commits	List<Object>	commitsのすべてのリスト。
hash	String	コミットの一意のID。
summary	String	コミットハッシュに関連付けられたサマリ。
description	String	コミットハッシュに関連付けられた詳細な説明。
username	String	コミットを実行したユーザーの名前。
email	String	コミットを実行したユーザーの電子メールアドレス。
date	Date	コミットが yyyy-MM-dd'T'HH:mm:ss.SSSZ 形式で送信されたときのタイムスタンプ
committer	String	コミットをファイル作成したGitユーザー。
pagination	Object	ページの情報。
pageSize	Int	ページの要素数。
currentPage	Int	現在のページ番号。
hasNext	Boolean	現在のページの後に別のページがあるかどうか。

GET応答の例

成功した場合、次の例のような応答を受信します。

{
    "commits": [
        {
            "hash": "b0bdc63a7fb9047db6c3bc29ad67d5ecbf7d1d47",
            "summary": "Default Project v1",
            "description": "Default Project v1",
            "username": "testuser@gmail.com",
            "email": "testuser@gmail.com",
            "date": "2020-03-30T22:30:19.000Z",
            "committer": "testuserinfa"
        },
        {
            "hash": "fc6fcc318ad1b4aec17017d053bc2f0d1f605096",
            "summary": "Synchronization Task1 - Copy 1 v1",
            "description": "Synchronization Task1 - Copy 1 v1",
            "username": "testuser@gmail.com",
            "email": "testuser@gmail.com",
            "date": "2020-03-30T22:22:02.000Z",
            "committer": "testuserinfa"
        },
        {
            "hash": "74d776c574dad3bc5cf7a44b22195cf423560fe9",
            "summary": "Project2 Folder1 v1",
            "description": null,
            "username": "testuser@gmail.com",
            "email": "testuser@gmail.com",
            "date": "2020-03-30T22:17:48.000Z",
            "committer": "testuserinfa"
        },
        {
            "hash": "02c8b5950df4ef2110288ba7f77a220bc6f05b0a",
            "summary": "v1 of project2",
            "description": "v1 of project2",
            "username": "testuser@gmail.com",
            "email": "testuser@gmail.com",
            "date": "2020-03-24T23:41:52.000Z",
            "committer": "testuserinfa"
        },
    ],
    "pagination": null
}

ソース管理

ガイドをダウンロード

ページをウォッチ

フィードバックを送信

コミュニティ

Knowledge Base

Success Portal