データ型

概要

これらのガイド全体を通して、特定の機能にはさまざまなデータ型が必要であることがわかります。Algonomy プラットフォームには独自のプログラミング言語はなく、フラットテキストと HTTP データを受け取り、JSON データを返します。これらの形式は、C や Python のような言語で求められる厳密な型指定要件には必ずしも準拠していません。ただし、エラーのリスクを最小限に抑えるために、各コンテキストで想定されるデータ型を明記しています。このガイドでは、それぞれの意味について説明します。

データ型ガイド

ASCII

ASCII データは、ASCII 文字セット(制御文字を除く)に準拠しています。アメリカのキーボードにある文字のみに限定されており、ほとんどの ID データには十分です。

テキスト

テキストデータ型(文字列とも呼ばれる)は、最も包括的かつ柔軟です。Algonomy プラットフォームは完全に UTF-8 に対応しているため、任意の UTF-8 文字列がテキストとして使用可能です。これには次のようなものが含まれます:

  • 英数字("1234567890"、"A Clockwork Orange")

  • 句読点および特殊文字("!@#$"、"™"、"&")

  • マルチバイト文字("?????"、"??? ?? ???"、"??????")

数値

小数を含む実数すべてが含まれます。整数も数値として許容されます(ただし、すべての数値が整数として受け入れられるわけではありません)。数値データを科学的記数法で送信しないでください。正しく解析されません。

小数

小数(float とも呼ばれる)は、小数点および任意の桁数を含む実数です(価格データや評価などでは小数点以下2桁が一般的です)。

整数

整数は、正負を問わず小数を含まない実数を指します。

ブール値

ブール型は、true または false のみを表す値です。表記方法はプログラミング言語によって異なりますが、ブール値には常に2つの選択肢しかありません:true と false。Algonomy では、"true"/"false"、"1"/"0"、"Y"/"N"、"on"/"off" といった表記を受け付けています。これらの値は大文字小文字を区別しません。ただし、使用する表記はファイル全体で一貫させることを推奨します。これはエラーの発生リスクを軽減するためです。

日付

Algonomy における多くの日付は、YYYY-MM-DD 形式で送信されます。たとえば、2017年1月3日は "2017-01-03" と記述されます。

ISO 日時

場合によっては、年・月・日だけでなく、より詳細な日時情報が必要です。そのような場合、ISO 8601 日付形式を使用します。これは時間とタイムゾーンオフセットを含む精密なフォーマットで、世界中どこでもシステムが同じ時刻として理解できるようにします。たとえば、先ほどの2017年1月3日に、午後3時および大阪(日本)のタイムゾーンを加えた場合、"2017-01-03T15:00:00+09:00" となります。

列挙型(Enum)

列挙型(enum)とは、あらかじめ定義された限定的な文字列のセットです。ブール型も列挙型の一例で、値が true または false に限定されます。Algonomy のソリューションでは厳密な列挙型ではなく、指定された値が保存されたり検証されたりはしません。技術的には通常のテキストフィールドですが、値を少数の繰り返し使用されるパターンに制限すべき場合には、列挙型として扱うことを推奨します。どのような文字列にするかは、お客様にお任せします。