importMetadata

import metadataタイプのジョブで指定されたインポート設定を使用して、メタデータをアプリケーションにインポートします。オプションで、メタデータのインポート元のZIPファイルの名前を指定できます。

uploadFileコマンドを使用して、メタデータを含むファイルをデフォルトのアップロード場所にアップロードします。

適用対象

PlanningPlanningモジュールフリーフォームFinancial Consolidation and CloseTax ReportingEnterprise Profitability and Cost ManagementSales PlanningおよびStrategic Workforce Planning

必要な役割

サービス管理者

使用方法

epmautomate importMetadata JOB_NAME [FILE_NAME] errorFile=ERROR_FILE.zip。ここで:
  • JOB_NAMEは、アプリケーションに定義されたジョブ名です。
  • FILE_NAMEはオプションで、メタデータのインポート元のZIPファイルの名前を指定します。指定した場合、このZIPファイルの内容はジョブで定義されたファイル名よりも優先されます。ZIPファイルには1つ以上のCSVファイルが含まれている場合があります。ディメンションのメタデータが含まれるファイル名は、ジョブで定義されたインポート・ファイル名と一致するか、末尾が_DIMENSIONNAME.csvである必要があります。たとえば、metadata_Entity.csvmetadata_HSP_Smart Lists.csvmetadata_Exchange Rates.csvなどです。
  • errorFileはオプションで、却下されたレコード(ある場合)をインポート操作中に記録するZIPファイルの名前を指定します。送信ボックスに同じ名前のZIPファイルがある場合は上書きされます。このファイルは、downloadFileコマンドを使用してダウンロードできます。

注:

  • old_nameまたはunique_nameプロパティが変更されたロード・ファイルを使用してメタデータのインポート・ジョブを実行し、メンバーの名前を変更することはできません。メンバーの名前変更は無視されます。
  • このコマンドを使用してメタデータをインポートしている間、属性ディメンションは削除できません。
  • ジョブでメタデータのインポートが設定されているディメンションのメタデータのみがインポートされます。他のディメンションのメタデータは、ZIPファイルに含まれる場合、無視されます。

    ZIPファイルについて次の条件がどちらもtrueの場合、インポート状況が曖昧になります。

    • ジョブで定義されているファイル名と同じ名前のメタデータ・ファイルがZIPに含まれている

    • _DIMENSIONNAME.CSVまたは_DIMENSIONNAME.TXTで終わる名前のメタデータ・ファイルがZIPに含まれている。ここでDIMENSIONNAMEはメタデータのインポート先であるディメンションの名前。

ZIPファイルには、ジョブで参照しているものと同じ名前のメタデータ・ファイルか、_DIMENSIONNAME.CSV (または_DIMENSIONNAME.TXT)で終わる名前のファイルのどちらかを含め、両方は含めないことをお薦めします。たとえば、Employees_A-Z.CSVというメタデータ・ファイルを参照するジョブをEmployeesディメンションにロードする場合、ZIPファイルにはEmployees_A-Z.CSVNew_Employees.CSVのどちらかを含め、両方は含めないようにします。ZIPにEmployees_A-Z.CSVNew_Employees.CSVの両方が含まれている場合は、ZIPでのファイルの順序に応じてEPM自動化がどちらかのファイルをインポート対象として選択することがあります。Employees_A-Z.CSVファイルは、ジョブで参照されているファイル名と同じ名前なので、インポート対象として一致する可能性があります。一方、New_Employees.CSVも、_DIMENSIONNAME.CSVのパターンと同じ名前なので、一致する可能性があります。

epmautomate importMetadata importAccount importAccount.zip errorFile=metadataImport_error.zip