ビュー:

Question:
.NET SDKやREST APIを使ったドキュメントのクリップ方法は?

Answer:
APIを使ったドキュメントのクリップは、以下の例で紹介するさまざまなシナリオ で行うことができます。

.NET SDKの使用
以下のコード例は、状況に応じて使用・変更することができます。

注意:ソースロケーションからドキュメントを削除することを選択する場合、ドキュメントのクリッピングの意味合いに注意すること。ソースドキュメントを削除するオプションがtrueの場合、ソースロケーションから完全に削除されます。 本番システムに移行する前に、まずテスト環境でこの機能をテストしてください。

ドキュメントを 背面に 付加する
プライマリにクリップしたい文書が入ったFile Cabinetオブジェクトを渡しており、これも2番目のパラメータとして渡しています。

 

public static Document AppendDocuments(FileCabinet cabinet, Document doc) 

        { 

            Document DocumentAfterAppend = doc.GetDocumentFromSelfRelation().PutToProcessDocumentActionRelationForDocument(new DocumentActionInfo() 

            { 

                DocumentAction = DocumentAction.Append, 

                DocumentActionParameters = new AppendActionParameters() 

                { 

  // Remove documents after clipping? 

                    RemoveSourceDocuments = true, 

                    DocumentsAtBack = new List<AppendActionDocuments>() 

                    { 

                        new AppendActionDocuments() 

                        { 

                            Documents = new List<int>() 

                            { 
                                // Doc Id's from source File Cabinet 

                                34, 35 

                            }, 

                            SourceCabinetId = cabinet.Id 

                        } 

                    } 

                } 

            }); 

            return DocumentAfterAppend; 

        } 

 

 

前面に ドキュメントを付加する
File Cabinetオブジェクトを渡しています。このオブジェクトには、クリップしたい文書が含まれており、2番目のパラメータとして渡しているプライマリ・キャビネットにも含まれています。

 

public static Document AppendDocuments(FileCabinet cabinet, Document doc) 

        { 

            Document DocumentAfterAppend = doc.GetDocumentFromSelfRelation().PutToProcessDocumentActionRelationForDocument(new DocumentActionInfo() 

            { 

                DocumentAction = DocumentAction.Append, 

                DocumentActionParameters = new AppendActionParameters() 

                {
                    // Remove documents after clipping? 

                    RemoveSourceDocuments = true, 

                    DocumentsInFront = new List<AppendActionDocuments>() 

                    { 

                        new AppendActionDocuments() 

                        { 

                            Documents = new List<int>() 

                            { 
                                // Doc Id's from source File Cabinet 

                                34, 35 

                            }, 

                            SourceCabinetId = cabinet.Id 

                        } 

                    } 

                } 

            }); 

            return DocumentAfterAppend; 

        } 

ドキュメントトレイからファイルキャビネットへのクリップ
ドキュメントトレイからファイルキャビネット内のドキュメントをクリップする場合、ドキュメントトレイのguidを関数に渡すことになります。

ファイルキャビネットからファイルキャビネットへのクリップ
ファイルキャビネットから他のファイルキャビネットにある文書をクリップするには、ファイルキャビネットのguidを関数に渡します。

同じファイルキャビネット内の文書をクリップする
同じファイルキャビネット内の文書をクリップするには、関数にファイルキャビネットのguidを渡します。


REST APIの使用
以下のエンドポイントが使用されますが、以下の状況を考慮して変更することができます。

エンドポイント: {{ServerUrl}}/{{Platform}}/FileCabinets/{{File Cabinet Guid}}/Operations/ProcessDocumentAction? docId={{DocId}} 

注意:ファイルキャビネットから文書トレイの文書にクリップしたり、同じ文書トレイから文書をクリップすることは、サポートされていない方法 です。試行した場合、以下のエラーが表示されます。
"Operation not supported for document trays!指定された方法はサポートされていません。"

フロントで文書をクリップする場合
本体のリクエストです 。

{
   "DocumentAction": "Append",
   "DocumentActionParameters": {
       "$type": "AppendActionParameters",
       "RemoveSourceDocuments": false,
       "DocumentsInFront": [{
           "SourceCabinetId": "b_323b7b58-b417-4243-af71-25c82afb7cc9",
               "Documents": [
                   280
               ]
       }],
       "DocumentsAtBack": []
   }
}

背中の書類の切り抜き用
本体依頼。

{
    "DocumentAction": "Append",
    "DocumentActionParameters": {
        "$type": "AppendActionParameters",
        "RemoveSourceDocuments": false,
        "DocumentsInFront": [],
        "DocumentsAtBack": [{
            "SourceCabinetId": "b_323b7b58-b417-4243-af71-25c82afb7cc9",
                "Documents": [
                    280
                ]
        }]
    }
}



ドキュメントトレイからファイルキャビネットへのクリップ
ドキュメントトレイからファイルキャビネット内のドキュメントをクリップするには、エンドポイントのURLでファイルキャビネットのguidを参照し、「SourceCabinetId」のボディ要求でドキュメントトレイのguidを参照します。

ファイルキャビネットからファイルキャビネットへのクリップ
ファイルキャビネットから別のファイルキャビネットにある文書をクリップするには、エンドポイントの URL で宛先ファイルキャビネットの guid を参照し、「SourceCabinetId」のボディリクエストでソースファイルキャビネットの guid を参照します。

同じファイルキャビネット内からのクリップ
同じファイルキャビネット内の文書をクリップする場合は、エンドポイントのURLとボディリクエストの「SourceCabinetId」の両方でファイルキャビネットのguidを参照することになります。

クラウドとオンプレミスの 両組織に 適用できるKBA

ご注意:この記事は英語からの翻訳です。この記事に含まれる情報は、オリジナルの英語版製品に基づくものです。翻訳版の記事で使用されている文法などには、細かい誤りがある場合があります。翻訳の正確さを完全に保証することは出来かねますが、ほとんどの場合、十分な情報が得られると思われます。万が一、疑問が生じた場合は、英語版の記事に切り替えてご覧ください。