El punto final (endpoint) para modificar un registro es el mismo para leer un registro existente. Nótese que al crear un registro, el punto final apunta a una hoja Ragic, pero cuando editas un registro, tu punto final necesitará un ID de registro extra para apuntar al registro exacto.
https://www.ragic.com/<account>/<tab folder>/<sheet index>/<record id>?api
Todo lo que necesitas proveer son los IDs de los campos que deseas modificar. Si el campo es de tipo Fecha, el valor debe estar en el formato yyyy/MM/dd o yyyy/MM/dd HH:mm:ss si hay períodos de tiempo.
curl -F "800003=Dwight Schrute" \ -F "800007=Partner" \ -F "api=" \ -H "Authorization:Basic TU_CLAVE_API_VA_AQUÍ" \ https://www.ragic.com/demo/sales/1/3
Para subtablas, es poco más complicado ya que Ragic necesita saber cuál fila estás editando, asique debes encontrar el ID de la fila que estás editando. Esta información puedes obtenerla desde una llamada API.
Como hemos mencionado en un capítulo anterior, el formato devuelto para un registro con subtablas se ve así:
"14": { "Account Name": "Ratshotel", "Account Owner": "Dwight Schrute", "Phone": "1-267-922-5529", ... "_subtable_800014": { "29": { "Contact Name": "Arden Jacobs", "Title": "Specialist", "E-mail": "Arden@ratshotel.com", }, "30": { "Contact Name": "Kermit Moore", "Title": "Manager", "E-mail": "Kermit@ratshotel.com", } } }
El formato JSON equivalente es el siguiente:
{ "800003": "Dwight Schrute", "800007": "Partner" }
Para subtablas, es un poco más complejo, ya que Ragic necesitará cuál fila estás editando. Asique debes encontrar el ID de fila de la fila que estás editando. Esta información puedes encontrarla en una llamada API.
Como se mencionó en un capítulo anterior, el formato devuelto para un registro con subtablas se ve así:
"14": { "Account Name": "Ratshotel", "Account Owner": "Dwight Schrute", "Phone": "1-267-922-5529", ... "_subtable_800014": { "29": { "Contact Name": "Arden Jacobs", "Title": "Specialist", "E-mail": "Arden@ratshotel.com", }, "30": { "Contact Name": "Kermit Moore", "Title": "Manager", "E-mail": "Kermit@ratshotel.com", } } }
En la subtabla, 29 es el ID de fila para el contacto Arden Jacobs, y 30 es el ID de fila para el contacto Kermit Moore. Con este ID de fila, puedes modificar datos de la subtabla, así como creas registro en subtablas.
Usa el ID de fila como identificador después del ID de campo. Sólo debes incluir los campos que deseas modificar:
1000015_29=Senior Specialist 1000016_29=arden2@ratshotel.com 1000015_30=Senior Manager
La solicitud completa se vería así:
curl -F "800003=Dwight Schrute" \ -F "800007=Partner" \ -F "1000015_29=Senior Specialist" \ -F "1000016_29=arden2@ratshotel.com" \ -F "1000015_30=Senior Manager" \ -F "api=" \ -H "Authorization:Basic TU_CLAVE_API_VA_AQUÍ" \ https://www.ragic.com/demo/sales/1/3
El formato JSON equivalente es el siguiente:
{ "800003": "Dwight Schrute", "800007": "Partner" , "_subtable_800014": { "29" :{ "1000015": "Senior Specialist", "1000016": "arden2@ratshotel.com" }, "30" :{ "1000015": "Senior Manager" } } }
Si deseas eliminar una fila de subtabla, puedes crear una solicitud así:
DELSUB_<subtable key>=<subtable row id>
El formato JSON equivalente es el siguiente:
_DELSUB_<subtable key>=[<subtable row id>,<subtable row id>,...,<subtable row id>];
Por ejemplo, si quieres eliminar el contacto Arden Jacobs, la solicitud completa se vería así:
curl -F "DELSUB_800014=29" \ -F "api=" \ -H "Authorization:Basic TU_CLAVE_API_VA_AQUÍ" \ https://www.ragic.com/demo/sales/1/3
El formato JSON equivalente es el siguiente:
{ "_DELSUB_800014": [26] }
Usar el formato JSON para eliminar filas te permite especificar filas de una forma simple,
{ "_DELSUB_subtable key": [<subtable row id>,..., <subtable row id>] }