はじめに
メールによるDataSetコネクターを使用すると、メールメッセージの添付ファイルとして送信された.xlsファイル、.xlsxファイル、.csvファイルを取得して処理し、そのデータをすばやく簡単にDomoに取り込めるようになります。さらにメールによるDataSetコネクターには、GzipファイルやZipファイルを解析して.csvファイルや.xlsxファイルの形式で返す機能があります。このコネクターを設定すると、DomoのDataSetに使用する固有のメールアドレスが生成されます。メールアドレスが作成されると、そのメールアドレス宛てに添付ファイルとしてスプレッドシートを送信できるようになります。その後、コネクターがメールを処理し、その内容に沿ってデータを更新します。 現在、このコネクターで取り込むことができる添付ファイルデータは1件だけです。メールメッセージに複数の添付ファイルが含まれている場合は、添付ファイルリストの先頭のファイルからデータが取り込まれます。 このコネクターの設定を行うたびに、一連の固定特質を持つ添付ファイルの設定を行う必要があります。例えば、特定のパラメーターを含むCSVファイルの設定を作成すると、コネクターのインターフェースに戻ってファイルタイプをXLSに切り替えない限り、作成したメールアドレスにXLSのスプレッドシートを送信できません。添付ファイルのタイプを変更する場合は、専用のメールアドレスで新しい接続を作成することを強く推奨します。 Data CenterでメールによるDataSet接続を設定します。このトピックでは、メールによるDataSetコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加とDataSet情報の編集に関する一般的な情報については、「 コネクターを使用してDataSetを追加する 」を参照してください。必要条件
なし。認証情報は不要です。メールによるDataSet接続を設定する
このセクションでは、メールによるDataSetコネクターページの ［詳細］ ペインのオプションについて説明します。このページ内にある もう1つのペイン、 ［DataSetに名前を付け、説明を入力］ は、ほとんどのタイプのコネクターで共通しています。 詳細については「 コネクターを使用してDataSetを追加する 」を参照してください。［詳細］ペイン
このペインには、メールによるDataSet接続の設定に関する様々なオプションが表示されます。メニュー | 説明 |
|---|---|
| メール | 添付ファイルの送付先となるメールアドレスを自動的に作成します。 ［メールをコピー］ をクリックして、このメールアドレスをクリップボードにコピーします。 |
| ファイルの場所 | ファイルを取得する場所のオプションを以下から選択します。
|
| ファイルタイプ | 送信するファイルタイプを選択します。GZipとZ ip圧縮ファイルがサポートされています。圧縮ファイルは解凍され、選択したファイルタイプとして解析されます。 添付ファイルのファイルタイプを以下から選択します。
注記：
|
| 送信元メールアドレス | このコネクターがファイルを受信する送信元のフルメールアドレス、またはメールドメイン（例：@ domo.com ）を入力します。その他のアドレスからのメールは拒否されます。どんなメールアドレスからのメールでも許可する場合は「NONE」と入力します。 注記： 設定内のメールアドレスが、ファイルの送信先メールアドレスと一致していることを確認してください。 |
| メール件名の表現 | 送信するメールの件名を検証するための正規表現を入力します。件名がこの表現と一致しないメールは拒否されます。どんなメールの件名でも許可する場合は「NONE」と入力します。 次は完全一致の例です。 件名 = 1900 Audit Report for Domo |
| メール本文の表現 | 送信メールの本文を検証するための正規表現を入力します。本文がこの表現と完全に一致しないメールは拒否されます。すべての本文を許可する場合は「 NONE 」と入力します。 次は完全一致の例です。 本文 = DomoにアップロードするAudit Reportファイルを添付しました。 |
| 添付ファイル名の表現 | 添付ファイル名を検証するための正規表現を入力します。この表現と完全に一致しない添付ファイルは拒否されます。すべてのファイル名を許可する場合は「NONE」と入力します。 次は完全一致の例です。 添付ファイル = 1.audit_report_1.1.1900.1.00AM.xlsx |
高度なオプションを表示（チェックボックス） | このチェックボックスをオンにすると、高度な設定オプションが表示されます。 |
Include HTML Body（チェックボックス） | このチェックボックスをオンにすると、データにメッセージのHTML本文を含めます。 |
データにはヘッダー行が含まれています（オプション） | データが列ヘッダーを含む行を含んでいる場合はこのフィールドを「true」に設定します。データがヘッダー行を含まない場合は「false」に設定します。 |
ヘッダー行（オプション） | ヘッダー行番号を入力します。番号を入力しなかった場合、最初の行がヘッダー行とみなされます。 |
フッター行をスキップ（オプション） | インポートから除外する行がファイルの終わりに1行以上ある場合は、スキップする行数を入力します。 |
開始データ行（オプション） | デフォルトでは、 ヘッダー行 に続く行は 開始データ行 とみなされます。データが別の行から開始する場合は、その行番号を入力します。 |
| デリミター（オプション） | CSVファイルを解析するのに使用する区切り文字を選択します。 |
| エスケープ文字（オプション） | ファイルを解析するのに使用するエスケープ文字を選択します。 |
| 引用文字（オプション） | CSVファイルを解析するのに使用する引用文字を選択します。 |
| エンコードを検出（チェックボックス） | Domoでエンコーディングのタイプを自動的に検出する場合は、このチェックボックスをオンにします。常にUTF-8エンコーディングを使用する場合は、オフのままにしておきます。 |
| Encoding Options（オプション） | デフォルトでは、コネクターは信頼度の値にもとづいてエンコードを検出しますが、値は50％より大きくなければなりません。検出されたエンコーディングの最高値が50％未満であったとしても、 ［Consider Highest Encoding］ オプションを使えば、そのエンコーディングを考慮することができます。 ［Specify Encoding］ オプションを使用すると、以下の ［Enter Encoding］ テキストフィールドに任意のエンコードを入力できます。 |
| Enter Encoding | エンコーディングを指定します。 |
| 生のヘッダー （オプション） | ［はい］ を選択すると、コネクターは送信したファイルのヘッダーを使用します。 ［いいえ］ を選択すると、コネクターはヘッダーテキストに含まれる特殊文字を変更します。 |
日付形式（オプション） | 送信ファイルに使用される日付形式を選択します。 |
| 文字列としての数値の列（オプション） | ［はい］を選択すると、数値であるすべての列に対して列を追加して、それらを文字列としてフォーマットし、先頭のゼロ（0）を含む元のフォーマットを保持します。 |
| 文字列としての先頭のゼロ（0）（オプション） | ［はい］を選択すると、先頭にゼロ（0）がある数値（例：「01234」）を文字列として解釈します。これで先頭のゼロ（0）は残ります。 |
| デコードエラーを無視する（オプション） | ［はい］を選択すると、デコードエラーを無視します。 デコードエラーの前に処理されたデータのみが取得されます。 これは、メールファイルの末尾に不要な文字があり、その文字が破損している場合に推奨されます。 |
| 列名の先頭文字が数字であることを許可する（チェックボックス） | 列名の先頭に数字を使用することを許可するかどうかを選択します。許可しない場合、数字で始まる列名には必ず「C」という接頭辞がつきます（例：「C123」）。 |
| 空白行をスキップする （オプション） | このチェックボックスをオンにすると、DataSetに空白行が追加されないようにすることができます。 |
| 件名の正規表現 （オプション） | グループ化して正規表現を入力すると、件名にある各グループは列として追加されます。 |
| 本文の正規表現 （オプション） | グループ化して正規表現を入力すると、件名にある各グループは列として追加されます。 |
| HTML表番号 （オプション） | 表の番号を選択します。デフォルトでは最初に見つかった表が使われます。 |
| HTML表のタグ （オプション） | 表の表タグを選択します。デフォルトでは「table」が使われています。これは有効なHTML要素である必要があります。 |
| HTML行のタグ （オプション） | 表の行のタグを選択します。デフォルトでは「tr」が使われています。これは有効なHTML要素である必要があります。 |
| HTMLセルのタグ （オプション） | 表のセルのタグを選択します。デフォルトでは「td」が使われています。これは有効なHTML要素である必要があります。または「nbsp」が列を区切るために使われている場合はセルのタグとして［スペース］を指定します。 |
| Excelシート名 （オプション） | 解析したいExcelシート名を入力してください。 |
| ファイルのパスワード （オプション） | ファイルがパスワードで保護されている場合は、パスワードを入力します。 |
| Excelシートのタブ番号 （オプション ） | 解析したいExcelシートのタブ番号を入力してください。 |
| Use Raw Numbers （オプション ） | 値をそのまま数値として取得するには、このボックスをオンにします。 |
| Columns As String （オプション ） | 文字列列として追加する列のカンマ区切りリストを入力します。 |
| 属性を含める（チェックボックス） | データにXML属性を含めることを確認します。 |
| 一致するリンク（オプション） | リンクを設定してファイルをダウンロードします。［ファイルタイプ］が選択されている場合、 リンクに選択したファイルタイプの拡張子が必要です 。別の文字列を選択した場合は、一致する文字列を入力します。最初に一致するリンクが使用されます。 |
| 待機 （オプション） | メールのリンクからファイルをダウンロードするまでにかかる秒数です。 |
| 一致する添付ファイル | ダウンロードリンクに含まれているテキストを指定して、ファイルのダウンロードリンクを固有識別します。 |
| 一致する添付ファイルの正規表現 | ダウンロードリンクに含まれているテキストを指定して、ファイルのダウンロードリンクを固有識別します。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、 「 コネクターを使用してDataSetを追加する 」を参照してください。トラブルシューティング
行数や列数が予想以上に多くなるなど、データが正しく解析されません。
フィールドのデータ内の引用文字がフィールドを囲む引用符の1つとして解析されないように、引用文字がエスケープされていることを確認してください。引用文字は、以下の方法でエスケープすることができます。- バックスラッシュ（\）を使用します：“dimensions”, “two-by-four: 2” x 4""
- 引用文字を2回入力します：“dimensions”, “two-by-four: 2"" x 4"""