webページからファイルを開く

"open"コマンドは、Fusionで指定されたファイルを開きます。これは、「New Design from File」コマンドを使用するのと、同じ結果を持っています。新規デザインを作成するとき、指定されたファイルが、テンプレートとして使われます。新しいファイルは、元のファイルから完全に独立しています。そして、それを保存するには、A360上で、位置とファイル名を指定する必要があります。Fusionが、実行されている場合、新規デザインは、実行されているセッションの内に作成されます。Fusionが、実行されていない場合、それは開始され、その次に、デザインが作成されます。以下に示すように、"open"コマンドを使うとき、"file"引数が、必要です。

<a href="fusion360://command=open&file=c:/temp/SampleGear.f3d">Open a local file</a>

"file"引数は、コード化される（JavaScriptのencodeURIComponentと同様に）URIでなければなりません。encodeURIComponent関数は、特定の文字を、それらと等価なエスケープ・シーケンスで、置き換えます。上記の例では、ローカルファイルは開かれています。下記の例は、web上にあるファイルを開きます。

<a href="fusion360://command=open&file=http://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/images/SampleGear.f3d">Open a web file</a>

使われるファイル形式は、f3d、STEP、IGE、SAT、SMT、STL、やOBJ書式が使えます。そして、ファイル名は、Fusionが、ファイルの種類を知ることができるようにするために、正しいファイル拡張子を持っている必要があります。そして、適切なトランスレータを使用します。（例外については、以下の「拡張」引数を参照してください。）f3dファイルが、使われる場合、それは、結果として、モデルの完全な履歴が、デザインにコピーされるでしょう。STEP、IGES、SAT、およびSMTファイルを使用すると、新しいボディが作成されます。STLやOBJを使用すると、結果として、メッシュ・ボディが作成されるでしょう。STLやOBJファイルを開くと、結果として、ダイレクト・モデリング・デザインになります。

"insert"コマンドは、新しいコンポーネントとして、実行中のデザインに指定されたファイルを挿入します。Fusionが、実行されていない場合、それが、開始され、そして、ファイルは、最初の空のデザインに挿入されます。以下は、ローカルのf3dファイルを、現在、実行中のデザインに挿入する例です。以前の例との唯一の違いは、ファイルを、"open"の代わりに"insert"コマンドを使って、開くことです。openと同じように、Web上のファイルも使用でき、同じファイル形式もすべてサポートされています。

<a href="fusion360://command=insert&file=c:/temp/SampleGear.f3d">Insert a local file</a>

必要な "file"引数のほかに、また、動作を制御することで使用することができる、いくつかの追加のオプションの引数があります。そして、ファイルの他にFusionに、追加の情報を渡します。これらのうちのいくつかは、openコマンドやinsertコマンドでのみ適用可能であり、他のものは両方で動作します。引数は、以下の一覧の通りです。

NoMove引数は、オプションです。そして、"insert"コマンドだけが、有効です。既定では、あなたが、ファイルを挿入するとき、Fusionは、"Move"コマンドを呼び出します。それで、ユーザーは、作成だけされたコンポーネントを再配置することができます。このオプションの引数を使用して、あなたは、"Move"コマンドの呼出しを無効にすることができます。あなたが、f3dファイルを挿入している場合、固定されたコンポーネントが含まれている場合、この引数に関係なく、"Move"コマンドは呼び出されません。コードは、"NoMove"引数を用いて以下を説明します

<a href="fusion360://command=insert&file=c:/temp/SampleGear.f3d&NoMove=true">Insert a local f3d file, NoMove</a>

NoFit引数は、オプションです。そして、"insert"コマンドだけが、有効です。既定では、あなたが、ファイルを挿入するとき、Fusionは、Viewを合わせるので、画像の全てが、表示されます。このオプションの引数を使用して、あなたは、view fitを無効にすることができます。コードは、"NoFit"引数を用いて以下を説明します。

<a href="fusion360://command=insert&file=c:/temp/SampleGear.f3d&NoFit=true">Insert a local f3d file, NoFit</a>

Extension引数は、"open"と"insert"の両方で有効です。そして、どんなファイル形式が、挿入されているか、Fusionに伝えるために使用されます。既定では、Fusionは、ファイルの拡張子に依存します。そして、自動的に、適切なトランスレータを使用して、Fusionデザインにデータをインポートするでしょう。ファイルが、拡張子を含まない名前を持っている場合があります。この場合、あなたは、Fusionにファイルがどんな種類か伝える必要があります。"Extension"引数の値は、「.」を含むその個々のファイル形式の有効な拡張子です。例えば、あなたが、使用できるSTEPファイルのための「.stp」や「.step」。また、大文字と小文字を区別しないので、 ".STP"と ".STEP"も有効です。以下のコードは、拡張子なしで、WebからSTEPファイルを挿入する方法を説明します。ファイル名は、「SampleGearNoExtension」です。

