Product UpdatesStatus PageWorkato Academy
English
日本語
Get a trial
コネクター
アプリコネクター
Microsoft Dynamics 365
アクション

Microsoft Dynamics 365：オブジェクトスキーマの取得アクション ​

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

このアクションは、Microsoft Dynamics 365内の特定のオブジェクトの名前とスキーマを取得します。 このアクションを使用してスキーマを取得し、データベースまたはデータウェアハウスに複製します。

仕組み ​

基本 ​

アクションが実行されると、Workatoは指定したオブジェクトのスキーマをMicrosoft Dynamics 365 APIからリクエストします。

リクエストが成功すると、Microsoft Dynamics 365 APIはオブジェクトのname、label、および含まれるfieldsのリストを返します。

例：accountオブジェクトには、name、emailaddress、alternate_addressフィールドが含まれます。 このサンプルオブジェクトのJSONレスポンスを表示するには、以下をクリックします。

JSONレスポンスの例を表示
json
{
   "name":"account",
   "label":"Account",
   "fields":[
      {
         "name":"name",
         "label":"Name",
         "length":100,
         "scale":0,
         "precision":0,
         "original_type":"#Microsoft.Dynamics.365.StringAttributeMetadata",
         "mapped_type":"STRING",
         "custom":false
      },
      {
         "name":"emailaddress",
         "label":"Email address ",
         "length":100,
         "scale":0,
         "precision":0,
         "original_type":"#Microsoft.Dynamics.365.StringAttributeMetadata",
         "mapped_type":"STRING",
         "custom":false
      },
      {
         "name":"alternate_address",
         "label":"Alternate Address",
         "length":0,
         "precision":0,
         "scale":0,
         "original_type":"#Microsoft.Dynamics.365.PicklistAttributeMetadata",
         "mapped_type":"STRING",
         "custom":true,
         "fields":[
            {
               "name":"label",
               "label":"Label",
               "length":0,
               "scale":0,
               "precision":0,
               "original_type":null,
               "mapped_type":"STRING",
               "custom":false
            },
            {
               "name":"value",
               "label":"Internal value",
               "length":0,
               "scale":0,
               "precision":0,
               "original_type":null,
               "mapped_type":"INTEGER",
               "custom":false
            }
         ]
      }
   ]
}

データ型 ​

各fieldオブジェクトには、original_typeプロパティとmapped_typeプロパティも含まれます。 これらのプロパティは、Microsoft Dynamics 365内のフィールドのデータ型と、Workatoでマッピングされるデータ型を示します。 これらのプロパティは、データベースにロードされるときのデータの型指定方法を決定します。

例:

json
{
   "name":"budget_amount",
   "label":"Budget Amount",
   "length":1000,
   "scale":0,
   "precision":10000,
   "original_type":"#Microsoft.Dynamics.365.MoneyAttributeMetadata",
   "mapped_type":"DECIMAL",
   "custom":false
}

この例では、budget_amountフィールドはMicrosoft Dynamics 365でMoneyAttributeMetadataとして型指定され、WorkatoでDECIMALにマッピングされます。

詳細については、データ型マッピングセクションを参照してください。

入力 ​

フィールド説明
オブジェクトMicrosoft Dynamics 365から取得するオブジェクト。 使用可能なオブジェクトのリストから選択するか、オブジェクト名を入力できます。

オブジェクト名を入力する場合は、最初にアプリから取得する必要がある場合があります。
アプリの手順を表示
  1. Dynamics 365アプリで、設定（歯車アイコン）＞詳細設定に移動します。
  2. 設定メニューで、カスタマイズ＞カスタマイズをクリックします。
  3. 次に、システムのカスタマイズ、続いてエンティティを選択します。
  4. ページ左側のナビゲーションで、エンティティを見つけて選択します。
  5. エンティティの全般タブで、名前フィールドを見つけます。

出力 ​

このレシピのOutputは、Microsoft Dynamics 365オブジェクトのスキーマの詳細を示すオブジェクトになります。 このオブジェクトには、オブジェクトのフィールドを説明するFieldオブジェクトのリストが含まれます。

