Repository.XFRACAS.ImportXFRACASXMLFile: Difference between revisions

Latest revision as of 17:00, 12 August 2016

Uploads the XML file to the XFRACAS import queue. Returns an Integer that represents the import file's record ID.

Remarks: The XML file will be processed at the next scheduled import, or you can choose to process immediately all items in the import queue by using the ProcessXfracasImports method.

For the XML file to be imported successfully, you must have the "Manage Import" admin permission in the XFRACAS entity where you are uploading the file, and the XML file must be in the correct XFRACAS XML format. The XFRACAS 11 Import Business Logic (PDF) document provides a complete description of the XFRACAS 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 an XML file called "XMLDATA.xml" exists in the C: drive.

VB.NET

 'Connect to a Synthesis enterprise repository. 
  Dim MyRepository As New Repository
  MyRepository.ConnectToSQLRepository("MyServer", "MyDatabase")

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

@@ Line 1: / Line 1: @@
-{{Template:APIClass|Repository Class|Repository}}
+{{DISPLAYTITLE:Repository.XFRACAS.ImportXfracasXmlFile Method}}{{Template:API}}{{Template:APIBreadcrumb|.[[Repository Class|Repository]]}}
-This function uploads an import file for processing and returns the system ID.
-To view XFRACAS formats refer to the [[XFRACAS XML Import Documentation|XFRACAS XML Import Documentation]].
+<onlyinclude>Uploads the XML file to the XFRACAS import queue. Returns an '''Integer''' that represents the import file's record ID. </onlyinclude>
+{{Template:API_XFRACASNote}}
 == Syntax ==
-*ImportXFRACASXMLFile( entityID {{APIPrefix|As Integer}}, ImportType {{APIPrefix|As}} [[XFRACASImportType]] , fileName {{APIPrefix|As String}}, fileDescription {{APIPrefix|As String}}) {{APIPrefix|As Integer}}
+ '''.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 Enumeration|XFRACASImportType]] constant.
+''fileName''
-Parameters
+:Required.  String. The file path of the XML file to import.
-:''entityID'': The ID of the entity to import into.
-:''ImportType'': The type of XFRACAS Import to utilize, specified as [[XFRACASImportType]].
+''fileDescription''
-:''fileName'': The file path of the XML file to import.
+:Required. String. A description of the XML data to import.
-:''fileDescription'': A description of the XML to import.
+== Example ==
+This example assumes that an XML file called "XMLDATA.xml" exists in the C: drive.
-== Usage Example ==
+  '''VB.NET'''
-  '{{APIComment|Declare a new repository connection class.}}
-  {{APIPrefix|Private WithEvents MyRepository As New [[Repository Class|Repository]]}}
+  {{APIComment|'Connect to a Synthesis enterprise repository.}}
-  '{{APIComment|Connect to the Synthesis repository.}}
+   {{APIPrefix|Dim}} MyRepository {{APIPrefix|As New}} Repository
- {{APIPrefix|Dim}} Success {{APIPrefix|As Boolean}} = {{APIPrefix|False}}
+   MyRepository.ConnectToSQLRepository({{APIString|"MyServer"}}, {{APIString|"MyDatabase"}})
- Success = MyRepository.[[Repository.ConnectToSQLRepository|ConnectToSQLRepository]]("SQLServerPath", "SQLDatabaseName")
- '{{APIComment|Get the list of XFRACAS Entities in the current project in the connected repository.}}
+  {{APIComment|'Import the XML file into XFRACAS entity ID# 10.}}
- {{APIPrefix|Dim}} ListOfXFRACASEntities() {{APIPrefix|As}} [[NameIdPair Class|NameIdPair]]
+   {{APIPrefix|Dim}} ImportXMLSystemID {{APIPrefix|As Integer}}
-  ListOfXFRACASEntities = MyRepository.XFRACAS.[[Repository.GetAllXFRACASEntities|GetAllXFRACASEntities]]()
+   ImportXMLSystemID = MyRepository.XFRACAS.ImportXfracasXmlFile(10, XFRACASImportType.Incident, {{APIString|"C:\XMLData.xml"}}, {{APIString|"XMLFileDescription"}})
-  '{{APIComment|Import the XML file into the entity desired.  In this example, the first entity is used.}}
- {{APIPrefix|Dim}} ImportXMLSystemID {{APIPrefix|As Integer}}
- ImportXMLSystemID = MyRepository.XFRACAS.[[Repository.ImportXFRACASXMLFile|ImportXFRACASXMLFile]](ListOfXFRACASEntities(0).ID, [[XFRACASImportType]].Incident, "XMLFileName", "XMLFileDescription")

Repository.XFRACAS.ImportXFRACASXMLFile: Difference between revisions

Latest revision as of 17:00, 12 August 2016

Syntax

Parameters

Example

Navigation menu

Search