Erste Schritte mit der schnellen Integration von Risk Assess
Erfahren Sie mehr über die schnellen Integrationsimporte von Risk Assess, wie Sie sich authentifizieren, Inhaltstypen und Ausnahmebehandlung und Fehlercodes.
Übersicht
Der schnelle Integrationsimport ermöglicht es CRA-Benutzern, Tabellen direkt über das HTTPS-Protokoll hochzuladen. Dies ermöglicht es Kunden, eingehende Importe auf automatisierte Weise durchzuführen, ohne dass eine Schnittstelle erforderlich ist. Im Folgenden finden Sie verschiedene Codeausschnitte, die Beispiele für die Verwendung einer Vielzahl beliebter Programmiersprachen liefern.
Authentifizierung
Für jede ausgestellte Anforderung für die schnelle Integration von Risk Assess müssen gültige Anmeldeinformationen angegeben werden, um erfolgreich zu sein.
Der angegebene Risk Assess-Benutzer muss Mitglied der Gruppe "QuickIntegration" oder der Gruppe "QuickIntegration-Engagements" sein. Die Gruppe "Schnelle Integration" ermöglicht es einem Konto, auf alle Ressourcen für die schnelle Integration zuzugreifen. Die Gruppe "QuickIntegration-Engagements" beschränkt den Zugriff nur auf die Ressource "Quick Integration Engagements". Wenn diese Gruppen derzeit nicht in Ihrer Risk Assess-Instanz vorhanden sind, wenden Sie sich an Ihren lokalen Risk Assess-Administrator oder Ihren Coupa-Kundendienstmitarbeiter, um sie erstellen zu lassen.
HTTP-Kopfzeile | Beschreibung |
---|---|
Benutzername | Gültiger Risk Assess-Benutzername |
Kennwort | Gültiges Risk Assess-Kennwort |
Inhaltstyp
Die Kopfzeile des Inhaltstyps muss einen der folgenden Typen enthalten. Dies wird verwendet, um das Dateiformat zu identifizieren, das hochgeladen wird.
Wenn Daten als Oktett-Stream gesendet werden, ist der Dateiname im Content-Disposition-Header erforderlich.
Kopfzeile Inhaltstyp | Dateityp |
---|---|
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet | Excel 2007 oder höhere Versionen (xlsx) |
application/vnd.ms-Excel | Excel 2003 oder frühere Versionen (xls) |
Text/CSV | Durch Kommas getrennte Werte (CSV) |
application/octet-stream | Dateiformat bestimmt durch Dateinamenwert in Content-Disposition z. B. Content-Disposition: form-data; name="file"; filename="user_import.xlsx" |
Codebeispiele
Java
package httpPostExample;import java.io.File;import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.mime.HttpMultipartMode;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.mime.content.FileBody;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.protocol.BasicHttpContext;
import org.apache.http.protocol.HttpContext;
import org.apache.http.util.EntityUtils;public class uploadFile
{
public static void main(String[] args)
{
try
{
String url = "https://rportal.hiperos.com/QuickIntegration/Suppliers";
String filePath = "c:\\hiperos\\outbox\\Suppliers_import.xlsx"; HttpClient httpClient = HttpClientBuilder.create().build();
HttpContext httpContext = new BasicHttpContext(); HttpPost httpPost = new HttpPost(url);
httpPost.setHeader("username", "Your_3PM_Username_Here");
httpPost.setHeader("password", "Your_3PM_Password_Here"); httpPost.setHeader("Connection", "close"); MultipartEntityBuilder builder = MultipartEntityBuilder.create();
builder.setMode(HttpMultipartMode.BROWSER_COMPATIBLE); final File file = new File(filePath);
FileBody fb = new FileBody(file, "text/csv"); builder.addPart("file", fb); final HttpEntity entity = builder.build();
httpPost.setEntity(entity); HttpResponse postResponse = httpClient.execute(httpPost, httpContext); HttpEntity responseEntity = postResponse.getEntity();
System.out.println(EntityUtils.toString(responseEntity));
}
catch(Exception ex)
{
ex.printStackTrace();
}
}
}
C#
using System;
using System.Net;namespace QuickIntegration_Sample
{
class Program
{
static void Main()
{
const string uriString = "https://rportal.hiperos.com/QuickIntegration/Suppliers";
const string fileName = @"c:\\hiperos\\outbox\\Suppliers_import.xlsx"; // Create a new WebClient instance.
WebClient client = new WebClient(); // Add authentication headers to request.
client.Headers.Add("username", "Your_3PM_Username_Here");
client.Headers.Add("password", "Your_3PM_Password_Here"); // Upload the file to the URI.
// The 'UploadFile(uriString,fileName)' method implicitly uses HTTP POST method.
byte[] responseArray = client.UploadFile(uriString, fileName); string response = System.Text.Encoding.ASCII.GetString(responseArray); // Decode and display the response.
Console.WriteLine("\nResponse Received. The contents of the file uploaded are:\n{0}", response);
}
}
}
Ausnahmebehandlung und Fehlercodes
Die folgenden HTTP-Antwortstatuscodes werden von der schnellen Integration verwendet, um dem Aufrufer den Importstatus zurückzugeben.
Statuscode | Ergebnis | Beschreibung |
---|---|---|
201 | Erstellt | Neue Objekte erfolgreich erstellt. |
202 | Akzeptiert | Daten wurden für den Import in die Warteschlange gestellt (vom System generierte E-Mail-Bestätigung folgt). |
204 | Kein Inhalt | Es wurden keine neuen oder aktualisierten Daten zum Import gefunden oder die Datei hatte nicht das richtige Format. |
400 | Fehlerhafte Anforderung | Es wurden problematische Zeilen und/oder Spalten gefunden. Überprüfung ergab Validierungsmeldung als Antwort. |
401 | Unberechtigt | Benutzername und Kennwort http-Kopfzeilen wurden in der Anfrage nicht gefunden. |
403 | Verboten | Anmeldung fehlgeschlagen, wurde nicht gefunden oder nicht autorisiert. |
500 | Server-Fehler | Fehler beim Speichern der Importdaten in der Datenbank |
Parts or all of this page might have been machine-translated. We apologize for any inaccuracies.