Dateitypdatenquellen
Importieren Sie eine Datei aus einer lokalen Datenquelle, einem Remote-Netzwerkserver oder einer anderen Instanz, indem Sie einen Pfad und Authentifizierungsinformationen angeben.
Dateiabrufmethoden
Die folgenden Dateiabrufmethoden sind verfügbar, um die Datei, aus der sie sich befindet, in ServiceNow zu kopieren und in einen Importsatz zu laden.
Nachdem Sie die Dateien definiert haben, die für den Import kompatibel sind, definieren Sie, wie die Dateien importiert werden können.
| Methode | Beschreibung |
|---|---|
| Anhang | Fügen Sie Anhänge hinzu, und verwalten Sie sie Eine Datei in den Datensatz, und importieren Sie diese Datei in einen Importsatz. |
| SFTP | Rufen Sie eine Datei mit SFTP ab. Felder werden für den Servernamen und die Anmeldeinformationen bereitgestellt. |
| FTP | Rufen Sie eine Datei von einem FTP-Server in Ihrem Netzwerk ab. Felder werden für den Servernamen und die Anmeldeinformationen bereitgestellt. Hinweis: FTP-Übertragungen werden als Klartext gesendet und können nicht verschlüsselt werden. Verwenden Sie stattdessen nach Möglichkeit SCP oder SFTP. |
| FTPS (Auth-SSL) [nicht empfohlen] | Nicht empfohlen, da FTPS von einigen Firewall-Lieferanten nicht mehr unterstützt wird. Erwägen Sie die Verwendung von SFTP als Alternative. Ein über das SSL-Protokoll (Secure Socket Layer) ausgegebener FTP-Authentifizierungsbefehl. Diese Methode wird auch als explizites FTP über SSL bezeichnet. |
| FTPS (Auth-TLS) [nicht empfohlen] | Nicht empfohlen, da FTPS von einigen Firewall-Lieferanten nicht mehr unterstützt wird. Erwägen Sie die Verwendung von SFTP als Alternative. Ein über das TLS-Protokoll (Transport Layer Security) ausgegebener FTP-Authentifizierungsbefehl. Diese Methode wird auch als explizites FTP über TLS bezeichnet. |
| FTPS (implizite SSL) [nicht empfohlen] | Nicht empfohlen, da FTPS von einigen Firewall-Lieferanten nicht mehr unterstützt wird. Erwägen Sie die Verwendung von SFTP als Alternative. In impliziter Sicherheit definiert der FTPS-Server einen bestimmten Port für den Client (990), der für sichere Verbindungen verwendet werden soll. Implizite Sicherheit beginnt automatisch mit einer SSL-Verbindung, sobald ein FTPS-Client eine Verbindung zu einem FTPS-Server herstellt. |
| FTPS (implizite TLS) [nicht empfohlen] | Nicht empfohlen, da FTPS von einigen Firewall-Lieferanten nicht mehr unterstützt wird. Erwägen Sie die Verwendung von SFTP als Alternative. In impliziter Sicherheit definiert der FTPS-Server einen bestimmten Port für den Client (990), der für sichere Verbindungen verwendet werden soll. Implizite Sicherheit beginnt automatisch mit einer TLS-Verbindung, sobald ein FTP-Client eine Verbindung zu einem FTP-Server herstellt. |
| HTTP | Rufen Sie eine Datei mit HTTP ab. Felder werden für den Servernamen und die Anmeldeinformationen bereitgestellt. Wichtig: Bei HTTP- und HTTPS-Protokollen wird der Dateipfad automatisch URL-codiert. Geben Sie keinen URL-codierten Dateipfad an, wenn Sie eines dieser Protokolle verwenden. |
| HTTPS | Rufen Sie eine Datei mit HTTPS ab. Felder werden für den Servernamen und die Anmeldeinformationen bereitgestellt. Verwenden Sie diese Methode, um Daten zwischen ServiceNow-Instanzen zu übertragen. |
| SCP | Das Secure Copy Protocol (SCP) überträgt Dateien mithilfe des Secure Shell-Protokolls (SSH) sicher zwischen einem lokalen und einem Remote-Host oder zwischen zwei Remote-Hosts. |
Dateidatenquellenbeispiele
Diese Beispiele beschreiben, wie verschiedene Dateitypen als Datenquellen importiert werden.
Excel-Datenquellendatei
Sie können sowohl im XLSX-Format als auch im Legacy-XLS-Format importieren. XLS ist das Standardformat für Tabellen, die in Excel für Versionen 2003 und älter erstellt wurden. XLSX ist das Standardformat für Excel 2007 oder höher. Verwenden Sie XLSX anstelle von Legacy-XLS, wenn möglich, um eine optimale Leistung zu erzielen.
- Alle XLS-Dateien müssen das Datumssystem 1900 im Gegensatz zum Datumssystem 1904 verwenden. Das Datumssystem 1904 bewirkt, dass Ihre Daten mit einem Jahr importiert werden, das vier Jahre vor dem in Ihrer Tabelle angezeigten Datum liegt. Weitere Informationen zu Datumssystemen finden Sie unter MS Support.
- Beim Importieren einer Datei aus Excel mit booleschen Großbuchstaben von (WAHR/FALSCH) werden beide Werte immer in „falsch“ umgewandelt. Um dieses Verhalten zu verhindern, legen Sie fest glide.transform.boolean.casesensitiveEigenschaft auf „falsch“.
XML-Datenquellendatei
- XPath für jede Zeile
- XML-Datenquellendefinitionen verfügen über ein zusätzliches Feld zur Angabe von XPath für jede Zeile . Dieses Feld ist ein XPath Ausdruck zum Auswählen der Elemente, deren untergeordnete Elemente in Zeilen in der Importsatztabelle konvertiert werden. Jedes ausgewählte Element bewirkt, dass in der Importsatztabelle eine Zeile erstellt wird. Die untergeordneten Elemente des ausgewählten Elements werden in Spalten in der Zeile konvertiert. Um beispielsweise die Asset-Informationen aus der folgenden XML-Beispieldatei zu importieren, muss der XPath-Ausdruck als angegeben werden /Export/Asset . Dieser Ausdruck stimmt mit den drei überein <asset> Elemente in der Datei, also werden drei Zeilen erstellt. Obwohl Sie auch angeben können //Asset , Dieser Ausdruck ist für große Dateien viel weniger effizient. Verwenden Sie das Formular „absoluter Standortpfad“ für XPath-Ausdrücke, wenn Sie das XML-Ladeprogramm verwenden. Mit anderen Worten: Vermeiden Sie Ausdrücke, die enthalten // Sofern nicht unbedingt erforderlich.
Achten Sie darauf, dass Sie keinen unzureichend restriktiven XPath-Ausdruck mit einer großen XML-Datei angeben. Zum Beispiel der Ausdruck /Export Wäre für die folgende Beispieldatei falsch, da sie mit dem Dokumentelement (Stamm) übereinstimmt. Im Allgemeinen sollten Sie niemals einen XPath-Ausdruck angeben, der dem Stammelement entspricht, es sei denn, Sie möchten, dass alles im Dokument in einer einzigen Zeile zusammengefasst wird. Die Angabe eines nicht ausreichend restriktiven XPath-Ausdrucks beim Versuch, große XML-Dateien zu laden, kann zu längeren Verarbeitungszeiten und falschen Ausgaben führen. Aus diesem Grund ist es am besten, XML-Datenquellenspezifikationen mit kleinen XML-Dateien zu testen und zu debuggen, die nur einige Zeilen mit Daten enthalten. Sobald die Spezifikation getestet wurde, können Sie sie mit der vollständigen Datei erneut ausführen.
- <userInfo>-Elemente
- Beachten Sie, dass <userInfo> Darin enthaltene Elemente <asset> Enthält untergeordnete Elemente. Diese Art der Verschachtelung erstellt eine Spalte namens Anwenderinfo Das XML für enthält <userInfo> Element. Wenn Erweitern Sie untergeordnete Knoten Ist aktiviert, für werden auch einzelne Spalten erstellt UserInfo/lastName Und UserInfo/firstName . Wenn Erweitern Sie untergeordnete Knoten Ist nicht aktiviert, nur die Anwenderinfo XML-Spalte wird erstellt.
- Daten werden aus einer XML-Datei geladen
- Beim Laden von Daten aus einer XML-Datei ServiceNow Führt ein Beispiel für die ersten 10 Datensätze durch, um zu bestimmen, welche Felder zum Speichern der Daten erforderlich sind. Wenn keiner der ersten 10 Datensätze einen Wert für ein Feld angibt, ServiceNow Fügt dieses Feld nicht der Tabelle hinzu, die die importierten Daten enthält. Stellen Sie sicher, dass mindestens einer der ersten 10 Datensätze einen Wert für alle importierten Felder angibt.Wenn die für eine XML-Datenquelle verwendete XML-Datei kein Feld in den ersten 10 Knoten enthält, wird das Feld ignoriert. Um das Feld zu importieren und sicherzustellen, dass es nicht ignoriert wird, können Sie hinzufügen glide.db.impex.XMLLoader.max.scan_nodesSystemeigenschaft mit einem Wert, der größer oder gleich der Position des Knotens ist, auf dem das Feld zuerst gefunden wurde. Diese Eigenschaft gilt für alle XML-Datenquellen. glide.db.impex.XMLLoader.max.scan_nodesStandardmäßig ist 10 , Sie können jedoch einen Wert von eingeben 1 Bis 2147483647 Um anzugeben, wie viele Knoten gescannt werden sollen, um die für den Import zu verwendenden Werte zu bestimmen. Sie können angeben -1 Zum Scannen aller Knoten in den XML-Dateien.Wichtig:Wenn Sie angeben -1 Oder erhöhen Sie den Wert von glide.db.impex.XMLLoader.max.scan_nodesÜber den Standardwert von hinaus 10 , Die gesamte XML-Importverarbeitung kann zu einer erheblichen Erhöhung der Gesamtladezeit führen.
<?xml version= "1.0" encoding= "utf-8" ?><export><asset><assetTag>AT-01939</assetTag><type>Desktop</type><os>Windows 7 Professional</os><lastlogondate>12-07-2010 12:31:24</lastlogondate><userInfo><lastName>Loo</lastName><firstName>David</firstName></userInfo><isenabled>true</isenabled></asset><asset><assetTag>AT-53480</assetTag><type>Desktop</type><os>Windows 7 Professional</os><lastlogondate>09-07-2010 13:25:53</lastlogondate><userInfo><lastName>Merritt</lastName><firstName>Norris</firstName></userInfo><isenabled>true</isenabled></asset><asset><assetTag>AT-55782</assetTag><type>Desktop</type><os>Unknown</os><lastlogondate>01-01-1900 00:00:00</lastlogondate><userInfo><lastName>Currie</lastName><firstName>Mike</firstName></userInfo><isenabled>true</isenabled></asset></export>CSV-Datenquellendatei
CSV-Dateien werden als Cross-kompatibles Dateiformat für die Übertragung von Dateien über Plattformen hinweg verwendet. Eine CSV-Datei ist eine Textdatei, die ein Raster definiert, in dem Kommas Spalten definieren und Zeilenumbrüche Zeilen definieren. Um einen genauen Abstand für den Import von Zeichenfolgen zu definieren, können Sie Text optional in Anführungszeichen umbrechen.
"user_name","name","email","sys_created_on","active"
"jared.laethem","Jared Laethem","jared.laethem@yourcompany.com","2008-02-24 22:21:32","true"
"jerrod.bennett","Jerrod Bennett","jerrod.bennett@yourcompany.com","2007-08-12 12:12:18","true"
"eric.schroeder","Eric Schroeder","eric.schroeder@yourcompany.com","2007-07-03 11:50:20","true"
"rob.woodbyrne","Rob Woodbyrne","rob.woodbyrne@yourcompany.com","2007-07-03 11:49:57","true"
"admin","System Administrator","admin@yourcompany.com","2007-07-03 11:48:47","true"
"christen.mitchell","Christen Mitchell","christen.mitchell@yourcompany.com","2007-05-16 15:26:42","true"
"rob.phillips","Rob Phillips","rob.phillips@yourcompany.com","2007-01-22 11:25:34","true"
"davin.czukowski","Davin Czukowski","davin.czukowski@yourcompany.com","2006-07-11 14:01:26","true"
"luke.wilson","Luke Wilson","luke.wilson@yourcompany.com","2006-02-07 15:29:48","true"
"bow.ruggeri","Bow Ruggeri","bow.ruggeri@yourcompany.com","2005-07-07 11:39:58","true"
"don.goodliffe","Don Goodliffe","don.goodliffe@yourcompany.com","2005-05-02 12:28:40","true"
"david.loo","David Loo","david.loo@yourcompany.com","2005-02-22 16:00:00","true"
"guest","Guest","guest@yourcompany.com","2004-05-01 17:00:00","true"
"fred.luddy","Fred Luddy","fred.luddy@yourcompany.com","2004-05-01 17:00:00","true"Bei Verwendung von CSV-Dateien können Sie den Codierungszeichensatz mit angeben Eigenschaften Feld im Datenquellenformular. Möglicherweise müssen Sie dies tun Konfigurieren des Formularlayouts Das Datenquellenformular zum Anzeigen dieses Felds. Um beispielsweise die utf-8-Codierung zu verwenden, geben Sie ein Zeichensatz=utf-8 .
Daten in einzelner Spalte
Für die JSON- und XML-Formate können Sie mit dieser Funktion einen vollständigen Datensatz in einer einzelnen Spalte speichern.
Der Spaltenname, der zum Speichern des vollständigen Datensatzes verwendet wird, lautet Daten .
- Array Verwerfen Wird deaktiviert und wird aus dem Formular entfernt.
- Erweitern Sie untergeordnete Knoten Wird ausgewählt und wird aus dem Formular entfernt.
Wenn Sie eine Datenquelle im XML-Format erstellen, um Daten in einer einzelnen Spalte zu speichern, und wählen Sie aus Daten in einer Spalte Kontrollkästchen, Erweitern Sie untergeordnete Knoten Wird ausgewählt und wird aus dem Formular entfernt.
Anwenderdefiniertes Format (nach Skript analysieren)
Wenn Sie eine auswählen Typ Von Datei Und ein Format Von Anwenderdefiniert (nach Skript analysieren) , Ein Javascript-Editor aufgerufen Skript wird analysiert Wird angezeigt. Sie können das Analyseskript verwenden, um anwenderdefiniertes JavaScript zu erstellen, um Eingabezeilen in der Liste der Zuordnungen zu analysieren.
- Die lineParameter ist eine Zeichenfolge, die Zeilendaten aus der Quelldatei enthält.
- Die lineNumberIst die Zeilennummer aus der Quelldatei für diese Zeilendaten.
- Die resultParameter wird verwendet, um das analysierte Ergebnis aus Javascript zurückzugeben.
SetSkip (boolescher Überspringen) void;boolescher wert „getSkip()“;AddRow(Map<String, String>-Zuordnung);List<Map<String,String>> getRows()
Die SetSkip() Und GetSkip() Legen Sie die Kennzeichnung „Überspringen“ fest, und rufen Sie sie ab. Wenn die Kennzeichnung „Überspringen“ auf „wahr“ festgelegt ist, wird das gesamte Analyseergebnis aus Javascript ignoriert.
Die AddRow() Fügt eine Zuordnung des Analysezeilenergebnisses hinzu, das in die Bereitstellungstabelle eingefügt wird.
Die GetRows() Ruft alle Zeilen des aktuellen Analyseergebnisses ab, die in die Bereitstellungstabelle eingefügt werden.
Eine Zeile von Quelldaten kann eine Zeile oder mehrere Zeilen enthalten. Es obliegt dem Skriptautor, zu entscheiden, wie die Zeilendaten verarbeitet werden sollen. Beispiel: Für Zeilendaten Name=john,Computer=Windows;Name=joe,Computer=linux;Name=linda,Computer=Windows Wenn Sie ein Semikolon (;) als Zeilenumbruch verwenden, enthält diese Zeile drei Datenzeilen. Jede Zeile ist eine Zuordnung mit zwei Schlüsseln: Name Und Computer . Die Name Und Computer Werden Sie zu den Spaltennamen für das Bereitstellungstabellenschema. Sie können das folgende Beispiel von Javascript verwenden, um diese Zeilendaten zu analysieren:
(function(line, lineNumber, result) {
var rowArr = line.split(";");
var i;
for(i in rowArr) {
var map = {};
var arr = rowArr[i].split(",");
var x;
for(x in arr) {
var items = arr[x].split("=");
map[items[0]]=items[1];
}
result.addRow(map);
}
})(line, lineNumber, result);Der Skriptautor muss das Ergebnis hinzufügen, damit das Ergebnis in die Bereitstellungstabelle eingefügt wird.