※この記事は全文機械翻訳されています。

この記事では、以下のトピックについて説明しています。

この記事では次のトピックについて説明します：

アップロードフォルダまたはアップロードフォルダの親フォルダで命名規則が有効な場合、アップロードが正常に完了するには、ローカルファイル名が規則に準拠している必要があります。

ファイル名が規則に従わない場合、以下のエラーが表示されます。

<ファイル名>命名規則に一致しません

ファイル名のどの部分が不足しているかを確認するために、ブラウザ経由でファイルを手動でアップロードしてください。

サーバープロジェクト位置を開く際に、複数のエラーが発生する可能性があります。

ローカルファイルをプロジェクトに同期するには、Catenda Hubのプロジェクトのドキュメントセクションにフォルダが少なくとも1つ必要です。

デスクトップコネクタが初めて開かれるとき、ユーザーがアクセスできるすべてのプロジェクトが読み込まれます。

更新しないと、次回には同じプロジェクトが表示されます。

ユーザーがプロジェクトへのアクセスを失った場合、プロジェクトのアップロードタスクまたはダウンロードタスクのサーバー位置を設定しようとすると、以下のメッセージが表示されます。

プロジェクトアクセスについては、プロジェクト管理者にアクセスをリクエストしてください。

プロジェクトアクセスの連絡先については、Catendaサポートにお問い合わせください。

このセクションでは次のトピックについて説明します：

ドキュメント名はCatendaの命名規則で制限できます。

フォルダは制限できません。

命名規則を使用しない場合、任意の名前のドキュメントをアップロードできます。

この場合、Catendaはドキュメントのファイル拡張子を登録できなかった可能性があります。

任意の名前のフォルダを作成できます。

したがって、デスクトップコネクタがWindows機能用に予約されている名前の文字で問題が発生する可能性があります。

一般的な問題は、以下の文字で発生します。

/ - スラッシュ \ - バックスラッシュこれらの文字はWindowsのファイルパス階層で使用されており、ドキュメントが間違った場所に配置される原因になります。

Windowsで予約されているものの広範なリストについては、https://learn.microsoft.com/en-us/windows/win32/fileio/naming-a-fileを参照してください。

ドキュメント名はCatendaの命名規則で制限できます。

フォルダは制限できません。

命名規則を使用しない場合、任意の名前のドキュメントをアップロードできます。

この場合、Catendaはドキュメントのファイル拡張子を登録できなかった可能性があります。

任意の名前のフォルダを作成できます。

したがって、デスクトップコネクタがWindows機能用に予約されている名前の文字で問題が発生する可能性があります。

一般的な問題は、以下の文字で発生します。

. - ピリオド

Windowsではピリオドで終わるフォルダとファイルは許可されていないため、ダウンロードタスクから作成されたドキュメントのフォルダまたはファイルの末尾のピリオドが削除されます。

アップロード時、ピリオドは適切なフォルダを見つけるプロセスで削除されるため、2方向同期時にダウンロードされたドキュメントは正しい場所に配置されます。

- スペース

Catendaでは、ドキュメントまたはフォルダ名の末尾にスペースを手動で追加することは可能ですが、Windowsではドキュメントおよびフォルダ名の末尾のスペースが削除されます。

Catendaにスペースが含まれている場合、ダウンロードされたフォルダの名前は、スペースを含める可能性のあるCatenda内のフォルダの名前と異なります。

同じフォルダでアップロードタスクが作成されると、Windows上のファイルまたはフォルダ名にスペースがないため、新しいフォルダが作成されます。

このセクションでは次のトピックについて説明します：

インポートシステムが以前に作成されたアイテムを処理できない場合、以下のエラーが発生します。

デスクトップコネクタ ドキュメントは既に存在します (コード: 25)

ログファイル

具体的には、同じタイトルを持つフォルダが既に存在するのに、2回目に"A"というタイトルのフォルダをアップロードしようとするときに発生する可能性があります。

ローカル フォルダの名前を"A"から"A_"のような名前に変更することをお勧めします。

これにより、タスクが問題に直面することがなくなります。

アップロードタスクが完了したら、同期されたバージョンをCatenda上の"A"に変更して、両側を同じに保ちます。

タスク自体では、以下が表示されます。

このエラーの問題がなんであるかについてもっと読むには、こちらをクリックしてください。

ドキュメントの最新リビジョンが取り消されました。

この場合、ログファイルにエラーメッセージがありません。

デスクトップコネクタがドキュメントからデータを抽出してアップロードするか、ダウンロードされたデータでドキュメントを更新するには、ドキュメントへのアクセスが必要です。

別のプロセスでドキュメントが使用されている場合、デスクトップコネクタはドキュメントにアクセスできません。

ドキュメントが使用中の場合、以下のエラーが表示されます。

デスクトップコネクタ プロセスは別のプロセスで使用されているため、ファイル'<ファイル パス>'にアクセスできません。

