イベントのインポート

CSV ファイルからイベントをインポートする方法

この投稿をシェアする

ととも​​に Timely アカウント、 CSV インポート ツールを使用すると、外部ソースから CSV ファイルからイベントを Journey カレンダーにインポートできます。 イベントを含む CSV ファイルを作成するガイドは次のとおりです。

CSV インポートは、技術に精通し、CSV ファイルの仕組みを理解しているユーザーを対象としています。これがあなたではない場合は、あなたをお勧めします 代わりに ICS フィードを使用してイベントをインポートします.

CSV ファイルでは、フィールド値の区切り文字はカンマ (,)、フィールド値の区切り文字は二重引用符 (「）。 CSV からインポートするには、正しいフィールド名を指定する必要があります 最初の行として:

少なくとも、最初の行には次のフィールドが必要です。

「タイプ」、「UID」、「DTSTAMP」、「概要」、「DTSTART」、「DTEND」

  • TYPE は常に「vevent」です
  • UID はイベントの一意の ID です
  • DTSTAMP はイベントが作成された時刻です
  • SUMMARYはイベントのタイトルです
  • DTSTART はイベントの開始時刻です
  • DTEND はイベントの終了時刻です

各 フィールド値 は厳密であると想定されます RFC2445/5545 フォーマット。たとえば、日付フィールド (DTSTART、DTEND など) には、TZID または VALUE DATETIME/DATE パラメータがプレフィックスとして付けられる場合があります。

詳細については、こちらをご覧ください ガイド 次のサンプル CSV ファイルをダウンロードして、独自の CSV ファイルを構築します。

サンプルCSV

を表示および/またはダウンロードするには、このリンクを参照してください。 ジャーニーのサンプル CSV.

Microsoft Excel で開かれた Journey サンプル CSV ファイルの印刷画面。

CSV ファイルに他のフィールドを追加する

他のフィールドも追加できますが、厳密な RFC2445 プロパティ名を使用する必要があります。一般的なユースケースに対応するために、特定のフィールドに対して追加の解析を実行します。

  • DTSTART/DTEND: これらは次のいずれかです DATE or 日付時刻 価値観。リンク先のページにある例は非常に明確です。それは タイムゾーンを指定することを強くお勧めしますそうしないと、日付と時刻の値が予期せずオフセットされる可能性があります。 重要: DATE をインポートする場合、イベントは終日イベントとみなされます。 DATETIME の場合、終日ではないとみなされます。したがって、たとえば、27 年 2013 月 20130127 日に終日イベントがある場合は、値 TZID=Europe/Rome:XNUMX を指定する必要があります (ローマのタイムゾーンに設定されています）。
  • LOCATION: 場所フィールドが Venue @ Address または Venue – Address の形式である場合、これを検出し、それに応じてフィールドをインポートします。それで アトミック バー @ Via Felice casati 24 輸入 アトミックバー 会場として、そして FeliceCasati経由24 アドレスとして。場所フィールドがこの形式と一致しないが、カンマ (,) が含まれている場合は、住所とみなされます。それ以外の場合は会場とみなされます。
  • X-TICKETS-URL: このプロパティは、 チケット購入URL フィールド。
  • X-COST: このプロパティは、 費用 フィールド。
  • 連絡先: このプロパティを使用して、連絡先名、電話番号、電子メール、および外部 URL (オーガナイザーの連絡先情報ペインに含まれます) を指定できます。これを行うには、セミコロン (;) を使用してフィールド名を区切る必要があります。 例： ニコラ・ペルケッティ。 00393347557225;ニコラ@time.ly; https://ニコラ.it 向きを変えるだろう ニコラ・ペルケッティ 連絡先名に、 00393347557225 電話に、 ニコラ@time.ly 電子メールに送信し、 https://nicola.it 外部 URL に挿入します。
    上記のフィールドはいずれもオプションであり、任意の順序で指定できます。値に @ が含まれる場合、それは電子メール アドレスとみなされます。 :// が含まれている場合、URL とみなされます。数値の場合は電話番号とみなされます。それ以外の場合はすべて、連絡先名とみなされます。 CONTACT プロパティが指定されていない場合は、デフォルトで ORGANIZER プロパティの値が使用されます。
  • RRULE: これらのフィールドを使用して、繰り返しルールを指定できます。これらはイベントの「繰り返し」部分でインポートされます。これを使用して、たとえば毎週水曜日、または毎月第 2 金曜日に発生するイベントを指定します。それらは非常に複雑になる場合があります。参考資料が見つかる （茶事の話はこちらをチェック）.
  • GEO: このフィールドは、イベントの場所を指定するために使用されます。有効な緯度と経度をセミコロンで区切って指定する必要があります。たとえば、18.4444464;14.777777。これは緯度と経度のフィールドにインポートされ、そのイベントの「座標を入力」チェックボックスがチェックされます。参考資料が見つかる （茶事の話はこちらをチェック）.
  • CATEGORIES: カテゴリのカンマ区切りのリスト。カテゴリが存在しない場合は作成されます。
  • X-TAGS: タグのカンマ区切りのリスト。タグが存在しない場合は作成されます。

ご覧ください このページ CSV にフィールドとして追加できる他の iCalendar (.ics) プロパティへの参照。

イベントに画像を追加する

画像を注目の画像として追加するには、フィールド X-WP-IMAGES-URL を CSV ファイルに追加し、画像の URL を通知します。

イベントの説明に画像を追加するには、画像の URL を含む HTML img タグを DESCRIPTION フィールド内に追加します。例えば、画像リンク.png />。

いくつかのインポートフィールドを含むスプレッドシートの印刷画面

スプレッドシートの画像フィールドの詳細の印刷画面

よくある落とし穴の回避

多くのユーザーが、簡単に回避できる CSV インポートの問題を報告しています。 CSV を生成するときは、次の点を考慮してください。

  1. すべてのテキスト データを二重引用符で囲みます。これにより、テキスト データ内でカンマを使用できるようになります。二重引用符を使用しない場合、インポートが失敗するか、正しくないインポートが行われる可能性があります。これらはカンマ区切り値 (CSV) であることに注意してください。

  2. これらの二重引用符内には、機能しない可能性のある特定の文字があります。対応する HTML 特殊文字を使用する必要があります。たとえば、コロン () には HTML 特殊文字を使用する必要があります。:）。正しく入力されていない場合、一部のデータがインポートされません。使用できる HTML 特殊文字の完全なリストについては、以下を参照してください。 このリファレンス.

    注: データの 1 文字として二重引用符を使用する場合は、バックスラッシュ (\）。これらのよくある落とし穴を回避する方法の詳細については、添付の CSV を参照してください。

警告が表示された場合は、二重引用符が正しく使用されているか、HTML 特殊文字が使用されているかを確認してください。すべてではないにしても、ほとんどのエラーが解決されます。

Outlook CSV エクスポートの使用

現在、Outlook から CSV ファイルのエクスポートをインポートすることはできません。これを解決するには、これを使用して、Outlook でエクスポートした CSV を *.ics (Google と Apple で使用される iCalendar ファイル形式) に変換できます。 オンラインコンバータツール。ダウンロードできる *.ics ファイルが生成されます。元の Outlook にエクスポートされた CSV ファイルの代わりに、アップロード ツールを使用して、この新しく変換された *.ics をアップロードします。

ファイルのアップロード

ファイルをアップロードするには、I に移動します。イベントのインポート > アップロードタブ。ファイルを選択してアップロードできるフォームのあるページが表示されます。

CSV/ICSファイルインポートフォームの印刷画面 Timely ダッシュボード

ファイルを選択すると、インポート オプションが利用可能になります。

ファイルが選択され、オプションが表示された CSV/ICS ファイルのインポート フォームの印刷画面 Timely ダッシュボード

ファイルが正常にアップロードされると、次のテキストがポップアップに表示されます。「ファイルは正常にアップロードされました。リクエストを処理中です。これには少し時間がかかる場合がありますが、完了すると通知が届きます。このウィンドウはもう閉じても大丈夫です。」

ファイルのアップロードが成功したことを通知するポップアップ メッセージの印刷画面

ファイルの処理が完了したら、ダッシュボードの右上隅にある通知領域でファイルのステータスを確認できます。

通知領域にアップロードされたファイルのステータスを印刷する画面 Timely ダッシュボード

 考えられるエラー

エラーを含むファイルをアップロードすると、エラー通知が届きます。このメッセージを表示するには、画面の右上隅にある通知パネルに移動します。 Timely ダッシュボード。

考えられるエラーは次のとおりです。

  • ファイルが無効であるか、不正な形式のデータが含まれています。この場合、CSV 形式を確認し、問題が解決しない場合は、サポート チームにお問い合わせください。

アップロードされたファイル内のデータが不正であるためにインポートされなかったイベントの通知を印刷画面で表示する

  • 条件が満たされていません。たとえば、過去のイベントのみを含むファイルをアップロードしようとして、「今後のイベントのみをインポートする」オプションがオンになっている場合、イベントはインポートされません。いずれにしてもこれらのイベントをアップロードしたい場合は、「今後のイベントのみをインポートする」オプションのチェックを必ず外してください。

「今後のイベントのみインポートする」オプションがチェックされているためにインポートされなかったイベントの通知と過去のイベントを含むファイルの印刷画面

まだ問題がありますか?

CSV インポートで引き続き問題が発生する場合は、サポート チームに優先サポート リクエストを送信してください。

ユーザーガイドの詳細については、次のサイトをご覧ください。 ヘルプセンター。ご質問がある場合、または追加のサポートが必要な場合は、サポート チケットを開いて、お気軽にお問い合わせください。 Timely アカウントのダッシュボード。

すべてのイベントをインポートして解決したら、開始します 正しい方法でチケットを売る.