FileRecord

POST Request

To upload a Visio template XML file or image file, use the following URI.

/api/v2/fileRecord

You can upload a file up to 5 MB in size.
Encode the request body as multipart/form-data.
Use the following attributes in the request body:

Field	Type	Required	Description
file		Yes	Content of the file that you want to upload. File content should be in binary format, UTF-8 encoding.
type	String	Yes	Type of file that you want to upload. Use one of the following values: MAPPING. Use to upload a Visio template XML file. Use for XML files only. IMAGE. Use to update an image file for a Visio template. Use for JPEG or PNG files only

In addition to the POST attributes, pass the following information in the request body:
Boundary value. Used to define different parts of the request body.
File name. The file name of the content you want to upload.
icSessionId. Informatica Intelligent Cloud Services session ID returned by the login resource. You can pass this information in the request body for clients that do not allow custom headers. If you can pass icSessionId as part of the request header, you can omit this information in the request body.
Use the following template for the fileRecord POST request:

URL: <serverUrl>/api/v2/fileRecord/ 
HTTP method: POST

Content-Type:multipart/form-data;boundary=<boundary value>
--<boundary value>
Content-Disposition:form-data; name="file";filename="<filename.ext>";Content-Type:text/<xml|json>

<content of the file you want to upload encoded as UTF-8>

--<boundary value>
Content-Disposition: form-data; name="type" 

<MAPPING | IMAGE>
--<boundary value>
Content-Disposition: form-data; name="icSessionId"

<icSessionID returned from login resource>
--<boundary value>--

POST Response

Returns the fileRecord object if the upload is successful. Returns the error object if errors occur.
The fileRecord object includes the following attributes

Field	Type	Description
id	String	ID for the uploaded file. You can use this ID to identify the file when you create or update a Visio template with the masterTemplate resource
orgId	String	Organization ID.
name	String	File name.
description	String	Description of the file.
createTime	Date/time	Time that the file was uploaded to the organization.
updateTime	Date/time	Last time that the file was updated.
createdBy	String	User who first uploaded the file.
updatedBy	String	User who last updated the file.
type	String	File type.
size	Int	File size.
attachTime	String	Time the file was associated with a Visio template.

DELETE Request

You can delete a Visio template XML or image file if the Visio template is not used by a Visio template.
To delete a file, use the file ID in the following URI:

/api/v2/fileRecord/<id>

DELETE Response

Returns the 200 response code if the request is successful.
Returns the error object if errors occur.

POST Example

To upload the VisioTemplate.xml file with an icSessionId of IV4wOrJmd6YUtmKa8t, you might use the following request. XML data should be encoded in UTF-8.

URL: https://example.informatica.com/saas/api/v2/fileRecord/ 
HTTP method: POST

Content-Type:multipart/form-data;boundary=243553118520053
--243553118520053
Content-Disposition:form-data; name="file";filename="<VisioTemplate.xml>";Content-Type:text/xml

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE Graph SYSTEM "graph.dtd">
<Graph Name="" Description="" UItype="" DlgSize="">
  <Groups />
  <Parameters>
    <Parameter Name="$EXTERNALID__C$" Label="" LabelWidth="" IsMandatory="True" DefaultValue="" Control="" Data="" Description="" />
    <Parameter Name="$TGT$" Label="" LabelWidth="" IsMandatory="True" DefaultValue="" Control="Combo_Ctrl" Data="Targets" Description="" />
    <Parameter Name="$GroupBy$" Label="" LabelWidth="" IsMandatory="True" DefaultValue="" Control="" Data="" Description="" />
    <Parameter Name="$o_PERCENT_FLD__C$" Label="" LabelWidth="" IsMandatory="True" DefaultValue="" Control="" Data="" Description="" />
    <Parameter Name="$SRC$" Label="" LabelWidth="" IsMandatory="True" DefaultValue="" Control="Combo_Ctrl" Data="Sources" Description="" />
  </Parameters>
  <Node NameID="Source Definition" Name="$SRC$" Reusable="" Type="Source Definition" InstanceName="$SRC$" Description="" isParameterized="True">
    <CustomProperty Name="Source Table" Value="$SRC$" isParameterized="True" />
    <CustomProperty Name="Database Name" Value="" isParameterized="False" />
    <CustomProperty Name="Owner Name" Value="" isParameterized="False" />
    <CustomProperty Name="Business Name" Value="" isParameterized="False" />
    <CustomProperty Name="Database Type" Value="" isParameterized="False" />
    <CustomProperty Name="Is ShortCut" Value="False" isParameterized="False" />
  </Node>
.
.
.
  <Link Name="Sheet.7" FromNameID="Aggregator" ToNameID="Target Definition" MasterInputSet="False" isParameterized="False">
    <Rule Text="Datatype:string" isParameterized="False" />
    <Rule Text="EXCLUDE Named:AUTO__C (TO) AUTO__C" isParameterized="False" />
    <Rule Text="Datatype:date/time" isParameterized="False" />
    <Rule Text="Pattern:_o$" isParameterized="False" />
    <Rule Text="Datatype:nstring" isParameterized="False" />
    <Rule Text="Datatype:ntext" isParameterized="False" />
    <Rule Text="Datatype:text" isParameterized="False" />
  </Link>
</Graph>

--243553118520053
Content-Disposition: form-data; name="type" 

MAPPING
--243553118520053
Content-Disposition: form-data; name="icSessionId"

IV4wOrJmd6YUtmKa8t
--243553118520053--

If the upload is successful, returns the fileRecord response object.