ログファイル

ファイルを使用中の可能性のあるプロセスには、以下が含まれます。

デスクトップコネクタ自体からの別のタスク、Dropbox、OneDrive、Google Driveなどのファイル同期サービス、その他のCDE同期ツール、ファイルを編集のために開いているプログラム。

ドキュメントが使用中の場合、ファイルの1つにアクセスできない場合、タスクは停止し、続行しません。

複数のタスクがスケジュールされている場合、次のスケジュール時刻に再試行します。

このセクションでは次のトピックについて説明します：

タスク内で「今すぐアップロード/ダウンロード」をクリックして手動で開始されたタスクは、タスクが開始されるとすぐに「アップロード中」または「ダウンロード中」のステータスを表示します。

手動で開始されたタスクと予定に従って開始されたタスクの両方について、タスクが開始されるとログファイルに次のようなメッセージが表示されます。

ログファイル <メッセージ番号>|<日付/時刻>|情報|1|LoggingExtension|ログを開始

タスク内で「今すぐアップロード/ダウンロード」をクリックして手動で開始されたタスクは、タスクが実行中である限り「アップロード中」または「ダウンロード中」のステータスを表示します。

手動で開始されたタスクと予定に従って開始されたタスクの両方について、実行中のタスクの状態はアプリケーションのネットワーク使用量を監視することで確認できます。

初期起動フェーズ

デスクトップコネクタタスクは、1キロバイト/秒から1メガバイト/秒の間で使用しているときに初期起動フェーズにあります。

このフェーズでは、タスクのネットワーク使用量は最小限です。

ダウンロードタスク初期起動フェーズでは、サーバー位置内のドキュメントはローカルファイルと照合されます。

新しいリビジョンをダウンロードする必要がある変更されたサーバーファイルがあるか、またはローカルシステムにダウンロードする必要があるサーバー側に新しいファイルがあるかを確認します。

アップロードタスク初期起動フェーズでは、サーバー位置内のドキュメントはローカルファイルと照合されます。

新しいリビジョンをアップロードする必要がある変更されたローカルファイルがあるか、またはCatendaにアップロードする必要がある新しいローカルファイルがあるかを確認します。

アクティブフェーズ

デスクトップコネクタタスクは、1メガバイト/秒以上を使用しているときにアクティブフェーズにあります。

このフェーズでは、タスクのネットワーク使用量はシステムの残りの部分に影響を与える可能性があります。

ダウンロードタスクアクティブフェーズでは、デスクトップコネクタはCatendaからローカルシステムにファイルごとにファイルをアクティブにダウンロードしています。

アップロードタスクアクティブフェーズでは、デスクトップコネクタはローカルシステムからCatendaにファイルごとにファイルをアクティブにアップロードしています。

タスク内で「今すぐアップロード/ダウンロード」をクリックして手動で実行されたタスクは、タスクが停止されたとき、タスクが完了したときまたはエラーが発生したときに、タスク内に状態メッセージを表示します。

タスク完了

タスクが正常に完了したかどうかを確認する唯一の方法は、タスクを手動で実行することです。

タスク内で「今すぐアップロード/ダウンロード」をクリックしてそうしてください。

タスクが正常に完了すると、すべてのドキュメントがアップロードまたはダウンロードされたというメッセージがタスクに表示されます。

エラーが発生しました

発生したエラーの詳細な説明は、ログファイルで最近のエラーを確認することで確認できます。

ネットワーク使用量

予定に従って開始されたタスクが停止したかどうかを確認する唯一の方法は、アプリケーションのネットワーク使用量を確認することです。

デスクトップコネクタが2分以上1キロバイト/秒未満を使用している場合、実行中の可能性のあるタスクは停止され、再度起動しません。

再発するようにスケジュールされているタスクの場合、デスクトップコネクタがタスクの開始がスケジュールされている次の日付と時刻に実行されている場合は、新しいタスクが開始されます。

このセクションでは次のトピックについて説明します：

インターネット接続に問題がある場合、アップロードまたはダウンロードタスクは自動的に再起動されず、次のスケジュール時刻に再度実行されます。

また、タスクに移動してアップロードボタンまたはダウンロードボタンをクリックしても手動で開始できます。

接続なし

アップロードまたはダウンロードタスクを開始するときにインターネット接続が利用できない場合、以下のエラーがアップロードまたはダウンロードタスクに表示されます。

タスク開始中に接続が失われたCatendaサーバーに接続しようとしたときにインターネットへの接続が失われたまたはタイムアウトした場合、次のエラーが表示されます。

使用される接続方法はタスク開始時に利用可能な優先される方法に依存します

タスクが開始されると、優先されるインターネット接続方法との接続が行われます。

たとえば、タスクが実行されるときに有線接続とWiFi接続が利用可能な場合、有線接続が優先されることがよくあります。

