デフォルトの DevOps コンフィグ エクスポーター

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：9分

    • DevOps コンフィグエクスポーターコンテンツパックには、追加の展開およびプロビジョニングアクティビティの入力として使用できるデータのデフォルトのDevOps コンフィグエクスポーターのセットが含まれています。

    重要:
    Washington DC リリース以降、DevOps コンフィグ は将来の廃止に備えて準備されます。これは非表示になり、新しいインスタンスにはインストールされなくなりますが、引き続きサポートされます。詳細については、Now Support ナレッジベースの「Deprecation Process (廃止プロセス) [KB0867184]」の記事を参照してください。

    DevOps コンフィグ エクスポーターを使用すると、他のツールが展開可能なスナップショットのデータを使用できます。

    注:
    デフォルトのエクスポーターは変更できません。ただし、エクスポーターのコピーを作成して、そのコピーをカスタマイズすることはできます。
    これらのエクスポーターは、 DevOps コンフィグ エクスポーターコンテンツパックに含まれています。
    • returnAllData-now
    • returnAllData_noVars-now
    • returnDataforNodeName-now
    • returnDataForNodeNames-now
    • returnDataForPath-now
    • returnNodeListForLevel-now
    • returnNodeListForPath-now
    • returnValueForKeyAtNodeName-now
    • returnValueForKeyPath-now
    • returnValueForUniqueKeyName-now

    すべてのデータを返す (returnAllData-now)

    var システムフォルダーを含め、フィルタリングや変更を行わずにスナップショットの完全なコンテンツを返します。
    注:
    アプリケーション/展開可能項目がアクティブステータスでない (削除済み) 場合、エクスポーターは失敗します。
    引数
    • appName:アプリケーション名
    • deployableName:展開可能項目名
    • requestedFormat:要求された形式 (json/yaml/xml/ini/raw)
    特殊ロジック
    なし
    エラー処理
    なし

    変数を除くすべてのデータを返す (returnAllData_noVars-now)

    展開可能項目の名前と変数を除く、展開可能項目のすべての構成データを返します。

    応答には、次のものは含まれません。
    • 展開可能レベルの vars フォルダー
    • 含まれている各コレクションの vars フォルダー
    • 応答のルートレベルにある展開可能項目名
    注:
    このエクスポーターは、削除されたアプリケーション/展開可能項目に対しては機能しません。
    引数
    引数 (コマンドラインで指定することも、実行モードで対話形式で入力することもできます)。
    • appName:アプリケーション名
    • deployableName:展開可能項目名
    • requestedFormat:要求された形式 (json/yaml/xml/ini/raw)
    特殊ロジック
    なし
    エラー処理
    なし

    ノード名のデータを返す (returnDataforNodeName-now)

    引数として指定された、指定されたノード名のスナップショットデータのサブセットを返します。引数の値は文字列テキストとして渡す必要があります。

    引数
    • appName:アプリケーション名
    • deployableName:展開可能項目名
    • requestedFormat:要求された形式 (json/yaml/xml/ini/raw)
    • nodeName - ノード名 (文字列、引用符で囲む)
    • includeNodeInOutput -(文字列、デフォルトは true)
    特殊ロジック
    • nodeName が空の場合、すべてのデータが返されます。
    • includeNodeInOutput が false の場合、ノード名を除外したノードデータが返されます。
    エラー処理
    • nodeName が一意でない場合、 nodeName の複数のインスタンスが見つかりました。
    • nodeName が見つからない場合、 ノード <nodeName> が見つかりません。
    • includeNodeInOutput が false で、ノードデータがキーと値のペアの場合、エラーが返されます。

    ノードのリストのデータを返す (returnDataForNodeNames-now)

    ノードリストのスナップショットから完全なデータを返します。ノード名のリターンデータと同じですが、指定されたノード名 (子ノードを含む) のリストの構成データを含むネストされた JSON を返します。

    引数
    • appName:アプリケーション名
    • deployableName:展開可能項目名
    • requestedFormat:要求された形式 (json/yaml/xml/ini/raw)
    • nodeNames - ノード名 (文字列、引用符で囲まれ、カンマ区切り)
    特殊ロジック
    nodeNamesList が空の場合、すべての構成データを返します。
    エラー処理
    なし
    応答の詳細
    {"node1":{"contentKey":"contentValue"},"node2":{ "error":"nodeName not found"}}.
    エラー処理
    • nodeName が一意でない場合、エクスポーターは、その特定の nodeName に対して「nodeName の複数のインスタンスが見つかりました」というエラー応答を返します。その他の nodeName にはデータが含まれています
    • nodeName が見つからない場合は、そのノードのエラーメッセージを含める必要があります

    パスのデータを返す (returnDataForPath-now)

    スナップショット内の指定されたノードパスのすべての構成データを返します。

    引数
    • appName:アプリケーション名
    • deployableName:展開可能項目名
    • requestedFormat:要求された形式 (json/yaml/xml/ini/raw)
    • nodePath - ノードパス (文字列、引用符で囲む)
    特殊ロジック
    nodePath が空の場合は、コンテンツ全体を返します (すべての構成データと同様)。
    エラー処理
    nodePath が見つからない場合、見つからなかった最後のノード名は、 パスが見つかりません (<nodeName>) と示されます。

    レベルのノードリストを返す (returnNodeListForLevel-now)

    スナップショットの指定されたレベル (深度) にあるルートノードの子であるノードの名前のリストを返します。たとえば、レベル 1 はルートノードの直接の子、レベル 2 は孫などです。

    引数
    • appName:アプリケーション名
    • deployableName:展開可能項目名
    • requestedFormat:要求された形式 (json/yaml/xml/ini/raw)
    • ExcludeVarsNode [true|false] - vars ノードを結果から除外します (true または false、デフォルトは true)
    • nodeLevel:ノードのレベル (整数、デフォルトは 0)
    特殊ロジック
    レベルが指定されていない場合、エクスポーターはレベル 0 の値 (展開可能ルートノード名など) を返します。
    エラー処理
    なし
    応答の詳細
    ["ノード 1"、 "ノード 2"、 "ノード 3"]

    パスのノードリストを返す (returnNodeListForPath-now)

    スナップショット内の指定されたノードパスのノードのリストを返します (サブノードは考慮しません)。

    引数
    • appName:アプリケーション名
    • deployableName:展開可能項目名
    • requestedFormat:要求された形式 (json/yaml/xml/ini/raw)
    • ExcludeVarsNode [true|false] - vars ノードを結果から除外します (true または false、デフォルトは true)
    • nodePath - pathSeparator (文字列、引用符で囲まれた) で区切られたノードのリストに従うパス
    • pathSeparator:nodePaths のリストを区切る文字 (文字列、デフォルトは ',')
    特殊ロジック
    なし
    エラー処理
    なし
    応答の詳細
    ["ノード 1"、 "ノード 2"、 "ノード 3"]

    ノード内のキーの戻り値 (returnValueForKeyAtNodeName-now)

    スナップショット内のノードの一部である特定のキーの値を返します。キーは、ノードに対して直接定義することも、データモデル内のノードの子の 1 つに対して低く定義することもできます。

    一意の keyName のこのエクスポーター値とエクスポート値の違いは、キー名がノードのサブツリー内でのみ一意である必要があることです。

    キー/ノードの組み合わせは、スナップショット内で一意であることが期待されます。キー/ノードの組み合わせが複数回見つかった場合は、エラーが発生します。

    引数
    • appName:アプリケーション名
    • deployableName:展開可能項目名
    • requestedFormat:要求された形式 (json/yaml/xml/ini/raw)
    • keyName - キー名 (文字列、引用符で囲む)
    • nodeName - ノード名 (文字列、引用符で囲む)
    特殊ロジック
    なし
    エラー処理
    keyName、nodeNameの組み合わせが見つからない場合は、空の応答が返されます。

    keyPath の戻り値 (returnValueForKeyPath-now)

    特定のパスの特定のキーの値を返します。

    引数
    • appName:アプリケーション名
    • deployableName:展開可能項目名
    • requestedFormat:要求された形式 (json/yaml/xml/ini/raw)
    • keyPath:pathSeparator (文字列、引用符で囲まれた) で区切られた末尾にキー名があるノード名のリスト
    • pathSeparator:keyPaths のリストを区切る文字 (文字列、デフォルトは ',')
    特殊ロジック
    なし
    エラー処理
    • keyPath が指定されていない場合、 keyPath 引数は指定されません。
    • keyPath が見つからない場合は、最後のノード名が見つからないことを示します 。パスが見つかりません <path>/<nodeName>。
    • keyPath が見つかり、ノード (キーではない) である場合、 指定された keyPath はキーではなくノードです。

    一意の keyName の戻り値 (returnValueForUniqueKeyName-now)

    スナップショット内の名前に基づいて、特定のキーの値を返します。ノード内のキーのエクスポート値とは異なり、キーはスナップショットデータモデル全体で一意であることが期待されます。複数のキーがサポートされています。
    注:
    このエクスポーターでは、xml 形式と ini 形式はサポートされていません。
    引数
    • appName:アプリケーション名
    • deployableName:展開可能項目名
    • requestedFormat:要求された形式 (json/yaml/raw)
    • keyName:キー名 (データアレイ)
    特殊ロジック
    キーがスナップショットに複数回存在する場合、エクスポーターは最初に見つかった値を返します (エラーを返します)。
    エラー処理
    • keyName が指定されていない場合、 keyName 引数は指定されません。
    • キーが見つからない場合は、 キー <keyName> が見つかりません。