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.

Hinweis

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.

Vergleichbare Artikel


Die Coupa Core-API

Unsere RESTful-API bietet robusten Zugriff zum Lesen, Bearbeiten oder Integrieren Ihrer Daten mit der Coupa-Plattform.

Erste Schritte mit der API

Allgemeine Informationen zur Verwendung der Coupa-API und wann Sie CSV verwenden sollten.

Übergang zu OAuth 2.0 und OIDC

Coupa veraltet ältere API-Schlüssel und erfordert die Verwendung von OAuth 2.0 / OIDC. Ab R34 werden keine neuen API-Schlüssel ausgegeben und API-Schlüssel werden mit R35 nicht mehr unterstützt.

Bauen Sie auf der Coupa-Plattform auf

Unsere API-basierte offene Integrationsplattform ermöglicht Technologiepartnern und unabhängigen Softwareanbietern (ISVs) die Integration ihrer Produkte in Coupa