JSONオブジェクトの例を表示するには、基本セクションを参照してください。

オブジェクト ​

フィールド説明
名前オブジェクトの名前。 例：account
ラベルオブジェクトの表示ラベル。 例：Account
カスタムtrueの場合、オブジェクトはユーザーによって作成されています。
フィールドオブジェクトに含まれるフィールドのリスト。 フィールドに含まれるスキーマを確認するには、フィールドオブジェクトセクションを参照してください。

フィールド ​

取得されたオブジェクト内のすべてのフィールドには、次のフィールドが含まれます：

フィールド説明
名前フィールドの名前。 例：emailaddress
ラベルフィールドの表示ラベル。 例：Email Address
長さフィールドが保持できる最大文字数。 この値は、BOOLEANフィールドまたは制限のないフィールドでは0になります。
スケール小数点の右側の最大桁数。 この値は、数値以外のフィールドでは0になります。
精度小数点の左側と右側の数値を含め、列に格納できる最大桁数。 この値は、数値以外のフィールドでは0になります。
元の型Microsoft Dynamics 365内のフィールドのデータ型。 例：StringAttributeMetadata
マッピング型Workatoでoriginal_typeがマッピングされるデータ型。 この型は、データベースにロードされるときの列のデータ型を決定するために使用されます。 詳細。
カスタムtrueの場合、このフィールドはユーザーによって作成されています。
フィールドOriginal typeの値がBooleanAttributeMetadata、PicklistAttributeMetadata、StatusAttributeMetadata、またはStateAttributeMetadataのフィールドにのみ適用されます。

存在する場合、fieldsプロパティには、labelとvalueの2つのネストされたフィールドが含まれます。 これらのフィールドは、トップレベルのフィールドと同じスキーマを持ちます。 例： 
{
   [...],
   "fields":[
      {
         "name":"label",
         "label":"Label",
         "length":0,
         "scale":0,
         "precision":0,
         "original_type":null,
         "mapped_type":"STRING",
         "custom":false
      },
      {
         "name":"value",
         "label":"Internal value",
         "length":0,
         "scale":0,
         "precision":0,
         "original_type":null,
         "mapped_type":"INTEGER",
         "custom":false
      }
   ]
}
注：ネストされたフィールドのmapped_type値は、ネストされたフィールドのnameによって異なります。

  • label：この値はSTRINGになります
  • value：親フィールドのOriginal type値がBooleanAttributeMetadataの場合、この値はBOOLEANになります。 それ以外の場合、この値はINTEGERになります。

リファレンス ​

データ型マッピング ​

次の表は、Microsoft Dynamics 365のデータ型がWorkatoのデータ型にどのようにマッピングされるかを詳しく示しています。

この表の列は次のとおりです：

  • Microsoft Dynamics 365データ型：フィールドのoriginal_type値
  • Workatoマッピング型：フィールドのmapped_type値

例：original_type: BigIntAttributeMetadata値を持つフィールドは、mapped_type: BIGINT値にマッピングされます。

Microsoft Dynamics 365データ型Workatoマッピング型
BigIntAttributeMetadataBIGINT
BooleanAttributeMetadataSTRING
DateTimeAttributeMetadataDATETIME_TZ
DecimalAttributeMetadataDECIMAL
DoubleAttributeMetadataFLOAT
EntityNameAttributeMetadataSTRING
FileAttributeMetadataSTRING
ImageAttributeMetadataSTRING
IntegerAttributeMetadataINTEGER
LookupAttributeMetadataSTRING
MemoAttributeMetadaMemoAttributeMetadatataSTRING
MoneyAttributeMetadataDECIMAL
MultiSelectPicklistAttributeMetadataSTRING
PicklistAttributeMetadataSTRING
StateAttributeMetadataSTRING
StatusAttributeMetadataSTRING
StringAttributeMetadataSTRING
UniqueIdentifierAttributeMetadataSTRING

Last updated: