Repository.XFRACAS.ImportXFRACASXMLFile: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
Line 2: Line 2:




<onlyinclude>Uploads an XFRACAS XML import file for processing. Returns an '''Integer''' that represents the import file's system ID. </onlyinclude>
<onlyinclude>Uploads an XML file to XFRACAS for processing. Returns an '''Integer''' that represents the import file's system ID. </onlyinclude>


All XML files must first be in the XFRACAS XML format before they can be successfully imported. To view the XFRACAS formats, see the [http://www.synthesisplatform.net/XFRACAS/en/XML_XFRACAS9_and_10.pdf XFRACAS9/10 Import Business Logic] (PDF) document.
You must have admin privileges in the XFRACAS entity in order to import data into it. In addition, the XML file must be in XFRACAS XML format in order to be successfully imported. The [http://www.synthesisplatform.net/XFRACAS/en/XML_XFRACAS9_and_10.pdf XFRACAS9/10 Import Business Logic] (PDF) document provides a complete description of the XFRACAS XML format.


== Syntax ==
== Syntax ==
Line 28: Line 28:


== Example ==
== Example ==
This example assumes that an XFRACAS XML file called "XMLDATA.xml" exists in the C: drive. The file is assumed to contain XFRACAS incidents. Also, the repository is assumed to be connected to an XFRACAS with existing entities.
This example assumes that the repository has a connection to existing XFRACAS entities. An XFRACAS XML file called "XMLDATA.xml" exists in the C: drive and the file is assumed to contain XFRACAS incidents.


  '''VB.NET'''
  '''VB.NET'''
   
   
  {{APIComment|'Add code to connect to a Synthesis repository.}}
  {{APIComment|'Add code to connect to the Synthesis repository.}}
   {{APIPrefix|Dim}} MyRepository {{APIPrefix|As New}} Repository
   {{APIPrefix|Dim}} MyRepository {{APIPrefix|As New}} Repository
   {{APIComment|...}}
   {{APIComment|...}}
   
   
  {{APIComment|'Import the XML file into the XFRACAS entity with ID# 10.}}
  {{APIComment|'Import the XML file into XFRACAS entity ID# 10.}}
   {{APIPrefix|Dim}} ImportXMLSystemID {{APIPrefix|As Integer}}
   {{APIPrefix|Dim}} ImportXMLSystemID {{APIPrefix|As Integer}}
   ImportXMLSystemID = MyRepository.XFRACAS.ImportXFRACASXMLFile(10, XFRACASImportType.Incident, {{APIString|"C:\XMLData.xml"}}, {{APIString|"XMLFileDescription"}})
   ImportXMLSystemID = MyRepository.XFRACAS.ImportXFRACASXMLFile(10, XFRACASImportType.Incident, {{APIString|"C:\XMLData.xml"}}, {{APIString|"XMLFileDescription"}})

Revision as of 23:01, 16 October 2015

APIWiki.png


Member of: SynthesisAPI10.Repository


Uploads an XML file to XFRACAS for processing. Returns an Integer that represents the import file's system ID.

You must have admin privileges in the XFRACAS entity in order to import data into it. In addition, the XML file must be in XFRACAS XML format in order to be successfully imported. The XFRACAS9/10 Import Business Logic (PDF) document provides a complete description of the XFRACAS XML format.

Syntax

.XFRACAS.ImportXFRACASXMLFile(entityID, importType, fileName, fileDescription)

Parameters

entityID

Required. Integer. The ID number of the XFRACAS entity to import the data into.

importType

Required. The XFRACAS element (e.g., incident, problem, etc.) to import. Can be any XFRACASImportType constant.

fileName

Required. String. The file path of the XML file to import.

fileDescription

Required. String. A description of the XML data to import.

Example

This example assumes that the repository has a connection to existing XFRACAS entities. An XFRACAS XML file called "XMLDATA.xml" exists in the C: drive and the file is assumed to contain XFRACAS incidents.

VB.NET

 'Add code to connect to the Synthesis repository. 
  Dim MyRepository As New Repository
  ... 

 'Import the XML file into XFRACAS entity ID# 10. 
 Dim ImportXMLSystemID As Integer
 ImportXMLSystemID = MyRepository.XFRACAS.ImportXFRACASXMLFile(10, XFRACASImportType.Incident, "C:\XMLData.xml", "XMLFileDescription")