<a href="fusion360://command=insert&file=http://help.autodesk.com/cloudhelp/ENU/Fusion-360-API/images/SampleGearNoExtension&Extension=.stp">Insert STEP file from web</a>.

この引数は、あなたが、新たに作成されたコンポーネントのためのプロパティ値を指定することができます。これは、新しいコンポーネントが、両方の場合で作成されるため、「open」と「insert」の両方で動作します。今日の時点で、Fusionは、以下に示される3つのコンポーネント・プロパティだけをサポートします。;Part Number、Part NameとDescription。

Part NumberとDescriptionは、どんな文字列でも使用できます。Part Numberは、既定で、Part Nameとして同じ値に設定されます。Part Nameは、ルート・コンポーネントのために固有で、ファイルの名前です。それは、同様に、ルート・コンポーネントの名前です。組み込まれたコンポーネントの場合は、コンポーネントの名前です。"properties"パラメータの値は、エンコードされたJSON文字列です。それは、あなたが設定したい、各々のプロパティの名前と値を指定します。Part Number、Part NameとDescriptionプロパティを設定するために、以下の例は、JSONを表示します。一旦、エンコードされると、URLで正常に使用できるようになります。：

{
   "PartName": "GearPart",
   "PartNumber": "ABC",
   "Description": "This is a Spur Gear" 
}

そして、これを使用してファイルを挿入する完全なリンクは、以下の通りです：

<a href="fusion360://command=insert&file=c:\temp\SampleGear.f3d&properties=%7B%22PartName%22%3A%22GearPart%22,
%22PartNumber%22%3A%22ABC%22,%22Description%22%3A%22This%20is%20a%20SpurGear%22%7D">Insert a local file</a>

コンポーネントが、"open"か"insert"のどちらかで作成されるとき、パラメーターは、あなたが、Fusionに追加の情報を渡すことができます。Fusionは、このデータを読み込まないか、保存しませんが、insertingFromURL」（「insertedFromURL」、「openingFromURL」や「openedFromURL」イベント（以下で説明される））で聞き取る、いずれかのアドインを通して、それを渡します。アドインは、それが選択をするどのような方法でも、この情報を使用することができます。例えば、なぜなら、マテリアル・データは、書式の一部として、提供されていません。マテリアルの名前は、このパラメータを通して、渡すことができます。そして、アドインは、「openedFromURL」や「insertedFromURL」イベントに対応することができます。privateInfoデータから、マテリアル情報を抽出します。そして、新たに作成されたコンポーネントに、それを割り当てます。一般的な使い方は、この情報をコンポーネントの属性として追加することで、アドインは、続いて、新しいコンポーネントで関連付けることができる部品と一緒に、すなわち、製造業者、追加の情報へのＵＲＬ、費用など、追加のグラフィック以外の情報を渡すことです。

privateInfoパラメータを通して渡されるデータについての唯一の要件は、URLで有効になるようにエンコードする必要があります。あなたが、更に複雑なデータを持っている場合、あなたは、JSONを使うことを選択することができます。あるいは、それは、あなたが選択するどんな書式も文字列にできます。なぜなら、あなたは、sender（呼び出されているhtml）とreceiver（Fusionイベントを通して）のデータの書式は、完全にあなた次第です。

idパラメータは、挿入時にのみ使用されます。それには、挿入されるコンポーネントのための固有のIDが含まれています。この値に対する2つの要件は、それは、意味を持つURLの有効な文字列であること、それに、特殊文字が含まれている場合、コード化する必要がることです。そして、それは、すべての他の部品に関して、一意である必要があります。既に、このデザインに挿入されているものだけでなく、これは、すべての場所にある部品全体で、完全に一意のIDを示しています。GUIDの使用は一般的ですが、また、それは、いくつかの他のベンダー固有の識別でもあります。あなたが、何に使用する場合でも、あなたは、確実に一意であることを確認する必要があります。Fusionは、全ての同じ部品を表すこのIDを使用して、複数のコンポーネントを作成しないようにします。IDが無ければ、あなたが、２回、同じファイルを挿入する場合、2つの一意のコンポーネントは、正確に同じジオメトリーに作成されます。これは、同じ部品の2つのインスタンスではなく、2つのユニークな部品として認識されるため、不必要なジオメトリーを作成し、また、BOMで、問題の原因になります。

IDは、コンポーネントが挿入されるたびに、いくつかの作業を行うFusionで、この問題を解決します。コンポーネントが挿入されるとき、Fusionは、IDパラメータが、中で渡されている場合、そして、それを、確かめるために、現在のデザインで、確認する場合、同じIDを持つ、既存のコンポーネントが存在する場合、確かめるために確認します。コンポーネントが、同じIDを持つ場合、挿入操作は中止され、そして、既存のコンポーネントのコピー操作が、開始されます。この結果、既存のコンポーネントのインスタンスが追加されます。