Die eUICC-APIs Fehlercodes angeben, um Apps und Nutzern bei der Behebung von Problemen eSIM-Profile herunterladen, aktivieren, deaktivieren und löschen
Fehler verarbeiten
Wenn beim Aufrufen der eUICC API ein Fehler auftritt, ist ein ausstehender Intent-Callback
bereitgestellt und
EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE
wird als Schlüssel zum Abrufen des detaillierten Fehlercodes verwendet. Ab
sind die folgenden vier Schlüssel und Werte
im resultierenden Intent enthalten:
EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE
: Liefert Informationen zum Fehler. Zum Beispiel kann das Herunterladen oder Löschen eines eSIM-Profils Dieses Feld ist nie leer.EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE
: Informationen zum Grund des Fehlers. Zum Beispiel hat die Anfrage oder das Gerät ist vom Mobilfunkanbieter gesperrt. Dieses Feld wird in der folgenden Fällen:- Der Vorgangscode lautet
OPERATION_SMDX_SUBJECT_REASON_CODE
- Bei dem Fehler handelt es sich um einen untergeordneten Fehler wie
IOException
oderInterruptedException
.
- Der Vorgangscode lautet
EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE
: Wird mitEXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE
verwendet, die zusammen geben Sie den SubjectCode[5.2.6.1] und den ReasonCode[5.2.6.2] von GSMA (SGP.22) an. Version 2.2). Dieses Feld wird nur ausgefüllt, wenn der VorgangscodeOPERATION_SMDX_SUBJECT_REASON_CODE
EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE
: Wird mitEXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE
verwendet, die zusammen geben Sie den SubjectCode[5.2.6.1] und den ReasonCode[5.2.6.2] von GSMA (SGP.22) an. Version 2.2). Dieses Feld wird nur ausgefüllt, wenn der VorgangscodeOPERATION_SMDX_SUBJECT_REASON_CODE
Mit diesen vier Werten kann der Aufrufer der eUICC API bestimmte Fehler verarbeiten individuell anpassen. Im Folgenden finden Sie ein Beispiel für den Umgang mit diesen Fehlern.
int operationCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE)
int errorCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE)
String smdxSubjectCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE)
String smdxReasonCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE)
if (operationCode == OPERATION_DOWNLOAD && errorCode == ERROR_CARRIER_LOCKED) {
// handle specific error i.e. tries to download but the device is carrier locked
} else if (operationCode == OPERATION_SMDX) {
// handle all SM-DP+/SM-DS errors
} else if (errorCode == ERROR_TIME_OUT) {
// handle all types of time out issues, regardless of operation.
} else if ("8.1".equals(smdxSubjectCode) && "3.1".equals(smdxReasonCode)) {
// handle specific subject code and reason code: 8.1 and 4.1 means insufficient memory.
}
Unterstützte Kombinationen von Operationen und Fehlercodes
In der folgenden Tabelle wird die unterstützte Kombination aus Operation und Fehlercodes, die vom lokalen Profilassistenten (LPA) zurückgegeben werden
Vorgangs- und Fehlercode-Kombinationen | |||
---|---|---|---|
<ph type="x-smartling-placeholder"></ph> Vorgangscode | <ph type="x-smartling-placeholder"></ph> Fehlercode | Beschreibung | |
OPERATION_SYSTEM |
Nicht zutreffend | Es ist ein interner Fehler aufgetreten. Beispielsweise wurde der Thread unterbrochen oder
IOException Fehler aufgetreten. |
|
OPERATION_SIM_SLOT |
Nicht zutreffend | Beim Ausführen eines SIM-Steckplatzvorgangs ist ein interner Fehler aufgetreten. | |
ERROR_TIME_OUT |
Zeitüberschreitung beim Ausführen eines SIM-Steckplatzvorgangs. | ||
ERROR_EUICC_MISSING |
Auf dem Gerät ist keine eUICC verfügbar oder aktiv. | ||
OPERATION_EUICC_CARD |
Nicht zutreffend | Beim Ausführen eines eUICC-Vorgangs ist ein interner Fehler aufgetreten. | |
ERROR_UNSUPPORTED_VERSION |
eUICC-Version (Chip) und EuiccCard-Version (Software) sind nicht kompatibel sind. | ||
ERROR_EUICC_MISSING |
Im Gerät ist keine SIM-Karte vorhanden. Beispielsweise kann der LPA in der SIM-Karte. | ||
OPERATION_SMDX |
Nicht zutreffend | Beim Ausführen eines SM-DP+/SM-DS-Vorgangs ist ein interner Fehler aufgetreten. | |
ERROR_ADDRESS_MISSING |
Keine SM-DP+ Adresse zum Herunterladen des Profils. | ||
ERROR_INVALID_CONFIRMATION_CODE |
Beim Parsen des Aktivierungscodes ist ein Fehler aufgetreten (ungültiges Format). | ||
ERROR_CERTIFICATE_ERROR |
Schlüsselspeicher- oder Zertifikatsfehler bei Verwendung in TLS-Verbindung für Überprüfung. | ||
ERROR_NO_PROFILES_AVAILABLE |
Keine Profile von SM-DP+ verfügbar. | ||
ERROR_CONNECTION_ERROR |
Verbindung zum Server kann nicht hergestellt werden. | ||
ERROR_INVALID_RESPONSE |
Ungültige Antwort vom SM-DP+/SM-DS-Server. | ||
OPERATION_SWITCH |
Nicht zutreffend | Beim Wechsel ist ein interner Fehler aufgetreten. | |
ERROR_CARRIER_LOCKED |
Dürfen das Profil nicht wechseln, weil das Gerät vom Mobilfunkanbieter gesperrt ist (SIM) gesperrt). | ||
OPERATION_DOWNLOAD |
Nicht zutreffend | Beim Ausführen eines Downloadvorgangs ist ein interner Fehler aufgetreten. | |
ERROR_DISALLOWED_BY_PPR |
Die Tabelle zur Regelautorisierung in der eUICC ist null oder der Download ist aufgrund der Regel der Profilrichtlinie nicht zugelassen. | ||
ERROR_INVALID_ACTIVATION_CODE |
Beim Parsen des Aktivierungscodes ist ein Fehler aufgetreten (ungültiges Format) oder ohne Aktivierungscode herunterladen. | ||
ERROR_CARRIER_LOCKED |
Download nicht erlaubt, da das Gerät vom Mobilfunkanbieter gesperrt ist (SIM-Karte) gesperrt). | ||
ERROR_INCOMPATIBLE_CARRIER |
Der Netzbetreiber befindet sich auf der Sperrliste und der LPA kann kein Profil von SM-DP+/SM-DS. | ||
ERROR_OPERATION_BUSY |
Das Profil wird heruntergeladen und keine andere Aktion, die die SIM auslösen könnte Statusänderungen sind zulässig. | ||
OPERATION_METADATA |
Nicht zutreffend | Beim Metadatenvorgang ist ein interner Fehler aufgetreten. | |
ERROR_INVALID_ACTIVATION_CODE |
Die Abo-Metadaten sind leer oder der Aktivierungscode im Abometadaten sind leer oder ungültig. | ||
ERROR_INCOMPATIBLE_CARRIER |
Der Netzbetreiber steht auf der Sperrliste und die LPA kann die von SM-DP+/SM-DS. | ||
OPERATION_EUICC_GSMA |
Nicht zutreffend | Beim Ausführen eines eUICC GSMA-Vorgangs ist ein interner Fehler aufgetreten. | |
ERROR_INSTALL_PROFILE |
Bei der Installation des Profils ist ein Fehler mit eUICC aufgetreten. Zum Beispiel hat das Profil existiert bereits oder die ICCID stimmt nicht überein. | ||
ERROR_EUICC_INSUFFICIENT_MEMORY |
Bei der Installation des Profils ist ein Fehler mit eUICC aufgetreten. Nicht genügend Arbeitsspeicher auf dem eUICC. | ||
ERROR_DISALLOWED_BY_PPR |
Bei der Installation des Profils ist ein Fehler mit eUICC aufgetreten. Nicht zulässig gemäß Regel der Profilrichtlinie. | ||
OPERATION_APDU |
Nicht zutreffend | Beim Ausführen eines APDU-Vorgangs ist ein interner Fehler aufgetreten. | |
OPERATION_HTTP |
1-999 |
Fehlercode ist ein HTTP-Fehlerwert. | |
<ph type="x-smartling-placeholder"></ph> Vorgangscode | <ph type="x-smartling-placeholder"></ph> Themencode | <ph type="x-smartling-placeholder"></ph> Ursachencode | Beschreibung |
OPERATION_SMDX_SUBJECT_REASON_CODE |
String enthält 3 Ziffern, die durch einen Punkt getrennt sind, ohne vorangestellte Nullen. Für
Beispiel: 8.1.1 . |
String enthält 3 Ziffern, die durch einen Punkt getrennt sind, ohne vorangestellte Nullen. Für
Beispiel: 3.8 . |
SubjectCode[5.2.6.1] und ReasonCode[5.2.6.2] von GSMA (SGP.22 v2.2). Für
der SubjectCode 8.1.1 und der ReasonCode
„3.8 “ steht für die EID.
an ein anderes Gerät gebunden ist. |