タスクが開始されるときにWiFi接続のみ利用可能で、実行中に有線接続が接続されている場合、コネクタは利用可能である限り初期接続を使用し続け、後で利用可能になった優先接続に切り替わりません。

フォールバックなしでインターネット接続が利用できなくなった

タスクが開始したときに接続が1つだけ利用可能だった場合、またはまったく接続が利用できなかった場合(例えば、飛行機モード)、以下のエラーが表示される可能性があります。

フォールバック付きでインターネット接続が利用できなくなった

タスクが開始したときに複数の接続が利用可能で、使用中の接続が失われた場合、コネクタは利用可能な他の接続の1つに切り替えようとします。

この切り替え中に以下のエラーが表示される可能性があります。

Catendaデスクトップコネクタにはハードコードされた10分のセッション制限があります。

デスクトップコネクタはしばしば一度に複数の短いセッションで動作するため、これはタスクが10分後にタイムアウトすることを意味しません。

25GBまでのポイントクラウドのような大きなファイルは、通常より長くセッションを取得する可能性があり、10分の制限内にアップロードされない場合はタイムアウトする可能性があります。

この状況ではサポートにお問い合わせください。

この問題を解決するのに役立つベータ版は、リクエストごとに利用可能です。

ベータ版では、この制限はわずかに増加しますが、ベータ版でも15分後の代わりにタイムアウトする可能性があります。

アップロード/ダウンロード側またはCatenda側の接続速度に応じて、ファイルをアップロードするのに長短かかる場合があります。

タスクが長すぎる場合、接続がタイムアウトする可能性があります。

Catendaタイムアウト

転送に時間がかかりすぎた場合、タイムアウトして以下のエラーが表示されます。

この状況ではサポートにお問い合わせください。

この問題を解決するのに役立つベータ版は、リクエストごとに利用可能です。

Catendaサービス利用不可Catenda APIが、デスクトップコネクタがそれに到達しようとしている瞬間にリクエストを受け取ることができない場合、以下のメッセージが表示されます。

デスクトップコネクタ HTTP エラー 503 サービス利用不可

ログファイル

これは多くの場合、サーバーが過負荷になり、多くのユーザーが一度にリクエストを送信しようとしているためです。

ゲートウェイタイムアウト

ゲートウェイタイムアウトは、Catenda APIが正常に動作し、初期リクエストが適切に受信されたことを示していることがよくあります。

ただし、このリクエストを処理することになっていたサービスは、時間内に応答しませんでした。

デスクトップコネクタ 504 ゲートウェイ タイムアウトログファイル

これは、Catendaがリクエストを適切に受信しているが、リクエストを処理するサーバーが一時的に利用できないことを示している場能があります。

マシンが十分に利用できない場合に発生することがありますが、その後、より多くのマシンが自動的に起動しますが、これには時間がかかる場合があります。

アクセストークン期限切れCatendaアクセストークンは1時間後に更新する必要があります。

デスクトップコネクタがナビゲートされると、トークンが自動的に更新されるため、これは通常問題ではありませんが、1時間以上の時間がかかるタスクが開始されると、タスクに使用されたアクセストークンはタスク中にタイムアウトする可能性があります。

これが発生すると、以下のエラーがデスクトップコネクタに表示されます。

1時間以上の時間がかかるタスクの場合は、タスクを再起動するか、次のスケジュール済みタスクが残りの作業を実行するまで待ちます。

デスクトップコネクタ 例外タイプ'BimsyncApp.Exceptions.BimAuthenticatorException'がスロー されました。

ログファイル

外部ハードドライブからダウンロードまたはアップロードするときに、デバイスの切断を試みた場合、デバイスが現在使用中であることを示すエラーがWindowsから表示されます。

Windowsがインストールされているドライブ上にあるフォルダの場合、適切なフォルダ権限が必要です。

ダウンロード先のフォルダを右クリックして、適切な権限を許可してください。

この場合、ログファイルは以下のエラーを与えます。

Windowsのフォルダを開くことはできますが、Windowsは"No-Write-Up"ポリシーを強制できます。

デスクトップコネクタはこのフォルダを選択させますが、タスクが実行されるとき、以下のメッセージが表示されます。

この場合、デスクトップコネクタはユーザーの"フルコントロール"権限に関係なく、書き込みがブロックされています。

このフォルダを削除するには、ユーザーが管理者特権を付与する必要があります。

状況によっては、フォルダを開いたままにしておくことができますが、他の状況では以下のメッセージが表示されます。

続行してもメッセージが表示されます。

「とにかくダウンロード」をクリックするとファイルがダウンロードされますが、そのフォルダが制限されているため、指定したフォルダにダウンロードできません。

デスクトップコネクタ ステータス: リダイレクト。 クリックしてダウンロード済みファイルを表示してください

ログファイル パス'<パス>'へのアクセスが拒否されました

「ダウンロード済みファイルを表示」をクリックして、ファイルがダウンロードされた位置を開きます。